Outil Entrée Marketo
L’outil Entrée Marketo lit les enregistrements Marketo en fonction de paramètres spécifiques. Utilisez l’outil Entrée Marketo si vous ne possédez pas de données pour commencer ou pour échantillonner des données provenant des votre instance Marketo. Si vous avez des données à joindre à des données supplémentaires de Marketo, il est recommandé d’utiliser l’outil Ajout de Marketo.
Outil Gallery
Cet outil n'est pas installé automatiquement avec Designer. Pour utiliser cet outil, téléchargez-le à partir de la Gallery Alteryx Analytics.
Configurer l’outil
Identifiants Marketo
URL: instance de repos Marketo pour récupérer les enregistrements à partir de. Ces informations figurent dans Marketo (Administration > Intégration > Services Web > API REST).
ID client: ID client pour l'utilisateur de rôle API. Ces informations figurent dans Marketo (Administration > Intégration > LaunchPoint).
Secret client: client secret pour l'utilisateur de rôle API. Ces informations figurent dans Marketo (Administration > Intégration > LaunchPoint).
Vous trouverez plus d'informations sur la configuration du service Web et des rôles d'utilisateur pour accéder à l'API de repos Marketo sur le site de documentation sur le reste du marché .
Options
Deux types des enregistrements Marketo peuvent être récupérés:
- LeadRecords: ce sont des dossiers de plomb et il y aura un enregistrement pour chaque piste.
- Enregistrements d'activités Lead: ces enregistrements suivent les activités de chaque Prospect. Il existe potentiellement un nombre important d’enregistrements d’activité de prospect pour chaque enregistrement de prospect.
Les options disponibles varient selon le type d’enregistrement sélectionné, de même que les paramètres à configurer (certains sont facultatifs, d’autres obligatoires). Le tableau ci-dessous indique les paramètres obligatoires en fonction de la configuration sélectionnée.
| Type d'enregistrement | Type d’option | Liste | Types d’activités (1-10) | Champs de sortie | Date/Heure de début |
|---|---|---|---|---|---|
| Enregistrements de prospect | Par type d’activité | Facultatif | Obligatoire | Facultatif | Obligatoire |
| Enregistrements de prospect | Par ID de liste | Obligatoire | S/O | Facultatif | S/O |
| Enregistrements de prospect | Par changement de prospect | Facultatif | S/O | S/O | Obligatoire |
| Activité de prospect | Par type d’activité | S/O | Obligatoire | S/O | Obligatoire |
| Activité de prospect | Par changement de prospect | S/O | S/O | S/O | Obligatoire |
Paramètres
Listes: toutes les listes statiques pour l'instance Marketo spécifiée dans la configuration sont répertoriées ici (les listes intelligentes ne sont pas actuellement disponibles via l'API)-seulement 1 sélection de liste est autorisée par demande.
Typesd'activité: tous les types d'activité disponibles dans Marketo sont répertoriés ici, il y a un maximum de 10 sélections de type d'activité par demande.
Champsde sortie: tous les champs disponibles disponibles dans l'instance Marketo seront répertoriés. Si aucune sélection n'est effectuée, la liste des champs par défaut sera retournée: email, ID de prospect, prénom, nom, mise à jour à, créé à.
Date/heure de début: spécifie le point de départ dans la base de données pour commencer la récupération des enregistrements.
Considérations relatives aux données
Messages d'erreur tels que les échecs d'authentification, etc. s'affiche dans la fenêtre de configuration. Les messages d’erreur comme les sélections de configuration manquantes s’affichent sur l’outil dans le workflow.
L’outil envoie les enregistrements par lot de 300 unités maximum, chaque lot correspondant à un appel API distinct en fonction de la limite quotidienne fixée par Marketo.
L’API Marketo REST limite les comptes à 10 000 demandes par jour. Les demandes destinées à l’API REST ne sont pas prises en compte dans la limite quotidienne de l’API SOAP.
Pour éviter toute erreur, veillez à préserver les structures des champs Marketo dans Alteryx avant la réécriture dans Marketo. Le connecteur Marketo convertit les données dans les types de données appropriés avant la sortie vers Marketo tant que les noms des champs sont valides. Un nom de champ introuvable dans Marketo entraîne l’échec de la sortie.
Champs DateTime
Dans Marketo, toutes les dates sont stockées en fonction d’un décalage UTC. Ce format est composé de l'heure locale avec un décalage ajouté qui peut être positif ou négatif. Par exemple, une valeur DateTime dans Marketo peut ressembler à ceci, avec la date insérée dans Marketo est à partir d'un fuseau horaire qui est de 6 heures plus tôt que l'heure UTC (heure avancée des Rocheuses):
Lecture des données de Marketo
Pour faciliter la tâche des artisans Alteryx- utiliser ces valeurs DateTime, Alteryx va convertir la valeur DateTime lecture de Marketo vers une valeur DateTime locale de machine. Cela permet aux artisans pour utiliser les valeurs DateTime dans leurs heures locales. Par exemple, le la valeur DateTime ci-dessus ressemblerait à ceci dans un workflow ou une application Alteryx, en supposant que vous êtes également 6 heures plus tôt que l'heure UTC:
Ou, si vous étiez seulement 4 heures plus tôt que UTC, il serait retourné à vous comme ceci:
Date d'écriture à Marketo
Lorsque les valeurs DateTime sont écrites de nouveau dans Marketo en utilisant soit une opération INSERT ou Update, Alteryx va convertir la (les) valeur (s) de retour au format que Marketo attend. Ceci est fait par calcul de l'offset UTC de l'ordinateur local et ajout de celui-ci à la fin de la valeur DateTime. Alteryx va mettre un't'entre la date et l'heure portions de la valeur DateTime comme indiqué dans les exemples ci-dessus.
En utilisant les exemples ci-dessus, si une valeur DateTime a été écrit à partir d'un fuseau horaire avec un décalage de-6:00, comme ceci:
Et puis plus tard écrit de nouveau à Marketo (non modifié), à partir d'un ordinateur avec un décalage UTC de-4:00 heures, il serait écrit de retour dans Marketo comme ceci:
Les deux fois sont identiques et représentent les même moment dans le temps.