Business Management APIs

Configurazione di un nuovo Business Manager secondario

La soluzione Business Manager a 2 livelli è stata inizialmente progettata in modo che ogni token d'accesso utente potesse creare un solo Business Manager secondario. Tuttavia, ora l'utente può creare più Business Manager secondari purché una pagina primaria sia impostata su ogni Business Manager secondario.

Nota: a seconda che appsecret_proof sia o meno abilitato nelle impostazioni dell'app, appsecre_proof potrebbe essere richiesto come parametro per ogni chiamata effettuata. Consulta il documento Protezione delle richieste API Graph per scoprire come impostare questa opzione e come generare appsecret_proof.

Primi passi

Prima di iniziare, ti consigliamo di esaminare questi requisiti e queste informazioni:

Autorizzazioni dell'app

  • business_management
  • ads_management

ID

  • PARTNER_BM_ID: ID del Business Manager del partner che possiede l'app.
  • BUSINESS_MANAGER_IDS: ID del Business Manager che il Business Manager principale crea per il cliente.

Token d'accesso

  • USER_Personal_Access_Token: il token d'accesso della persona che fornisce le credenziali per creare il Business Manager secondario.
    • Questo token è generato tramite Facebook Login.
    • Il partner deve richiedere ambiti di applicazione business_management globali per i Business Manager e le Pagine dell'utente e non ambiti di applicazione granulari.
    • Questa persona deve avere i privilegi di amministratore sulla Pagina che viene condivisa nel Business Manager secondario.
    • Se la Pagina è di proprietà di un altro Business Manager, questa persona deve avere i privilegi di amministratore sul Business Manager che possiede la Pagina.
    • Questo token è usato per autorizzare la creazione del Business Manager secondario e per condividere la Pagina nel Business Manager secondario per la pubblicità.
  • PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN: il token d'accesso dell'utente di sistema con diritti di amministratore nel Business Manager principale.
    • Questo token è usato per creare e gestire Business Manager secondari.
  • CHILD_BM_SYSTEM_USER_ACCESS_TOKEN: il token d'accesso dell'utente del sistema con diritti di amministratore creato nel Business Manager secondario.
    • Questo token è usato per creare e gestire campagne e altre attività nel Business Manager secondario.

Creare un Business Manager secondario

Usando USER_Personal_Access_Token, crea un Business Manager secondario.

Esempio: restituisce l'ID di un Business Manager secondario

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

Risposta:

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

Creazione di più Business Manager secondari per utente

Se l'utente vuole creare più Business Manager secondari usando le stesse credenziali utente, la primary_page deve essere impostata sui Business Manager secondari esistenti creati per quell'utente. Fai un'altra chiamata POST per impostare la primary_page del Business Manager secondario esistente:

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>

Quando crei un altro Business Manager secondario:

  • Tutti i Business Manager secondari esistenti devono avere una primary_page univoca.
  • Lo shared_page_id deve essere impostato sul nuovo Business Manager secondario.
  • Se lo shared_page_id viene usato per creare un nuovo Business Manager secondario, non può essere una primary_page su nessuno dei Business Manager secondari esistenti.

Configurazione del metodo di pagamento

Per pagare le pubblicità del Business Manager secondario, dovrai condividere la tua linea di credito con ciascun Business Manager secondario.


Passaggio 1. Apri una linea di credito. Contatta il tuo rappresentante di Facebook e apri una linea di credito (LOC) all'interno di questo Business Manager, se non ne esiste già una. La linea di credito verrà visualizzata come metodo di pagamento nel Business Manager principale.

Passaggio 2. Accetta le Note legali della linea di credito.

  1. Apri Business Manager > Impostazioni business > Metodi di pagamento.
  2. Clicca su Impostazioni della linea di credito e clicca su Note legali. Accetta le note legali.

Passaggio 3. Recupera l'ID della linea di credito e condividilo con il Business Manager secondario

  1. Vai al Business Manager principali e su Impostazioni business > Metodi di pagamento, clicca sul Metodo di pagamento. Memorizza il PARENT_BM_Line_Of_Credit_ID dall'URL. L'URL assomiglia a questo: 
    https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>
  2. Usa questo ID della linea di credito del Business Manager principale nella chiamata API qui sotto per condividere l'ID della linea di credito dal Business Manager principale al secondario. amount è facoltativo. 
    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

Se non specifichi un importo, la tua linea di credito è equamente suddivisa tra i Business Manager secondari.

Se specifichi solo un importo, quella parte della tua linea di credito è assegnata al Business Manager secondario.


Ottenimento del token dell'utente di sistema secondario

Nel Business Manager secondario, usa questa chiamata API per creare un utente di sistema e recuperare il relativo token d'accesso. Questo token viene usato per tutte le chiamate successive al Business Manager secondario per creare o gestire inserzioni per questo utente.

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

Recupero dell'ID dell'utente di sistema

Una volta ottenuto il token d'accesso, puoi usarlo per ricavare l'ID utente per singola app, che è importante conservare per lo storage in un secondo momento.

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

Recupero dell'ID della fonte di finanziamento (LOC)

  1. Recupera la nuova fonte di finanziamento nel Business Manager secondario. Per questo esempio, usa questa fonte di finanziamento più tardi quando crei un account pubblicitario.
    2. 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
    In alternativa, puoi recuperare la fonte di finanziamento accedendo al tuo Business Manager secondario: seleziona Pagamenti e quindi clicca sul metodo Pagamento con linea di credito. Questa operazione popola l'URL con un parametro di pagamento come segue: 
    payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=
  2. Memorizza questo ID del metodo di pagamento per un utilizzo successivo.

Creazione di un nuovo account pubblicitario con la fonte di finanziamento predefinita

Usa l'ID del metodo di pagamento del Business Manager secondario come parametro funding_id.

funding_id non può essere aggiornato dopo la creazione dell'account pubblicitario.

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

Aggiunta dell'utente di sistema come amministratore al nuovo account pubblicitario

Aggiungi l'utente di sistema come amministratore al nuovo account pubblicitario sotto il Business Manager secondario:

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

Congratulazioni! Questo è l'ultimo passaggio della configurazione di un Business Manager secondario per creare e gestire le campagne dei tuoi clienti.

Individuazione di Business Manager secondari

Per trovare tutti gli ID dei Business Manager secondari, esegui il seguente comando per filtrare in base all'ID utente per singola app del 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>

Trova l'ID utente per singola app con /me?fields=ids_for_apps (token d'accesso dell'utente del cliente).

Passaggi successivi

Gli argomenti successivi includono funzioni/azioni aggiuntive che puoi usare per aumentare la tua esperienza con il Business Manager.

Inoltre, fai riferimento alle guide per la condivisione delle risorse per accedere alle risorse dei clienti nei Business Manager secondari: