Outil Entrée Marketo
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.
Important
Cet outil n'est pas automatiquement installé avec Designer. Pour utiliser cet outil, téléchargez-le depuis la Communauté Alteryx .
Configuration de l'outil
Identifiants Marketo
URL : instance Marketo REST à partir de laquelle récupérer des enregistrements. Ces informations figurent dans Marketo (Administration > Intégration > Services Web > API REST).
ID client : ID client de l'utilisateur Rôle API. Ces informations figurent dans Marketo (Administration > Intégration > LaunchPoint).
Secret de client : secret de client de l'utilisateur Rôle API. Ces informations figurent dans Marketo (Administration > Intégration > LaunchPoint).
Des informations supplémentaires sur la configuration du service Web et des rôles utilisateur pour accéder à l’API Marketo REST sont disponibles sur le site de documentation sur Marketo REST.
Options
Il est possible de récupérer deux types d’enregistrements Marketo :
Enregistrements de prospect : il s'agit d'enregistrements de prospect (un enregistrement pour chaque prospect).
Enregistrements d'activité de prospect : ces enregistrements assurent le suivi des activités pour 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 | N/A | Facultatif | N/A |
Enregistrements de prospect | Par changement de prospect | Facultatif | N/A | N/A | Obligatoire |
Activité de prospect | Par type d’activité | N/A | Obligatoire | N/A | Obligatoire |
Activité de prospect | Par changement de prospect | N/A | N/A | N/A | Obligatoire |
Paramètres
Listes : toutes les listes statiques pour l'instance Marketo spécifiée dans la configuration figurent ici (les listes intelligentes ne sont actuellement pas disponibles via l'API). Une seule sélection de liste est autorisée par requête.
Types d'activités : tous les types d'activités disponibles dans Marketo figurent ici (10 sélections de type d'activité par requête maximum).
Champs de sortie : tous les champs disponibles dans l'instance Marketo sont répertoriés. Si aucune sélection n'est effectuée, la liste par défaut des champs sera renvoyée : E-mail, ID de prospect, Prénom, Nom, Mis à jour le, Créé le.
Date/Heure de début : indique le point de début de la base de données pour la récupération d'enregistrements.
Considérations relatives aux données
Les messages d’erreur comme les échecs d’authentification s’affichent 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 constitué de l’heure locale et d’un décalage ajouté qui peut être positif ou négatif. Par exemple, une valeur DateHeure dans Marketo peut se présenter comme suit, avec la date insérée dans Marketo définie sur un fuseau horaire antérieur de 6 heures à l'heure UTC (Heure des Rocheuses) :
2012-02-28T14:00:00-06:00
Lecture des dates de Marketo
Pour simplifier l’utilisation des valeurs DateTime pour les artisans Alteryx, Alteryx convertit la valeur DateTime lue depuis Marketo en valeur DateTime locale de la machine. Les artisans peuvent ainsi utiliser les valeurs DateTime dans leur fuseau horaire. Par exemple, la valeur DateTime ci-dessus se présenterait comme suit dans un workflow ou une application Alteryx, en supposant que vous vous trouvez également dans un fuseau situé 6 heures avant l’heure UTC :
2012-02-28 14:00:00
Ou, si vous êtes situé à seulement 4 heures avant UTC, cette valeur s’afficherait comme suit :
2012-02-28 16:00:00
Écriture des dates dans Marketo
Lorsque des valeurs DateTime sont réécrites dans Marketo à l’aide d’une opération d’insertion ou de mise à jour, Alteryx reconvertit ces valeurs dans le format attendu par Marketo. Pour ce faire, il calcule le décalage UTC de la machine locale, puis l’ajoute à la fin de la valeur DateTime. Alteryx insère la lettre « T » entre les parties de date et d'heure de la valeur DateHeure, comme illustré dans les exemples ci-dessus.
Selon les exemples ci-dessus, si une valeur DateTime provenant d’un fuseau horaire avec un décalage de -6:00 était écrite comme suit :
2012-02-28T14:00:00-06:00
Puis si cette valeur était réécrite dans Marketo (sans modification), depuis un ordinateur présentant un décalage UTC de -4:00 heures, elle se présenterait comme suit :
2012-02-28T16:00:00-04:00
Les deux heures sont identiques et correspondent au même moment dans le temps.