Outil Sortie Marketo
L'outil de sortie Marketo fait un appel au point de terminaison de Marketo API de repos: créer/mettre à jour les prospects. Les données sont transmises à Marketo en fonction de l’action sélectionnée dans la configuration.
Outil Gallery
Cet outil n'est pas installé automatiquement avec Designer. Pour utiliser cet outil, téléchargez-le à partir de la Gallery Alteryx Analytics.
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 clé: 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 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 clé, créez un prospect si le prospect n'existe pas, mettez à jour le prospect s'il existe.
- Créer un doublon: créez un autre Prospect même s'il existe déjà.
- Mise à jour uniquement: mettre à jour le prospect si elle existe déjà, ne rien faire si elle ne fonctionne pas.
- Créer uniquement: créer un nouveau prospect si elle n'existe pas, si elle existe, ignorez-la.
Nom de la partition: si l'instance Marketo en cours d'accès a des partitions configurées, elles seront 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.
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.