FB-Login-Reporting-API - Meta Audience Network - Documentation

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.

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 est associée à une entreprise qui a accès au compte business de votre 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

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.
Accédez à l’explorateur de l’API Graph.
Sélectionnez votre application
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.

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.
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

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

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.

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.

Résolution des problèmes

Message d’erreur	Signification	Action/solution
Lecture d’insights d’une Page, d’une entreprise, d’une application, d’un domaine ou d’un groupe de sources d’évènements qui n’appartiennent pas à l’utilisateur·ice ou à l’application qui effectue la requête	Pour le token Facebook Login, cela signifie que l’application générant le token ne dispose pas des autorisations suffisantes (`read_audience_network_insights`) ou qu’un·e utilisateur·ice n’est pas autorisé·e à voir certaines propriétés. Ce problème peut survenir dans les cas suivants : * L’utilisateur·ice qui a généré le token n’a pas accès au Business Manager. * L’utilisateur·ice qui a créé le token n’a pas accès à toutes les propriétés interrogées.	L’admin de l’entreprise doit donner accès à toutes les propriétés à l’utilisateur·ice qui a généré le token ou souhaite le faire.
Données manquantes ou vides	Cela signifie généralement que notre agrégation de confidentialité a appliqué un filtre sur l’ensemble ou une partie des données. La validation peut aussi être effectuée avec les données du Gestionnaire de monétisation.	Vérifiez la présence d’un tableau `omitted_results` qui indiquerait que les données sont en cours d’agrégation. Dans ce cas, élargissez la requête. Pour plus d’informations, lisez la section sur l’agrégation.
`read_audience_network_insights` non visible pour le token	L’application créée pour générer le token n’est pas de type Business et a été associée à votre Gestionnaire de monétisation Audience Network.	Assurez-vous que l’application qui doit générer le token est de type Business. Créez une autre application en suivant les instructions de la section Autorisations. À partir de la page developers.facebook.com/apps, sélectionnez l’application pour laquelle l’autorisation `read_audience_network_insights` n’est pas visible, choisissez « Audience Network », puis cliquez sur le bouton « Configurer ».
`Error validating access token: Session has expired on ...`	Le jeton a expiré	Veillez à le convertir en token de longue durée. Suivez les instructions de la section « Transformer ce token en token d’accès de longue durée ». Les tokens d’accès de longue durée sont actualisés une fois par jour, lorsqu’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é.
2 applications ont le même nom	Vérifiez si une application a les autorisations `read_audience_network_insights`.	Utilisez l’application qui dispose des bonnes autorisations `read_audience_network_insights`.
(#200) Le mode d’accès à l’API de rapports v2.0 a changé. Vous devez maintenant installer Facebook Login pour votre application afin d’accéder à cette API.	Vous n’utilisez pas d’identifiant avec ce nouveau mode d’accès à l’API.	Veillez à créer une application de type Business à partir de zéro (uniquement pour la création de tokens).