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. L'utilisation de l'outil Append est très utile dans les situations où vous avez une liste d'adresses e-mail ou d'autres données avec lesquelles vous travaillez déjà, et que vous souhaitez joindre ces données avec des informations supplémentaires de Marketo, ou voir si elles existent déjà dans votre instance Marketo.
Configuration des outils
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
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 que vous sélectionnez sont également contenus dans le flux de données entrants, le champ de sortie provenant de Marketo est renommé avec un 2 à la fin.
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 des enregistrements par lots de 300 enregistrements ou moins, chaque lot compte comme un appel API distinct vers 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 d'heure de date dans Marketo pourrait ressembler à ceci, avec la date insérée dans Marketo est d'un fuseau horaire qui est 6 heures plus tôt que l'heure UTC (heure avancée de montagne):
2012-02-28T14:00:00-06:00
Lecture des données 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 :
28.02.12 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
Date d'écriture à 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 mettra un «T» entre la date et l'heure des parties de la valeur de date time comme indiqué 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.