Comptes publicitaires

En tant qu’admin d’entreprise, vous pouvez revendiquer les comptes publicitaires qui appartiennent à l’entreprise. De cette façon, vous pouvez facilement affecter des utilisateur·ices aux comptes publicitaires auxquels elles ou ils doivent accéder. Vous pouvez par la suite affecter des sources d’approvisionnement partagées à vos comptes publicitaires.

Revendiquer des comptes

Si vous gérez des comptes publicitaires en dehors d’un compte Business Manager avec le rôle Admin, vous pouvez les revendiquer pour votre entreprise. Vous ne devez effectuer cette étape qu’une seule fois. Une fois les comptes publicitaires revendiqués, vous pouvez uniquement les gérer dans ce compte Business Manager.

Les comptes de contenu publicitaire ne peuvent pas être revendiqués.

Afin de revendiquer un compte publicitaire pour votre entreprise, fournissez son ID, au format act_###. Envoyez une requête POST : \La personne à l’origine de la demande doit être un·e admin de l’entreprise qui revendique le compte publicitaire

curl \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

Si vous êtes admin du compte publicitaire, nous approuvons instantanément cette demande de revendication. Facebook renvoie access_status, qui est défini sur CONFIRMED.

Si vous êtes un·e utilisateur·ice et ne disposez pas des autorisations appropriées pour le compte publicitaire, nous envoyons une demande de propriété aux admins du compte publicitaire. La réponse à cette requête contient access_status, qui est défini sur PENDING.

Pour accepter une demande de propriété, vous devez être admin du compte publicitaire. Vous devez également vous connecter et accepter la demande dans le Gestionnaire de publicités.

Demander l’accès à un compte

La plupart des entreprises de marketing n’ont pas besoin de revendiquer des comptes publicitaires auprès de leur clientèle. Consultez la rubrique Fonctions B2B pour demander l’accès aux éléments appartenant à d’autres comptes Business Manager.

Créer des comptes publicitaires

Pour utiliser cette API, vous devez avoir une entreprise et une Page valides. Si vos comptes publicitaires ne sont pas complets ou si vos Pages ne sont pas publiées par Facebook, vous ne pourrez pas créer de nouveau compte publicitaire.

Il est possible de créer jusqu’à 5 comptes publicitaires avec l’API. Au-delà, vous devrez créer les comptes publicitaires manuellement.

Les champs disponibles sont les suivants :

Pour créer un compte publicitaire pour une entreprise, indiquez les paramètres name, currency, timezone_id, end_advertiser, media_agency et partner. Les conditions suivantes s’appliquent :

• media_agency et partner doivent être un alias de Page Facebook, un ID de Page Facebook ou un ID d’application Facebook.
• end_advertiser doit être un ID d’entreprise.

Si votre compte publicitaire n’a pas d’annonceur, d’agence média ni de partenaire, indiquez NONE. Si votre compte publicitaire dispose d’un annonceur, d’une agence média ou d’un partenaire, mais qu’ils ne correspondent pas à une Page ou à une application sur Facebook, indiquez UNFOUND.

Pour créer un compte publicitaire :

curl \
  -F "name=MyAdAccount" \
  -F "currency=USD" \
  -F "timezone_id=1" \
  -F "end_advertiser=<END_ADVERTISER_ID>" \
  -F "media_agency=<MEDIA_AGENCY_ID>" \
  -F "partner=NONE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

Si vous avez déjà établi une ligne de crédit étendu avec Facebook, définissez invoice sur true. Nous associons ensuite votre nouveau compte publicitaire à votre ligne de crédit étendu.

La réponse se présente comme suit :

{
  "id": "act_<ADACCOUNT_ID>",
  "account_id": "<ADACCOUNT_ID>",
  "business_id": "<BUSINESS_ID>",
  "end_advertiser_id": "<END_ADVERTISER_ID>",
  "media_agency_id": "<MEDIA_AGENCY_ID>",
  "partner_id": "NONE"
}

Afficher les comptes appartenant à votre entreprise

Pour afficher tous les comptes publicitaires auxquels votre entreprise a accès, exécutez un appel GET :

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

Cet appel renvoie tous les comptes publicitaires appartenant à l’entreprise. Certains champs concernent spécifiquement la relation qui lie l’entreprise au compte publicitaire.

• permitted_tasks répertorie les tâches que vous pouvez attribuer pour ce compte publicitaire particulier.
• access_type définit si votre entreprise est OWNER ou AGENCY du compte publicitaire.

Pour afficher les comptes publicitaires pour lesquels l’accès est toujours en attente, exécutez l’appel GET suivant :

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"

Supprimer des comptes

Vous ne pouvez pas supprimer les comptes publicitaires de votre entreprise si vous êtes OWNER et que les comptes sont CONFIRMED. Si votre demande d’accès est PENDING ou si vous avez un accès AGENCY au compte publicitaire, vous pouvez exécuter l’appel DELETE suivant :

curl \
  -X DELETE \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"

Visualiser les autorisations d’accès à un compte

Pour afficher les comptes publicitaires pour lesquels un·e utilisateur·ice dispose d’une autorisation, exécutez l’appel GET suivant :

curl -G \
  -d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"

Pour afficher les autorisations dont un·e utilisateur·ice dispose pour un compte publicitaire, exécutez l’appel GET suivant :

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Ajouter des utilisateur·ices à des comptes

Dès lors que votre compte Business Manager est associé à un compte publicitaire, vous pouvez attribuer des tâches à d’autres utilisateur·ices professionnel·les. Voici la liste des tâches possibles :

Réalisez les actions suivantes :

• adaccount_id : ID du compte publicitaire, au format act_123
• user_id : identifiant de l’utilisateur·ice à ajouter
• Tâches à attribuer

Pour ajouter un·e utilisateur·ice et lui attribuer les tâches ['MANAGE', 'ADVERTISE', 'ANALYZE'], exécutez l’appel POST suivant :

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Modifier des autorisations associées à des comptes

Pour modifier les tâches d’un·e utilisateur·ice existant·e, exécutez le même appel POST que lors de l’ajout d’un·e utilisateur·ice :

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Supprimer des utilisateur·ices de comptes publicitaires

Pour supprimer un·e utilisateur·ice d’un compte, vous avez besoin des éléments suivants :

• adaccount_id : ID du compte publicitaire, au format act_123
• user_id : identifiant de l’utilisateur·ice à supprimer

L’appel DELETE se présente comme suit :

curl \
  -X DELETE \
  -F "user=<BUSINESS_SCOPED_USER_ID>" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"