Objectif

Le connecteur Facebook vous permet de collecter des données et des statistiques d'une page Facebook dans la Data Platform, comme les mentions « J'aime », les vues et les commentaires.

Obtenez vos identifiants d'accès

Découvrez comment obtenir un token d'application Facebook Developer

Les étapes suivantes vous guideront dans la procédure de création d'un token d'application sur l'interface utilisateur de Facebook Developer.

Prérequis : token d'application

• Connectez-vous à votre compte Facebook qui dispose de toutes les permissions Admin sur les pages pour lesquelles vous souhaitez obtenir les access tokens.
  Si vous n'êtes pas administrateur de la page, demandez à votre administrateur de vous accorder un accès Analyst à la page.

• Veuillez noter que si le compte ayant accordé l'accès aux tokens ne dispose plus du rôle d'administrateur ou d'analyste sur la page, l'access token sera révoqué.

Procédure : token d'application

Étape 1. Créez votre application Facebook Developer

• Rendez-vous sur : https://developers.facebook.com/ et cliquez sur Get Started en haut à droite.

• Suivez les étapes dans la fenêtre pop-up qui vient de s'ouvrir. Il n'est pas obligatoire de créer une « First App », vous pouvez ignorer cette étape.

• Rendez-vous sur https://developers.facebook.com. Ouvrez le menu My Apps en haut à droite, juste à côté de la barre de recherche. Vous devriez maintenant pouvoir cliquer sur le bouton Add a New App en haut à droite.

• Remplissez les champs du formulaire qui vient de s'afficher et cliquez sur Create App ID

Étape 2. Récupérez votre App ID et votre App Secret

• Vous arriverez maintenant sur le Dashboard de votre nouvelle application. Cliquez sur Settings à gauche puis sur Basic, juste en dessous.

• Juste à droite du champ App Secret, cliquez sur Show.

• Vous pouvez maintenant copier votre App ID et votre App Secret et les coller dans une nouvelle fenêtre d'éditeur de texte.

Comment valider votre application Facebook

• Rendez-vous sur https://developers.facebook.com/apps. Cliquez sur l'application que vous devez faire vérifier

• Rendez-vous dans vos paramètres de base. Cliquez sur « Settings », puis « Basic »

• Renseignez vos paramètres de base. Donnez les informations suivantes afin de soumettre votre application.

• Ajoutez une platform. En bas de la page de paramètres, cliquez sur « Add Platform ». Puis cliquez sur Website, saisissez l'URL du site web de votre entreprise et cliquez sur « Save changes », en bas à droite.

• Démarrez la revue de l'application en cliquant simplement sur « App Review ». Puis cliquez sur « Add items » dans le coin droit.

• Cliquez ensuite sur « Read_insights » et cliquez sur add 1 item.

• Ajoutez les détails des soumissions. Retournez dans l'onglet « App review tab » et cliquez sur « Add details » pour read_insights.

• Ajoutez les détails de la soumission read_insights

• Soumettez la revue. Vous devez lire les conditions, cliquer sur « I accept... » puis cliquer sur « Submit ».

• Conclusion de la revue. La revue Facebook peut prendre de 2 à 3 jours, voire quelques semaines en période de forte affluence. Si votre revue n'est pas acceptée : Si c'est à cause du screencast, veuillez le réajuster au regard des remarques de Facebook Si c'est à cause du texte de la revue, veuillez réajuster le texte et nous faire part de votre retour Si la raison semble plus bloquante ou en contradiction avec le présent document, vous pouvez contacter l'équipe Data Platform et nous ferons de notre mieux pour vous aider.

• Création de la Business. Dans le menu de gauche, cliquez sur « Settings », puis Advanced. Faites défiler jusqu'à voir « Business Manager », puis cliquez sur « Get started ».

• Complétez et validez le formulaire suivant.

• Vérification de la Business. Une fois votre application vérifiée, vous devriez recevoir un message afin de vérifier votre Business Rendez-vous dans App Review, et cliquez sur « Provide business details ». Renseignez-les puis cliquez sur le bouton Next.

• Vous devez fournir des documents professionnels indiquant la raison sociale de votre entreprise ainsi qu'au moins l'un des éléments suivants, correspondant aux informations que vous venez de saisir :
• Numéro de téléphone professionnel
• Adresse
• Numéro fiscal

• Fournissez des informations de base vous concernant, puis « Submit ».

• Vous recevrez un e-mail afin d'accepter les conditions légales Si vous n'avez pas reçu l'e-mail : veuillez vérifier votre dossier de courriers indésirables. Ou refaites la dernière étape et corrigez vos informations d'e-mail, la soumission renverra un e-mail. Cliquez sur le lien afin d'accepter les conditions.

• Sur la page des conditions, lisez attentivement toutes les conditions, Puis cliquez sur « I Agree » si vous acceptez l'ensemble des conditions.

Vous pouvez maintenant passer à l'étape 3 !

Étape 3. Générez le token de votre application

• Rendez-vous sur https://developers.facebook.com/tools/explorer/

