Guide de migration : Instagram (IX) vers l’extension Meta Business, v2

En tant que l’un de nos partenaires sur les boutons d’action Instagram, reposant sur l’intégration Instant Experiences (IX), vous devez créer les conditions suivantes pour l’extension Meta Business (MBE) v2 afin de conserver vos boutons call-to-action Commander à manger et la fonctionnalité de sticker de stories Repas à domicile :

1. URL d’authentification : pour permettre à vos entreprises de s’intégrer à MBE depuis Facebook ou Instagram.
2. Webhook : pour recevoir des notifications rapides chaque fois que l’une de vos entreprises installe ou désinstalle MBE.
3. Déclencher des évènements de pixel : pour aider vos entreprises à mieux cibler les nouveaux clients, à augmenter les transactions sur vos sites Web et à mesurer directement comment l’intégration de MBE contribue à doper leurs résultats.

Une fois que vous aurez terminé le développement et les tests de MBE, Meta examinera et vérifiera votre intégration. Une fois votre intégration approuvée, votre application sera disponible au grand public.

Avant de commencer

• Inscrivez-vous en tant que développeur·se Facebook pour accéder à nos outils destinés aux équipes de développement et créer des applications Meta.
• Si vous ne l’avez pas déjà fait, créez une application Meta.
• Créez une application de test à partir de votre application active/de production et utilisez-la pour réaliser tous les nouveaux développements et tests.
• Vos applications (actives/de production et de test) doivent être des applications Business et appartenir au compte Business Manager d’une entreprise vérifiée. Découvrez comment vérifier votre entreprise et y ajouter vos applications.
• Contactez votre partenaire Meta et partagez vos ID d’application pour qu’il vous donne accès à la fonctionnalité MBE manage_business_extension. Une fois approuvé, vous pourrez commencer le travail d’implémentation.

Configurer votre intégration via Developer Panel

Le produit Developer Panel de l’extension Meta Business est disponible dans votre Espace App pour développeurs. Une fois que vos applications ont accès à la fonctionnalité MBE, vous devez utiliser Developer Panel pour configurer et valider votre intégration (y compris l’URL d’authentification et le point de terminaison Webhook).

Étape 1 : ajoutez le produit MBE Developer Panel à vos applications Facebook pour les développeur·ses.

Étape 2 : sur l’onglet Configuration, sélectionnez Food and Drink comme votre verticale unique, sélectionnez Instagram Call to Action Button et Page Surface Call To Action Button comme fonctionnalités et incluez tous les domaines que votre application propose sur la carte des domaines avec caractères génériques.

Étape 3 : après avoir défini l’URL d’authentification, utilisez l’interface Applications professionnelles sur l’onglet Configuration pour faire valider votre URL (toute erreur sera répertoriée ici). Une fois qu’elle est validée, vous pouvez accéder aux applications professionnelles de Meta pour le test de bout en bout.

Étape 4 : après avoir créé le Webhook, accédez à ce dernier et configurez-le dans le produit Webhooks. Si la configuration est correcte, une coche verte s’affiche sur l’onglet Vue d’ensemble pour l’élément Webhook validé.

Étape 5 : après le déclenchement des événements de pixel requis, remplissez le questionnaire du pixel (y compris une vidéo pour valider votre implémentation du pixel).

Étape 6 : aidez notre équipe à vérifier et à approuver votre intégration en fournissant des détails sur la carte Examen d’intégration de l’onglet Examen d’intégration. Ils doivent inclure les identifiants de connexion à votre plateforme pour la connexion à votre URL d’authentification. Ajoutez un lien vers une capture vidéo illustrant la procédure d’intégration de bout en bout et les fonctionnalités que vous avez activées.

Étape 7 : une fois que vous avez terminé l’implémentation MBE, complétez la liste de contrôle dans l’onglet Vue d'ensemble du panneau Developer Panel. Complétez les formulaires des détails de l’application et de l’examen d’intégration dans l’onglet Examen d’intégration. Cliquez sur le bouton Envoyer pour lancer le processus d’examen. Une fois votre intégration approuvée, vous pouvez lancer votre application pour le grand public depuis l’onglet Lancer. En savoir plus sur le processus d’examen d’intégration et comment recevoir l’avis de notre équipe et connaître l’état actuel

Créer une URL d’authentification

Business App, disponible sur toutes les interfaces Meta, permet aux entreprises de découvrir des applications d’entreprise tierces et de s’y connecter afin de se doter facilement d’outils professionnels à faible coût technologique, et ainsi de se développer et d’atteindre leurs objectifs commerciaux.

MBE v2 utilise une URL d’authentification comme canal de confiance pour partager la configuration d’entreprise de l’utilisateur (nom, URL pour le CTA, etc.) entre votre plateforme et Instagram/Facebook.

Votre URL d’authentification doit accepter un paramètre de requête GET redirect_uri et avec cette URL, nous recommandons les suggestions suivantes :

