Outil Sortie Marketo
Outil Sortie Marketo
Utilisez l'outil Sortie Marketo pour appeler le point de terminaison d'API Marketo REST : Créer/Mettre à jour des prospects. Les données sont transmises à Marketo en fonction de l’action sélectionnée dans la configuration.
Important
Cet outil n’est pas automatiquement installé avec Alteryx 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
Champs de clé : 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 en double éventuels. Si aucun champ n'est spécifié, l'e-mail est utilisé par défaut.
Si le champ « id » est inclus dans vos enregistrements, vous devez sélectionner « id » comme champ de clé.
Sélectionnez une Action de sortie .
Créer ou mettre à jour (par défaut) : en fonction du champ de clé, créer un prospect si aucun prospect n'existe ou mettre à jour le prospect s'il existe.
Créer un doublon : créer un autre prospect même s'il existe déjà.
Mettre à jour uniquement : mettre à jour le prospect s'il existe déjà ; sinon, ne rien faire.
Créer uniquement : créer un prospect s'il n'existe pas déjà ; sinon, l'ignorer.
Nom de la partition : si des partitions sont configurées pour l'instance Marketo, elles sont répertoriées dans la liste déroulante. Cette sélection de champs est nécessaire si des partitions de prospect sont configurées pour l’instance d’écriture. Si aucune partition n'est disponible, la valeur « Par défaut » est utilisée.
Considérations relatives aux données
Un statut récapitulatif des enregistrements soumis est repris sous la forme d'un message dans la fenêtre de résultats.
En fonction des enregistrements soumis, 3 enregistrements ont été ignorés, 2 enregistrements ont été créés.
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. Consultez la documentation de l'API Marketo REST pour obtenir des informations sur les limites quotidiennes. Les requêtes vers l'API REST ne sont pas prises en compte dans les limites quotidiennes 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 DateHeure
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 DateHeure pour les artisans Alteryx, Alteryx convertit la valeur DateHeure lue depuis Marketo en valeur DateHeure 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 DateHeure 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.