Account pubblicitari

Come amministratore strumenti business, puoi richiedere account pubblicitari che appartengono a un Business Manager. In questo modo, puoi assegnare con facilità le persone agli account pubblicitari a cui devono accedere. Successivamente, puoi anche assegnare fonti di finanziamento condivise ai tuoi account pubblicitari.

Richiedere gli account

Se gestisci account pubblicitari al di fuori di un Business Manager con il ruolo di amministratore, puoi richiederli per il tuo Business Manager. Devi eseguire questa procedura una sola volta. Una volta richiesti, puoi gestire tali account pubblicitari solamente in quel Business Manager.

Non è possibile richiedere account delle creatività.

Per richiedere un account pubblicitario per il tuo Business Manager, devi fornire l'ID account pubblicitario nel formato act_###. Invia una richiesta POST: il richiedente deve essere un amministratore del Business Manager che richiede l'account pubblicitario

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

Se sei un amministratore dell'account pubblicitario, approviamo immediatamente questa richiesta. Facebook restituisce il parametro access_status impostato su CONFIRMED.

Se sei un utente che non dispone delle autorizzazioni appropriate per l'account pubblicitario, inviamo una richiesta di proprietà agli amministratori dell'account pubblicitario. Una volta inviata la richiesta, la risposta contiene il parametro access_status impostato su PENDING.

Per accettare una richiesta per il reclamo della proprietà, devi essere un amministratore dell'account pubblicitario e devi accedere e accettare la richiesta in Gestione inserzioni.

Richiedere l'accesso agli account

La maggior parte delle società di marketing non avrà bisogno di richiedere gli account pubblicitari dai propri clienti. Consulta Funzioni business-to-business per richiedere l'accesso a risorse di proprietà di altri Business Manager.

Creare account pubblicitari

Per usare questa API, devi aver configurato un Business Manager e una Pagina validi. Se hai account pubblicitari o pagine incompleti non pubblicati da Facebook, non potrai creare un nuovo account pubblicitario.

La creazione di account pubblicitari tramite API è limitata a 5 account pubblicitari. Se intendi creare più di 5 account pubblicitari, dovrai farlo manualmente.

I campi disponibili sono:

Per creare un nuovo account pubblicitario per un Business Manager, specifica name, currency, timezone_id, end_advertiser, media_agency e partner. Vedi le condizioni seguenti:

• media_agency e partner devono essere un alias di Pagina Facebook, un ID Pagina Facebook o un ID app Facebook.
• end_advertiser deve essere un ID business.

Se il tuo account pubblicitario non ha un inserzionista, un'agenzia media o un partner, specifica NONE. Se il tuo account pubblicitario ha un inserzionista, un'agenzia media o un partner che non è presente su Facebook con una Pagina o un'app, specifica UNFOUND.

Per creare un account pubblicitario:

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"

Se hai già una linea di credito estesa con Facebook, puoi impostare invoice su true. Successivamente, assoceremo il tuo nuovo account pubblicitario alla tua linea di credito estesa.

La risposta si presenta così:

{
  "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"
}

Visualizzare gli account di proprietà

Visualizza tutti gli account pubblicitari a cui il tuo Business Manager ha accesso con una chiamata GET:

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

In questo modo, ottieni tutti gli account pubblicitari di proprietà di un Business Manager. Alcuni campi sono specifici della relazione tra Business Manager e account pubblicitario.

• permitted_tasks è un array delle attività che puoi assegnare per tale account pubblicitario.
• access_type indica se il tuo Business Manager opera come OWNER o AGENCY dell'account pubblicitario.

Per visualizzare gli account pubblicitari con accesso ancora in sospeso, puoi effettuare questa chiamata GET:

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

Rimuovere account

Non puoi rimuovere gli account pubblicitari dal tuo Business Manager se sei OWNER e se gli account sono CONFIRMED. Se la richiesta di accesso è PENDING o hai accesso come AGENCY all'account pubblicitario, puoi effettuare questa richiesta DELETE:

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"

Visualizzare l'accesso agli account

Visualizza gli account pubblicitari per i quali un dato utente ha l'autorizzazione con questa chiamata GET:

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

Per visualizzare le autorizzazioni di cui qualcuno dispone per un account pubblicitario, effettua questa chiamata GET:

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

Aggiungere persone agli account

Una volta associato il tuo Business Manager a un account pubblicitario, potrai assegnare attività ad altri utenti business. Le attività possibili includono:

Hai bisogno di:

• adaccount_id: ID account pubblicitario, nella forma act_123
• user_id: ID utente da aggiungere
• Attività da assegnare

Per aggiungere un nuovo utente con le attività ['MANAGE', 'ADVERTISE', 'ANALYZE'], effettua questa chiamata POST:

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"

Modificare le autorizzazioni negli account

Per modificare le attività di un utente esistente, usa la stessa chiamata POST usata per aggiungere un nuovo utente:

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"

Rimuovere persone dagli account pubblicitari

Elementi necessari per rimuovere un utente da un account:

• adaccount_id: ID account pubblicitario, nella forma act_123
• user_id: ID utente da rimuovere

La chiamata DELETE è:

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"