Autorisation
Le processus d’autorisation vérifie les utilisateur·ices et les applications qui accèdent à l’API Marketing pour leur accorder des autorisations.
Rôles dans l’application
Dans votre Espace App, vous pouvez définir les rôles suivants pour vous-même ou pour les membres de votre équipe si nécessaire : admin, développeur·se, testeur·se.
Remarque : selon l’utilisation prévue, vous devrez peut-être soumettre votre application pour examen afin d’accéder à des autorisations spécifiques liées à la gestion publicitaire.
Niveaux d’accès, autorisations et fonctionnalités
Les applications Business sont soumises à une couche supplémentaire d’autorisation de l’API Graph appelée niveaux d’accès. Durant le Contrôle app, vous devez également demander des autorisations et fonctionnalités spécifiques pour votre application.
Chaque niveau comporte des restrictions ; voir Niveaux d’accès et fonctionnalités pour plus d’informations. Les développeurs doivent également se conformer à toutes les Conditions générales de la plateforme et Politiques développeur de Meta. Les appels, QUEL QUE SOIT le niveau d’accès sont contraires aux données de production.
Niveaux d’accès à l’API Marketing et Accès standard à la gestion des publicités
Les autorisations et les fonctionnalités pour les applications ont deux niveaux d’accès différents : l’accès standard et l’accès avancé (Remarque : l’utilisation du terme « accès standard » ici n’est pas liée à la fonctionnalité Accès standard à la gestion des publicités) Pour qu’une application bénéficie du niveau d’accès avancé à la fonctionnalité Accès standard à la gestion des publicités, vous devez la soumettre à un examen.
Accès à l’API Marketing et Accès standard à la gestion des publicités
| Accès à l’API Marketing | Accès standard à la gestion des publicités | Action |
|---|---|---|
Accès au développement | Accès standard | Par défaut |
Accès standard | Accès Avancé | Requiert une demande dans l’Espace App |
Pour connaître votre niveau d’accès actuel, accédez à Espace App > Contrôle app > Autorisations et fonctionnalités.
Autorisations et fonctionnalités
Autorisations
Les autorisations à demander varient en fonction de l’API à laquelle vous souhaitez accéder.
Si votre application gère uniquement votre compte publicitaire, l’accès standard à ads_read ainsi que les autorisations ads_management suffisent. Si elle gère le compte publicitaire d’autres personnes, vous avez besoin de l’accès avancé à ads_read et/ou des autorisations ads_management. Consultez la liste des autorisations disponibles pour les applications business.
Fonctionnalités
Les fonctionnalités à demander varient en fonction de l’utilisation que vous prévoyez de faire de nos API. Si vous gérez des publicités, une des fonctionnalités fréquemment demandées est l’accès standard à la gestion des publicités. Consultez la liste des fonctionnalités disponibles pour les applications business.
Niveaux d’accès aux fonctionnalités
| Niveau d’accès aux fonctionnalités | Description |
|---|---|
Les applications d’entreprise obtiennent automatiquement un accès Standard pour toutes les autorisations et fonctionnalités disponibles pour ce type d’application Business. Utilisez cette option si vous démarrez. Vous pouvez créer des flux de travail de bout en bout avant de demander les autorisations complètes. Vous pouvez également accéder à un nombre illimité de comptes publicitaires. Certains appels d’API peuvent ne pas être disponibles avec un Accès standard, car ils peuvent provenir de plusieurs comptes, ou le compte affecté ne peut pas être identifié par programmation. | |
L’accès Avancé doit être approuvé via le processus Contrôle app sur la base d’une autorisation individuelle et d’une fonctionnalité.
Une fois que vos informations ont été soumises, Meta approuve ou refuse votre demande et vous informe des raisons pour lesquelles celle-ci a été refusée, le cas échéant. Si l’accès Avancé est approuvé, vous devez procéder comme suit pour conserver votre statut :
|
Signification du niveau d’accès
Le tableau ci-dessous présente l’impact des niveaux d’accès standard et avancé sur la fonctionnalité Accès standard à la gestion des publicités.
| Accès standard | Accès Avancé | |
|---|---|---|
Limites de comptes | Gérez un nombre illimité de comptes publicitaires. Les admins ou développeurs d’applications peuvent émettre des appels d’API pour le compte d’admins ou d’annonceurs de comptes publicitaires. | Gérez un nombre illimité de comptes publicitaires, en partant du principe que vous obtenez une autorisation |
Limites de débit | Débit extrêmement limité par compte publicitaire. Pour le développement uniquement. Sont exclues les applications de production exécutées pour les annonceurs en direct. | Débit légèrement limité par compte publicitaire. |
Business Manager | Accès limité aux API Business Manager et Catalog. Aucun accès Business Manager pour gérer des comptes publicitaires, des autorisations utilisateur·ice et des Pages. | Accès à toutes les API Business Manager et Catalog. |
Utilisateur système | Peut créer un utilisateur système et un utilisateur système admin. | Peut créer dix utilisateurs système et un utilisateur système admin. |
Création de Pages | Ne peut pas créer de Pages par l’intermédiaire de l’API. | Ne peut pas créer de Pages par l’intermédiaire de l’API. |
Obtenir l’accès avancé
Pour obtenir un accès avancé à la fonctionnalité Accès standard à la gestion des publicités, votre application doit répondre aux exigences suivantes :
- Vous devez avoir effectué au moins 1 500 appels à l’API Marketing au cours des 15 derniers jours.
- Vous devez avoir émis des appels d’API Marketing avec un taux d’erreur inférieur à 10 % au cours des 15 derniers jours.
Si vous gérez les publicités d’une personne, utilisez le paramètre scope pour lui demander les autorisations ads_management ou ads_read. Votre application obtient l’accès lorsqu’elle clique sur Autoriser.
https://www.facebook.com/v22.0/dialog/oauth? client_id=<YOUR_APP_ID> &redirect_uri=<YOUR_URL> &scope=ads_management
Remarque : lorsque vous remplissez le champ YOUR_URL, ajoutez un / à la fin (par exemple, http://www.facebook.com/).
Exemples de cas d’utilisation
| Cas d’utilisation | Ce qu’il faut demander |
|---|---|
Vous voulez lire et gérer les publicités liées aux comptes publicitaires que vous détenez ou auxquelles vous êtes autorisé·e à accéder par le ou la propriétaire du compte publicitaire. |
|
Vous voulez lire les rapports publicitaires liés aux comptes publicitaires que vous détenez ou auxquels vous êtes autorisé·e à accéder par le propriétaire du compte publicitaire. |
|
Vous voulez extraire les rapports publicitaires d’un ensemble de clients, et lire et gérer à la fois les publicités d’un autre ensemble de clients. |
|
Vérification de l’entreprise
La vérification de l’entreprise est une procédure qui nous permet de vérifier l’identité de votre entreprise, ce qui est obligatoire si votre application doit accéder à des données sensibles. En savoir plus sur la procédure Vérification de l’entreprise.