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.
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
Champ entrant: ce menu déroulant affiche la liste des champs que vous avez utilisés comme entrée pour l'outil. Marketo utilise ce champ pour rechercher les enregistrements de prospect ayant cette valeur de champ dans l’instance Marketo.
Type de champ entrant: quel type d'enregistrements le champ entrant est (email, SFDC ID, etc.)
Champs de sortie: champs que vous souhaitez récupérer dans 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 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.