1. Permettez à vos utilisateur·ices de se connecter à votre plateforme, mais aussi d’enregistrer un nouveau compte sur votre plateforme (c'est-à-dire « s’inscrire »).
2. Si vous prenez en charge plusieurs entreprises par compte sur votre plateforme, affichez une UI dans laquelle l’utilisateur·ice peut sélectionner l’entreprise de votre plateforme à associer à sa présence Facebook.
3. Obtenez le paramètre de requête redirect_uri reçu et ajoutez-y l’objet codé extras comme paramètre de requête.
4. Redirigez les utilisateur·ices vers l’URL résultante (uniquement si le paramètre redirect_uri reçu correspond à notre expression régulière).

Exemple - Utilisez l’objet extras pour configurer une entreprise et activer son CTA du profil Instagram et son CTA de la page Facebook

{
  "setup": {
    "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", //e.g. "foo-123"
    "timezone": "<BUSINESS_TIMEZONE>", //e.g. "America/Los_Angeles"
    "currency": "<BUSINESS_CURRENCY>", //e.g. "USD"
    "business_vertical": "FOOD_AND_DRINK"
  },
  "business_config": {
    "business": {
      "name": "<BUSINESS_NAME>"  //e.g. "Foo Business"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Order Food",
      "cta_button_url": "<BUSINESS_URL_FOR_CTA>"  //e.g. "https://partner-site.com/foo-business/order"
    },
     "page_cta": {
         "enabled": true,
         "cta_button_text": "Order Food",
         "cta_button_url": "<BUSINESS_URL_FOR_CTA>", // e.g. "https://partner-site.com/foo-business/order"
         "below_button_text": "Powered by <YOU>"
     }
  },
  "repeat": false 
}

Pour plus de détails sur l’implémentation complète et les tests, consultez la section Applications Business.

Créer un Webhook

Une fois qu’un·e utilisateur·ice a installé, mis à jour ou désinstallé votre application via Business Apps, vous recevez les détails pour cette action via Webhook.

Configurer le webhook nécessite les opérations suivantes :

1. Créez un point de terminaison sur un serveur sécurisé capable de traiter les demandes POST provenant de Facebook.
2. Configurez le produit Webhooks dans l’Espace App de votre application pour vous abonner au champ fbe_install de l’objet User.

Pour plus de détails sur l’implémentation et la configuration complètes, consultez la section Webhook.

Déclencher des évènements de pixel

Le pixel Meta fait partie intégrante de l’extension Meta Business v2. Nous exigeons que vous déclenchiez avec précision le pixel pour les évènements standard suivants, pour chaque entreprise intégrée dans la MBE sur votre plateforme.

Évènements obligatoires

• Pour toutes les pages impliquées dans le processus Commande de repas : déclenchez PageView
• Une fois la commande passée : déclenchez Purchase

Évènements facultatifs

• Déclenchez AddToCart lorsqu’un article est ajouté à la commande.

Tous les évènements standards peuvent être déclenchés par l’appel de la fonction fbq('track') du pixel suivi du nom de l’évènement et (en option) d’un objet JSON utilisés comme paramètres. Par exemple, un évènement d’achat nécessite d’inclure la devise et la valeur comme paramètres :

fbq('track', 'Purchase', {currency: "USD", value: 30.00});

Pour plus de détails sur l’implémentation complète, consultez la section Déclencher des évènements de pixel.

Pixel Helper

Nous vous recommandons fortement d’installer notre extension Chrome Pixel Helper. Pixel Helper fournit des commentaires extrêmement précieux qui peuvent vous aider à vérifier que votre pixel fonctionne correctement, surtout lorsque vous commencez à suivre les conversions, où vous pouvez facilement rencontrer des erreurs de formatage.

Examen et lancement de l’intégration

Une fois que vous avez terminé l’implémentation de MBE, complétez la liste de contrôle dans l’onglet Vue d’ensemble de Developer Panel. Complétez les formulaires des détails de l’application et de l’examen d’intégration dans l’onglet Examen d’intégration. Cliquez sur le bouton Envoyer pour lancer le processus d’examen.

L’examen d’intégration est le processus par lequel Meta vérifie l’intégration de votre extension Meta Business. Une fois votre intégration approuvée, vous pouvez lancer votre application pour le grand public à partir de l’onglet Lancer. En savoir plus sur ce processus.

Une fois votre intégration soumise via l’onglet Examen d’intégration dans Developer Panel, vous pouvez consulter son statut, ainsi que les mises à jour et commentaires de nos examinateur·ices dans la section Historique des soumissions de la carte Examen d’intégration.

Nos examinateur·ices fourniront des commentaires détaillés. Si votre application est rejetée, exécutez toutes les étapes requises avant de lancer un nouveau processus d’examen. Pour cela, cliquez sur le bouton Renvoyer dans l’onglet Examen d’intégration.