Panoramica sulla gestione delle risorse

Un Business Manager può accedere a più risorse. Il tuo Business Manager possiede le risorse oppure vi accede come agenzia. Utilizza le API Business Management Asset di Facebook per aggiungere, rimuovere o interrogare la relazione tra un Business Manager e le sue risorse, gestire le risorse di Business Manager e accedervi.

Agenzia si riferisce a un tipo di entità business che può gestire risorse di proprietà di un'altra azienda o accedervi. Questa relazione consente all'agenzia di svolgere compiti o azioni specifiche per conto del cliente, come la gestione di account pubblicitari, pagine o altre risorse digitali.

Gruppi di risorse business

I gruppi di risorse business aiutano grandi inserzionisti o agenzie a gestire in modo efficiente gli utenti e le risorse del loro Business Manager. Dovresti organizzare risorse e utenti in modo che siano mappati rispetto alle operazioni reali. Ad esempio, un Business Manager può strutturare le proprie risorse e gli utenti in base a brand, area geografica, cliente o a un principio organizzativo di sua scelta.

I gruppi di risorse business possono contenere account pubblicitari, Pagine, pixel di Facebook, insiemi di eventi offline, app, cataloghi, conversioni personalizzate e account Instagram. Le risorse possono essere di proprietà di un Business Manager o condivise per fornire l'accesso a un'agenzia.

Puoi usare questa API aggiungere utenti a un gruppo di risorse business. Dopo averli aggiunti, puoi concedere alle persone le autorizzazioni per le risorse di un gruppo di risorse business. Questo ti consente di concedere l'accesso a più risorse contemporaneamente, senza creare troppi amministratori a livello di Business Manager.

Con questa API, puoi gestire i gruppi di risorse business che qualcuno ha già creato tramite Business Manager oppure puoi amministrare risorse all'interno del gruppo di risorse business. In questo modo, potrai:

  • Ottenere una lista dei gruppi di risorse business associati a un Business Manager
  • Eliminare o rinominare un gruppo di risorse business
  • Visualizzare tutte le risorse in un gruppo di risorse business
  • Ottenere, aggiungere, modificare ed eliminare le autorizzazioni utente per le risorse in un gruppo di risorse business
  • Assegnare utenti a un gruppo di risorse business
  • Ottenere, aggiungere ed eliminare risorse da un gruppo di risorse business

Autorizzazioni

Per usare l'API Business Asset Groups, la tua app ha bisogno del livello di accesso all'API Marketing appropriato:

  • Per tutte le operazioni di aggiunta e rimozione degli endpoint: l'utente del token d'accesso deve essere un amministratore del Business Manager. Altrimenti, l'accesso sarà negato.
  • Per tutti gli endpoint API, la tua app necessita dell'autorizzazione business_management.

Hai bisogno di autorizzazioni aggiuntive per:

Endpoint del gruppo di risorse business Autorizzazioni richieste

Ottenere la lista degli account pubblicitari

ads_management

Ottenere la lista dei cataloghi prodotti, aggiungere o rimuovere un catalogo prodotti

ads_management

Ottenere una lista degli account Instagram, aggiungere o rimuovere un account Instagram

ads_management. Se usi l'API Marketing v4.0, hai anche bisogno di instagram_basic.

Ottenere la lista dei pixel

ads_read

Ottenere la lista degli insiemi di eventi offline

ads_management

Ottenere la lista delle conversioni personalizzate

ads_read

Aggiungere una conversione personalizzata

ads_management

Limitazioni

Ricevi un errore se provi a ridurre o rimuovere le autorizzazioni per una risorsa contenuta in un gruppo di risorse business tramite le seguenti chiamate API:

Per ridurre o rimuovere le autorizzazioni, segui questi passaggi:

  1. Fai una chiamata per ottenere una lista dei gruppi di risorse associati a un Business Manager. Cerca gruppi di risorse in cui contained_asset_id è uguale a {page_id} o {ad_account_id}.
  2. Per ogni ID del gruppo di risorse business restituito, effettua una chiamata API per rimuovere un utente da quel gruppo.
  3. Quindi, chiama le richieste DELETE o POST per rimuovere l'autorizzazione per quell'utente sulla Pagina o sull'account pubblicitario.

Se fornisci funzioni di gestione delle autorizzazioni nella tua app per altri Business Manager, devi usare questa API per evitare incongruenze ed errori tra l'API e il Business Manager.

Non puoi impostare le autorizzazioni su app, cataloghi, account Instagram e conversioni personalizzate tramite il gruppo di risorse business. Devi invece assegnare le autorizzazioni a livello di risorsa.

