Outil Ajout de Marketo
Outil Ajout de Marketo
L’outil Ajout de Marketo utilise un flux de données entrant que vous spécifiez pour récupérer les enregistrements correspondants de votre instance Marketo. Cet outil est tout particulièrement utile dans les cas où vous disposez d'une liste d'adresses e-mail ou d'autres données en cours d'utilisation, et que vous souhaitez joindre des informations supplémentaires de Marketo à ces données ou déterminer si elles existent déjà dans votre instance Marketo.
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
Cette liste déroulante affiche la liste des champs utilisés comme entrées pour l’outil. Marketo utilise ce champ pour rechercher les enregistrements de prospect ayant cette valeur de champ dans l’instance Marketo.
Type des enregistrements pour le champ entrant (e-mail, ID SFDC, etc.).
Champs à récupérer depuis la base de données Marketo. Ces champs et les champs transmis dans l’outil sont renvoyés dans le flux de données de sortie.
Si les champs de sortie sélectionnés sont également contenus dans le flux de données entrant, le champ de sortie provenant de Marketo est renommé avec le chiffre « 2 » ajouté à son extrémité.
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.