Configurer un nouveau Business Manager enfant

À l’origine, la solution Business Manager à deux niveaux était conçue de sorte que chaque token d’accès utilisateur·ice ne permette de créer qu’un seul Business Manager enfant. Cependant, il est désormais possible de créer plusieurs Business Manager enfants, à condition que chacun d’eux soit associé à une Page principale.

Démarrer

Avant de commencer, nous vous recommandons d’examiner les exigences et informations suivantes :

Autorisations de l’application

• business_management
• ads_management

ID

• PARENT_BM_ID : ID du Business Manager du partenaire qui est propriétaire de l’application.
• CHILD_BM_ID : ID du Business Manager (BM) créé par le BM parent pour le client ou la cliente.

Tokens d’accès

• USER_Personal_Access_Token : token d’accès de la personne fournissant les identifiants pour créer le BM enfant.

  • Ce token est généré à l’aide de Facebook Login.
  • Le partenaire doit demander des autorisations business_management de portée globale sur les entreprises et les Pages de l’utilisateur·ice, plutôt que des autorisations spécifiques.
  • Cette personne doit disposer des privilèges d’admin sur la Page partagée dans le BM enfant.
  • Si la Page appartient à un autre BM, cette personne doit disposer des privilèges d’admin sur le BM propriétaire de la Page.
  • Ce token est utilisé pour autoriser la création du BM enfant et pour partager la Page dans le BM enfant à des fins publicitaires.
• PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN : token d’accès de l’utilisateur·ice système admin dans le Business Manager parent.

  • Ce token est utilisé pour créer et gérer les BM enfants.
• CHILD_BM_SYSTEM_USER_ACCESS_TOKEN : token d’accès de l’utilisateur·ice système admin créé·e dans le BM enfant.

  • Ce token est utilisé pour créer et gérer les campagnes et les autres activités dans le BM enfant.

Créer un Business Manager enfant

À l’aide du USER_Personal_Access_Token, créez un Business Manager enfant.

Exemple : renvoie un ID de Business Manager enfant

curl \
  -F 'id=<Parent_Business_Manager_ID>' \
  -F 'name=Advertisers child BM (recommend naming similar to page)' \
  -F 'vertical=OTHER' \ // Specify the Business vertical
  -F 'shared_page_id=<PAGE_ID_FROM_USER>' \  //Optional parameter but needed if you want to publish ads promoting this page
                                             //Note: the user must be an admin of the BM that owns this page if this page is owned
  -F 'page_permitted_tasks=["ADVERTISE", "ANALYZE"]' \
  -F 'timezone_id=1' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Id>/owned_businesses

Réponse :

{
    “ID” : “12312812123132”  //store this child business manager ID and associate to user
}

Créer plusieurs Business Manager enfants par utilisateur·ice

Si l’utilisateur·ice souhaite créer plusieurs Business Manager enfants avec les mêmes identifiants d’utilisateur·ice, la primary_page doit être définie dans un Business Manager enfant existant créé pour cet utilisateur ou cette utilisatrice. Envoyez une autre requête POST pour définir la primary_page du Business Manager enfant existant :

curl \
  -F 'primary_page=<PAGE_ID>' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<BM_ID>

Lorsque vous créez un autre Business Manager enfant :

• Tous les Business Manager enfants existants doivent être associés à une primary_page unique.
• Le shared_page_id doit être défini sur le nouveau Business Manager enfant.
• Si shared_page_id est utilisé pour créer un nouveau Business Manager enfant, il ne doit pas correspondre à la primary_page de l’un des Business Manager enfants existants.

Configurer le moyen de paiement

Pour payer les publicités du BM enfant, vous devrez partager votre ligne de crédit avec celui-ci.

Étape 1. Ouvrir une ligne de crédit. Contactez votre représentant Facebook et ouvrez une ligne de crédit dans le compte Business Manager s’il n’en a pas encore. La ligne de crédit sera affichée comme moyen de paiement dans votre compte Business Manager parent.

Étape 2. Accepter les mentions légales de la ligne de crédit.

1. Ouvrez Business Manager > Paramètres de l’entreprise > Moyens de paiement.
2. Cliquez sur Paramètres de crédit, puis sur Mentions légales. Acceptez les mentions légales.

Étape 3. Récupérer l’ID de la ligne de crédit et le partager avec le Business Manager enfant.