Ad esempio, se aggiungi Roger a un gruppo di risorse business nel Business Manager di Jasper, Roger può ottenere le autorizzazioni per qualsiasi Pagina, account pubblicitario, pixel e così via, in quel gruppo di risorse business. Tuttavia, per rimuovere o modificare le autorizzazioni di Roger su qualsiasi risorsa nel gruppo di risorse business di Jasper, devi eseguire questa azione nel gruppo di risorse business stesso.

Puoi aggiungere le autorizzazioni utente a livello di risorsa usando l'API delle risorse, ad esempio per modificare il ruolo di un utente da moderatore ad amministratore della Pagina. Vedi degli esempi per Pagina e account pubblicitario.

I gruppi di risorse business hanno sostituito l'API Projects il 13 ottobre 2019. Devi migrare tutte le app sull'API Projects ai gruppi di risorse business.

Ruoli consentiti

Quando un utente viene aggiunto a un Business Manager, può essere assegnato uno dei seguenti due ruoli tramite le API Business Users:

Costante API Nome Descrizione

ADMIN

Amministratore strumenti business

Può gestire tutti gli aspetti delle impostazioni del Business Manager, comprese la modifica o l'eliminazione dell'account e l'aggiunta o la rimozione di utenti.

EMPLOYEE

Dipendente su Business Manager

Può visualizzare tutte le informazioni nelle impostazioni del Business Manager, ma non può apportare modifiche, tranne aggiungere al Business Manager Pagine o account pubblicitari di cui l'utente è un amministratore.

Cataloghi

I seguenti ruoli possono essere assegnati a qualsiasi utente del Business Manager, amministratore o dipendente, sui cataloghi accessibili da questo Business Manager usando le API Catalog:

Costante APINomeDescrizione

['MANAGE', 'ADVERTISE']

Amministratore di catalogo

È in grado di gestire tutti gli aspetti del catalogo con accesso completo in lettura e scrittura, tra cui creazione/aggiornamento/eliminazione di articoli, gestione degli elenchi, collegamento del catalogo a pixel e app, creazione di insiemi di prodotti, pubblicazione di inserzioni del catalogo Advantage+ con il catalogo, modifica delle impostazioni del catalogo, ecc.

['ADVERTISE']

Inserzionista del catalogo

Può creare insiemi di prodotti e pubblicare inserzioni del catalogo Advantage+ con il catalogo. Non può modificare prodotti, elenchi o impostazioni del catalogo.

Account pubblicitari

Le seguenti attività possono essere assegnate a qualsiasi utente del Business Manager per gli account pubblicitari accessibili da questo Business Manager usando le API Ad Account:

Costante API Nome Descrizione

['MANAGE', 'ADVERTISE', 'ANALYZE']

Amministratore dell'account pubblicitario

Può gestire tutti gli aspetti di campagne, report, fatturazione e autorizzazioni per gli account e può impostare i limiti di spesa degli account pubblicitari. Gli amministratori degli account pubblicitari possono anche impostare i metodi di pagamento aziendali.

['ADVERTISE', 'ANALYZE']

Inserzionista sull'account pubblicitario

Può visualizzare e modificare le inserzioni e configurare le inserzioni usando il metodo di pagamento associato all'account pubblicitario.

['ANALYZE']

Analista dell'account pubblicitario

Può visualizzare le prestazioni delle inserzioni.

Pagine

Puoi assegnare le seguenti attività a qualsiasi utente di un Business Manager sulle Pagine accessibili a questo Business Manager usando le API Page:

Costante API Nome Descrizione

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

Amministratore della Pagina

Può gestire i ruoli nella Pagina, inviare messaggi e pubblicare contenuti a nome della Pagina, creare inserzioni e visualizzare gli insight.

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

Editor della Pagina

Può modificare la Pagina, inviare messaggi e pubblicare contenuti a nome della Pagina, creare inserzioni e visualizzare gli insight.

['MODERATE', 'ADVERTISE', 'ANALYZE']

Moderatore della Pagina

Può rispondere ai commenti sulla Pagina ed eliminarli, inviare messaggi a nome della Pagina, creare inserzioni e visualizzare gli insight. Non può pubblicare contenuti a nome della Pagina.

['ADVERTISE', 'ANALYZE']

Inserzionista della Pagina

Può creare inserzioni per la Pagina e visualizzare gli insight. Non può pubblicare contenuti a nome della Pagina.

['ANALYZE']

Analista della Pagina

Può visualizzare gli insight. Non può pubblicare contenuti a nome della Pagina.

App

Non ci sono API per la gestione delle attività o dei ruoli per le app in Business Manager.

Account Instagram

Non c'è alcuna gestione dei ruoli per gli account Instagram in Business Manager. Gli utenti con accesso ad account pubblicitari collegati ad account Instagram possono pubblicare inserzioni per tali account Instagram.