Intégrer Marketo à Apollo

Article author
Apollo Team
Mise à jour

Vue d’ensemble

Si vous utilisez Apollo pour les données mais Marketo pour l’engagement, vous pouvez enrichir vos contacts existants dans Marketo avec des informations à jour provenant d’Apollo.

Les avantages de l’enrichissement instantané incluent :

  • Précision : assurez-vous que les données que vous collectez via les formulaires de capture de Lead dans Marketo sont exactes et à jour.
  • Workflow simplifié : supprimez les étapes inutiles lorsque vous travaillez entre Apollo et Marketo.
  • Précision du ciblage : garantissez que les leads qui correspondent le mieux à votre profil client idéal incluent tous les points de données dont vous avez besoin pour exécuter efficacement votre stratégie d’engagement.
  • Remplissage instantané des données : les données que vous enrichissez d’Apollo vers Marketo sont instantanément disponibles.
 
Limite de débit et coût de l’enrichissement

Apollo enrichit vos enregistrements avec une limite de 100 enregistrements par minute et 300 enregistrements par heure. Chaque enrichissement réussi coûte 0,01 crédits.

Consultez les sections suivantes pour connecter l’intégration et configurer le mapping des champs d’enrichissement afin d’enrichir vos contacts Marketo existants avec Apollo.

Retour en haut

Connecter l’intégration

Pour connecter l’intégration, commencez par générer une clé API Apollo, puis créer un webhook dans Marketo.

 
Passez cette étape

Si vous avez déjà votre clé API Apollo, vous pouvez passer cette étape.

Générer une clé API

Pour générer une clé API dans Apollo :

  1. Ouvrez Apollo et cliquez sur Paramètres > Intégrations.
  2. Cliquez sur Connecter à côté d’API.

Connect API

  1. Cliquez sur Demander une clé API.
  2. Apollo génère une clé API. Copiez votre clé API (CTRL + C sur PC ou CMD + C sur Mac). Pensez à coller la clé API dans un emplacement sécurisé pour l'utiliser lors d'une étape ultérieure.
 
Sécurité des clés API

Conservez votre clé API dans un endroit sûr. Toute personne ayant accès à la clé peut effectuer des actions dans votre compte Apollo.

Ensuite, créez un webhook dans Marketo.

Retour en haut

Créer un webhook dans Marketo

Pour créer un webhook dans Marketo :

    1. Connectez-vous à Marketo et cliquez sur Admin > Webhooks.
    2. Cliquez sur Nouveau webhook.
    3. Donnez un nom à votre webhook.
    4. Copiez et collez le lien suivant dans le champ URL, en remplaçant YOUR_API_KEY par votre véritable clé API Apollo :
https://api.apollo.io/v1/people/match?api_key=YOUR_API_KEY&first_name={{lead.First Name:default=}}&last_name={{lead.Last ame:default=}}&email={{lead.Email Address:default=}}&website_url={{company.Website:default=}}&organization_name={{company.Company Name:default=}}
 
Rappel concernant l'URL

N'oubliez pas de remplacer YOUR_API_KEY dans l'URL par votre véritable clé API Apollo.

  1. Pour le type de requête, sélectionnez POST.
  2. Pour le type de réponse, sélectionnez JSON.

Response Type_JSON

  1. Une fois terminé, cliquez sur Enregistrer.

Ensuite, configurez le mapping des champs d'enrichissement.

 
Webhook créé ?

Consultez Créer un webhook sur le Support Marketo pour en savoir plus sur la configuration des webhooks.

Retour en haut

Configurer le mapping des champs d'enrichissement

Le mapping des champs d'enrichissement permet de s'assurer que vos contacts sont correctement mappés sur les deux plateformes.

Pour configurer le mapping des champs d'enrichissement :

  1. Dans Marketo, cliquez sur Modifier le mapping de réponse de votre webhook.
  2. Cliquez sur Ajouter.
  3. Sélectionnez l'attribut Apollo que vous souhaitez utiliser.
 
Pas d'espaces

Si vous rencontrez des problèmes avec les attributs, vérifiez qu'il n'y a pas d'espaces supplémentaires avant ou après chaque attribut de réponse. Vérifiez-le avant de cliquer sur Enregistrer dans Marketo.

Vous pouvez choisir parmi les attributs Apollo suivants :