• Cliquez sur le menu déroulant Graph API Explorer en haut à droite et sélectionnez votre application nouvellement créée (appelée Data Platform Connector sur la capture d'écran suivante).

• Cliquez maintenant sur le bouton Get token et sélectionnez Get User Access Token dans le menu déroulant.

• Dans la fenêtre qui vient de s'ouvrir, sélectionnez les différentes permissions dont vous avez besoin (n'oubliez pas de cocher l'option read_insights) et cliquez sur le bouton Get Access Token.

• Cliquez sur le bouton Continue as.

• Puis sur OK en bas à droite.

• Vous venez de générer un access token de courte durée. Copiez-le et collez-le dans votre éditeur de texte, aux côtés de votre App ID et de votre App Secret.

• Modifiez maintenant le modèle d'URL suivant en remplaçant {app_id}, {app_secret} et {access_token} par vos valeurs.

https://graph.facebook.com/v2.12/oauth/access_token?grant_type=fb_exchange_token&client_id={app_id}&client_secret={app_secret}&fb_exchange_token={access_token}

• Une fois cela fait, collez votre URL dans votre navigateur web. Copiez le résultat et collez-le dans votre éditeur de texte.

• Copiez cette nouvelle URL et remplacez {access token} par le contenu du champ "access_token" du résultat de l'étape précédente :

https://graph.facebook.com/v2.12/me?access_token={access_token}

• Une nouvelle fois, copiez le résultat de l'étape précédente dans votre éditeur de texte et remplacez {account_id} et {access_token} par les champs id et access_token des étapes précédentes dans le modèle d'URL suivant :

https://graph.facebook.com/v2.12/{account_id}/accounts?access_token={access_token}

• Une dernière fois, collez l'URL dans votre navigateur web. Vous pouvez maintenant enregistrer les informations affichées à l'écran dans un document .json.

Découvrez comment trouver l'identifiant de votre page Facebook

Prérequis : identifiant de page

• Vous devez être administrateur de la page pour obtenir cette information.

Procédure : identifiant de page

Étape 1. Connectez-vous à votre compte Facebook qui dispose d'un accès Admin à la page.

Étape 2. Cliquez sur les trois points horizontaux et sélectionnez Edit Page Info dans le menu déroulant.

Étape 3. Cliquez sur See All Information en bas de la fenêtre qui vient de s'ouvrir.

Étape 4. Copiez votre Page ID tout en bas de la page.

Ajoutez une source Facebook sur Data Platform

Aperçu de l'écran de configuration

Une fois que vous avez trouvé Facebook dans le Data Platform store, cliquez sur Select et vous pourrez voir l'écran de configuration comme illustré ci-dessous :

Configuration de votre source

Se connecter à Facebook

Lors de la création de la source, vous devrez saisir les informations suivantes :

• Account : votre Page ID Facebook
• Access Token : le token de votre application Facebook Developer
• Source default schema : vous pouvez utiliser ce champ pour ajouter des colonnes à vos données, si nécessaire. Utilisez la syntaxe suivante {"name":"value"}, où name est le nom de votre colonne et value est la valeur qui sera renseignée dans toutes les lignes.

Une fois ces informations ajoutées, cliquez sur Connect pour établir une connexion avec Facebook.

Ajoutez les Accounts et Endpoints

Avant de continuer, vous devez ajouter des accounts et des endpoints.

• Les Accounts sont des pages Facebook référencées par le Page ID - comme dans l'écran précédent - dont vous souhaitez récupérer des données.
• Les Endpoints sont les différents types de données sur les accounts que la Data Platform récupérera via l'API Facebook. Chaque endpoint correspond à une table finale, agrégeant les données pour tous les accounts sélectionnés.

Comment ajouter un account ?

Pour ajouter un account, cliquez sur Add an Account. Cela ouvrira la fenêtre suivante :

Par défaut, il utilise les mêmes identifiants que ceux saisis précédemment lors de l'établissement de la connexion, que vous pouvez écraser ici. Le nom du compte est le nom d'affichage interne.

Comment ajouter un endpoint ?

Sur la Data Platform, chaque endpoint enregistré correspondra à un objet source de données, que vous pourrez charger dans une table distincte.

Pour ajouter un endpoint, cliquez sur Add an Endpoint. Cela ouvrira la fenêtre suivante :

Ensuite, sélectionnez le type d'endpoint que vous souhaitez ajouter. L'équipe Data Platform ajoute continuellement de nouveaux types d'endpoints aux connecteurs. Vous pouvez cliquer sur la liste déroulante sous le champ Type pour voir ceux disponibles.

Les plus courants sont :

• page_data : données générales sur la page.
• day_insights : données sur la page triées par jour.
• post_insights : données sur les publications de la page.

Certains types nécessitent d'ajouter des Insights à l'endpoint, ce qui est simplement une façon d'indiquer à la platform Data Platform quelles données récupérer. Pour ajouter un insight, commencez à taper dans le champ Insight et cliquez sur Enter pour sélectionner le data insight souhaité.

Pour terminer, cliquez sur le bouton Create en haut à droite.

Aller plus loin

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l’équipe qui développe la Data Platform sur le canal Discord dédié.

Si vous avez besoin d'une assistance concernant vos services OVHcloud, créez une demande depuis notre centre d'aide.

Rejoignez notre communauté d'utilisateurs.