Intégration de Facebook Login à l’API de rapports Audience Network version 2

Facebook Login est une nouvelle solution permettant d’autoriser l’accès aux données de l’API de rapports Audience Network. Cette méthode remplacera la précédente, qui consistait à copier-coller le token d’utilisateur·ice système depuis l’interface du Gestionnaire de monétisation. Cette méthode permet d’accorder l’accès à vos données de façon beaucoup plus sécurisée. Le token peut en effet être exposé en dehors de l’entreprise.

Le présent document a pour objet d’accompagner les partenaires d’intégrations d’API de rapports directs, les partenaires de mesure mobile (Mobile Measurement Partners), les partenaires de médiation et les autres partenaires Facebook qui travaillent sur l’accès aux données de l’API de rapports pour le compte d’éditeurs ou d’éditrices.

J’utilise une solution tierce pour obtenir les données de l’API de rapports

Si vous utilisez le partenaire existant (partenaire de mesure mobile ou de médiation), aucun code supplémentaire n’est nécessaire. Assurez-vous que votre partenaire intègre le flux Facebook Login. Vous devrez cliquer sur l’option « Connexion avec Facebook » et sélectionner les propriétés auxquelles vous souhaitez donner accès avec le token généré.

Si vous sélectionnez TOUTES les propriétés, le token donnera accès à toutes les propriétés de l’entreprise tant que le créateur ou la créatrice du token aura accès à ces propriétés dans le Business Manager.

Autorisations

Pour utiliser directement l’API de rapports, vous devrez d’abord créer une application Facebook et obtenir les autorisations requises. Votre application doit disposer de l’autorisation read_audience_network_insights pour accéder aux données de l’API de rapports Audience Network. Afin d’obtenir cette autorisation pour votre application, l’entreprise doit intégrer l’Audience Network.

• Une fois l’intégration au Gestionnaire de monétisation effectuée, accédez à la Page destinée aux équipes de développement Facebook et créez la nouvelle application d’entreprise.

• Sélectionnez l’entreprise nouvellement créée dans le champ Compte business.

Après avoir créé l’application, vous devrez l’associer à votre compte du Gestionnaire de monétisation en sélectionnant « Audience Network » et en cliquant sur le bouton « Configurer ». Choisissez ensuite le compte du Gestionnaire de monétisation que vous souhaitez associer.

Vous pouvez également accéder à la page developers.facebook.com/apps et sélectionner l’application que vous venez de créer.

Votre application est maintenant intégrée à Audience Network et peut utiliser l’autorisation read_audience_network_insights. Si l’autorisation read_audience_network_insights n’apparaît pas, assurez-vous que l’application a accès à votre compte business du Gestionnaire de monétisation.

Si vous avez précédemment obtenu l’autorisation read_insights permission avec Facebook Login, cela fonctionnera toujours, mais nous vous suggérons de passer à l’autorisation read_audience_network_insights.

Le type d’intégration employé détermine votre mode d’accès à l’API de rapports. Suivez les instructions adaptées à votre situation :

• Intégration directe de l’API sans interface UI
• Intégration directe de l’API avec interface UI

Intégration directe de l’API sans interface UI

Si vous utilisez une intégration d’API de rapports personnalisée (directe) sans interface front-end ou UI pour interroger uniquement les données de votre entreprise, suivez les instructions ci-après pour accéder à l’API de rapports.

Créer un token utilisateur·ice via l’explorateur de l’API Graph

1. Si vous utilisez déjà l’API Marketing dans votre application, ignorez cette étape. Sinon, suivez les instructions pour obtenir une autorisation read_audience_network_insights.
2. Accédez à l’explorateur de l’API Graph.
3. Sélectionnez votre application.
4. Sélectionnez l’autorisation read_audience_network_insights (sous Autorisations > Pages de groupe d’évènements) et cliquez sur Générer un token d’accès.
1. Vous pouvez désormais accéder aux données de l’API de rapports Audience Network avec ce token, plutôt qu’avec celui du Gestionnaire de monétisation.
2. Avertissement : ce token expire au bout de 2 heures, vous devez donc le changer en token d’accès de longue durée en suivant les instructions ci-après.

Transformer ce token en token d’accès de longue durée

1. Accédez au Programme de débug des tokens d’accès.
2. Insérez votre token et appuyez sur Débuguer.
3. Faites défiler jusqu’au bas du tableau contenant toutes les informations du token, puis cliquez sur Étendre le token d’accès.

4. Copiez le token généré.

Vous pouvez maintenant accéder aux données de l’API de rapports Audience Network avec ce token.

Intégration directe de l’API avec interface UI

Le guide suivant est destiné aux éditeur·ices et partenaires qui ont intégré le bouton Facebook Login sur leur propre interface. Il explique aux éditeur·ices comment accéder à leurs données et permet aux partenaires d’obtenir les données de monétisation d’autres éditeur·ices avec leur autorisation.

Vous pouvez également consulter la vidéo de démonstration détaillée du guide suivant pour savoir comment obtenir ces autorisations :

Une erreur s’est produite

Nous rencontrons des difficultés pour lire cette vidéo.

En savoir plus

• Sur le portail des développeur·ses, sélectionnez l’application d’entreprise créée à l’étape précédente.
• Ajoutez un nouveau produit « Facebook Login » à cette application.

• Sélectionnez l’option « Web », puis suivez la procédure d’intégration.

• Insérez l’URL du site web qui permettra d’utiliser Facebook Login. Assurez-vous que le protocole HTTPS soit pris en charge.

• Une fois l’intégration terminée, vous recevrez l’exemple de code pour intégrer Facebook Login à votre site. Vous pouvez copier ce code en utilisant toutefois la nouvelle autorisation read_audience_network_insights au lieu des autorisations public_profile,email suggérées. Avec l’autorisation mise à jour, le code de votre bouton devrait ressembler à ce qui suit :

<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>

• Veillez à activer le SDK JavaScript dans la page des paramètres du produit Facebook Login de votre application.

• Maintenant, l’utilisateur ou l’utilisatrice peut passer par le flux Facebook Login sur votre page pour générer un token d’accès.
• Le token d’accès sera renvoyé dans le cadre de l’argument transmis à la méthode JavaScript statusChangeCallback décrite à l’étape précédente.

• Par défaut, ce jeton expirera au bout de 2 heures environ.
• Les développeurs et les développeuses peuvent demander l’extension de ce token aux tokens d’accès de longue durée sans intervention supplémentaire de l’utilisateur ou de l’utilisatrice.

  • Les tokens de longue durée sont actualisés une fois par jour, quand une requête d’API de rapports est envoyée aux serveurs de Facebook. En l’absence de requête, le token expire après environ 60 jours, et un nouveau token doit être généré.
• Gardez à l’esprit que la disponibilité des données via ce token dépend essentiellement de ce que celui ou celle qui utilise ce flux Facebook Login accepte de partager. Ainsi, si un·e employé·e de l’entreprise utilise ce flux, le token d’accès généré aura les mêmes autorisations que lui ou elle.

Dépannage