Type d'attribut Attribut de réponse Apollo Description Format de la valeur
Prénom du contact person.first_name Fait référence au prénom du contact (s'il existe) Chaîne de caractères
Nom du contact person.last_name Fait référence au nom du contact (s'il existe) Chaîne de caractères
Nom complet du contact person.name Fait référence au nom complet du contact (s'il existe) Chaîne de caractères
Profil LinkedIn person.linkedin_url Fait référence au profil LinkedIn du contact Chaîne de caractères
Profil Facebook person.facebook_url Fait référence au profil Facebook du contact Chaîne de caractères
Profil Twitter person.twitter_url Fait référence au profil Twitter du contact Chaîne
Intitulé du poste person.title Fait référence à l'intitulé du poste du contact Chaîne
Ville person.city Fait référence à la ville actuelle où réside le contact Chaîne
État person.state Fait référence à l'état actuel où réside le contact Chaîne
Pays person.country Fait référence au pays actuel où réside le contact Chaîne
Nom de l'entreprise person.organization.name Fait référence au nom de l'entreprise dans laquelle le contact est actuellement employé Chaîne
Site web de l'entreprise person.organization.website_url Fait référence au site web de l'entreprise (e.g. http://www.google.com) Chaîne
URL AngelList person.organization.angellist_url Fait référence à l'URL AngelList de l'entreprise Chaîne
Profil LinkedIn de l'entreprise person.organization.linkedin_url Fait référence au profil LinkedIn de l'entreprise Chaîne
Profil Twitter de l'entreprise person.organization.twitter_url Fait référence au profil Twitter de l'entreprise Chaîne
Profil Facebook de l'entreprise person.organization.facebook_url Fait référence au profil Facebook de l'entreprise Chaîne
Domaine de l'entreprise person.organization.domain Fait référence au domaine de l'entreprise (e.g. google.com) Chaîne
Effectif de l'entreprise person.organization.estimated_num_employees Fait référence à une estimation de la taille de l'entreprise (e.g. 13) Entier
Numéro de téléphone de l'entreprise person.organization.phone Fait référence au numéro de téléphone principal de l'entreprise Chaîne
Classement Alexa person.organization.alexa_ranking Fait référence au classement Alexa du site web principal de l'entreprise Entier
Langues de l'entreprise person.organization.languages Fait référence à la liste des langues prises en charge par le site web de l'entreprise Tableau de chaînes
Logo de l'entreprise person.organization.logo_url Fait référence au logo de l'entreprise Chaîne
Secteur person.organization.industry Fait référence au secteur dans lequel l'entreprise opère Chaîne
Adresse du siège social person.organization.raw_address Fait référence à l'adresse brute du siège social mondial de l'entreprise Chaîne
Ville du siège social person.organization.city Fait référence à la ville où se situe le siège social mondial de l'entreprise Chaîne
État du siège social person.organization.state Fait référence à l'État où se situe le siège social mondial de l'entreprise Chaîne
Pays du siège social person.organization.country Fait référence au pays où se situe le siège social mondial de l'entreprise Chaîne
Symbole boursier person.organization.publicly_traded_symbol Fait référence au symbole boursier de l'entreprise, si elle est cotée en bourse (par ex. AAPL pour Apple) Chaîne
Bourse de cotation person.organization.publicly_traded_exchange Fait référence au nom de la bourse sur laquelle l'entreprise est cotée (par ex. NYSE) Chaîne
Description SEO de l'entreprise person.organization.seo_description Fait référence à la brève description que l'entreprise utilise pour se présenter à des fins de SEO Chaîne
Financement total person.organization.total_funding Fait référence au montant total des financements levés par l'entreprise en USD (par ex. 120000000) Entier
Date du dernier tour de financement person.organization.latest_funding_round_date Fait référence à la date du dernier financement reçu par l'entreprise, le cas échéant (par ex. 2016-05-01T00:00:00.000+00:00) Chaîne
Dernier stade de financement person.organization.latest_funding_stage Fait référence à l'étape du dernier financement de l'entreprise, le cas échéant (par ex. Series A) Chaîne de caractères
Nombre de points de vente person.organization.retail_location_count Fait référence au nombre total de points de vente de l'entreprise Entier
Chiffre d'affaires annuel person.organization.annual_revenue Fait référence à une estimation du chiffre d'affaires actuel de l'entreprise en USD (par ex. 120000000) Entier
Technologie person.organization.technology_names Fait référence à une liste des technologies que l'entreprise utilise actuellement Tableau de chaînes de caractères
 
Formats de valeur

Vous n'avez pas besoin de connaître les formats de valeur pour configurer le mappage des champs d'enrichissement dans Marketo. Cependant, si vous utilisez l'API Apollo régulièrement, vous pouvez vouloir savoir à quoi correspond chaque format de valeur :

  • Chaîne de caractères : affiche une série de caractères correspondant à une seule valeur. Dans l'API Apollo, vous devez entourer les chaînes de caractères de guillemets. Par exemple :
    “person.organization.country”: "Brazil"
  • Entier : une valeur numérique unique. Dans l'API Apollo, vous ne devez pas utiliser de guillemets. Par exemple :
    “person.organization.annual_revenue”: 4000000
  • Tableau de chaînes de caractères : une série de caractères correspondant à plusieurs valeurs. Dans l'API Apollo, vous devez entourer tous les tableaux de chaînes de caractères de crochets. Par exemple :
    “person.organization.technology_names” : ["Cloudflare DNS", "Mailchimp Mandrill"]
  1. Sélectionnez le champ correspondant au champ Marketo dans Marketo.

Champ Marketo

  1. Vous pouvez ajouter autant de champs que nécessaire. Répétez le processus pour les champs supplémentaires.
  2. Lorsque vous avez terminé, cliquez sur Enregistrer.

Vous êtes maintenant prêt à déclencher le webhook dans Marketo.

 
Enrichissez les Leads, s'il vous plaît

Pour en savoir plus sur l'utilisation de votre webhook afin d'enrichir les Leads avec les déclencheurs de Marketo, consultez Utiliser un webhook dans une Smart Campaign dans la base de connaissances Marketo.

Retour en haut