1. Accédez à votre Business Manager parent, sélectionnez Paramètres de l’entreprise > Moyens de paiement, puis cliquez sur Moyen de paiement. Enregistrez le PARENT_BM_Line_Of_Credit_ID inclus dans l’URL. L’URL devrait ressembler à ceci :

   https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>

2. Utilisez l’ID de ligne de crédit du Business Manager parent dans l’appel d’API ci-dessous pour partager cet ID avec le Business Manager enfant. amount est facultatif.

   curl \
     -F 'receiving_business_id=<CHILD_BUSINESS_MANAGER_ID>' \
     -F 'amount=<OPTIONAL_PARAMETER>' \  
     -F 'access_token=<Parent_BM_Admin_System_User_Access_Token>' \
     -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
     https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Line_Of_Credit_ID>/owning_credit_allocation_configs

Obtenir le token d’accès utilisateur·ice système enfant

Dans le Business Manager enfant, utilisez cet appel d’API pour créer un utilisateur ou une utilisatrice système et récupérer le token d’accès correspondant. Vous utiliserez ce token dans tous les appels suivants envoyés au Business Manager enfant pour créer et gérer des publicités au nom de cet utilisateur ou de cette utilisatrice.

curl \
  -F 'id=<CHILD_BUSINESS_MANAGER>' \
  -F 'app_id=<App_ID>' \
  -F 'scope=ads_management,business_management' \
  -F 'access_token=<Parent BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/access_token

Récupérer l’ID de l’utilisateur·ice système

Une fois le token d’accès récupéré, vous pouvez l’utiliser pour déterminer l’ID utilisateur·ice spécifique à l’application. Il est important de le conserver pour plus tard.

curl -G \
  -d 'access_token=<Child BM System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/system_users

Récupérer l’ID de la source d’approvisionnement (ligne de crédit)

1. Récupérez la nouvelle source d’approvisionnement dans le Business Manager enfant. Comme le montre cet exemple, vous pouvez utiliser cette source d’approvisionnement plus tard lors de la création d’un compte publicitaire.

curl -G \
  -d 'fields=id,max_balance' \
  -d 'access_token=<Child BM Admin System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/extendedcredits

Pour obtenir la source d’approvisionnement, vous pouvez aussi accéder à votre Business Manager enfant, sélectionner Paiements, puis cliquer sur le moyen de paiement Ligne de crédit. L’URL comprend alors un paramètre de paiement comme suit :

payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=

2. Enregistrez l’ID de ce moyen de paiement pour une utilisation ultérieure.

Créer un nouveau compte publicitaire avec la source d’approvisionnement par défaut

curl \
  -F 'name=Advertisers Ad Account' \
  -F 'currency=USD' \
  -F 'timezone_id=1' \
  -F 'end_advertiser=<PAGE_ID>' \
  -F 'media_agency=NONE' \
  -F 'partner=NONE' \
  -F 'funding_id=<PAYMENT_METHOD_ID(from above)>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/CHILD_BM_ID/adaccount

Ajouter l’utilisateur·ice système en tant qu’admin du nouveau compte publicitaire

Ajoutez l’utilisateur·ice système en tant qu’admin du nouveau compte publicitaire dans le Business Manager enfant.

curl \
  -F 'user=<SYSTEM_USER_ID(from above)>' \
  -F 'tasks=MANAGE,ADVERTISE,ANALYZE' \
  -F 'business=<CHILD_BM_ID>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<act_ACCOUNT_ID>/assigned_users

Félicitations ! Ceci était la dernière étape de la configuration du Business Manager enfant qui vous permettra de créer et de gérer des campagnes pour votre client ou votre cliente.

Retrouver les Business Manager enfants

Pour obtenir les ID de tous les Business Manager enfants, exécutez la commande suivante afin de filtrer les résultats par ID d’utilisateur·ice spécifique à l’application du client ou de la cliente.

curl -i -X GET \
  -F 'access_token=<PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
"https://graph.facebook.com/<API_VERSION>/<parent_bm_id>/owned_businesses?client_user_id=<Client’s app scoped user ID>

Étapes suivantes

Dans les prochaines rubriques, nous parlerons des autres fonctionnalités et actions disponibles pour améliorer votre expérience Business Manager.

Consultez également les guides de partage d’éléments pour apprendre à accéder aux éléments de clients ou clientes associé·es à des Business Manager enfants :

• Fonctions B2B
• Partage de pixel avec une entreprise