Primi passi

Per utilizzare Business Manager, un'azienda ha bisogno di almeno una Pagina, un amministratore, un nome attività e un indirizzo e-mail valido.

Il nome attività viene utilizzato solo per la tua azienda e per qualsiasi altra azienda con cui scegli di condividere oggetti. Dopo aver creato questa azienda, puoi aggiungere Pagine, account pubblicitari, app, oggetti di monitoraggio delle conversioni fuori dal sito e altre risorse correlate alle inserzioni che appartengono all'azienda.

Requisiti

• Per utilizzare l'API Business Manager, la tua app deve disporre del livello di accesso all'API Marketing appropriato. In alcuni casi la tua app potrebbe aver bisogno dell'accesso avanzato. Scopri di più sui vari livelli di accesso.
• La tua app ha inoltre bisogno dell'autorizzazione business_management.

Crea un nuovo Business Manager

Crea un nuovo Business Manager che rappresenti la tua azienda. Crea un nuovo Business Manager solo se stai configurando un nuovo Business Manager per te o per i tuoi clienti. Se hai bisogno di un altro account pubblicitario o di accesso a un'altra Pagina, dovresti utilizzare il Business Manager e le autorizzazioni alle risorse esistenti. Eliminare un Business Manager non è consentito.

Ad esempio, crea un nuovo Business Manager con un POST:

curl \
  -F "name=Pomni Media" \
  -F "vertical=ADVERTISING" \
  -F "primary_page=<PAGE_ID>" \
  -F "timezone_id=1" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<USER_ID>/businesses"

Requisiti

Per creare un Business Manager, hai bisogno degli elementi seguenti:

• Un token d'accesso
• Un ID della Pagina
• Un settore
• Un ID utente per singola app

L'ID della Pagina fornito deve essere quello della Pagina principale della tua azienda. Questa Pagina si rappresenta pubblicamente la tua azienda su Facebook. Chiunque crei il Business Manager è un gestore di questa Pagina. Se non hai una Pagina che rappresenti la tua azienda su Facebook, creane una.

Il settore è una di queste costanti di stringa:

ADVERTISING , AUTOMOTIVE , CONSUMER_PACKAGED_GOODS , ECOMMERCE , EDUCATION , ENERGY_AND_UTILITIES , ENTERTAINMENT_AND_MEDIA , FINANCIAL_SERVICES , GAMING , GOVERNMENT_AND_POLITICS ,MARKETING , ORGANIZATIONS_AND_ASSOCIATIONS , PROFESSIONAL_SERVICES , RETAIL , TECHNOLOGY , TELECOM , TRAVEL , OTHER

Per visualizzare le proprietà di un'azienda, utilizza il suo ID:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>?access_token=<ACCESS_TOKEN>"

Puoi anche visualizzare un elenco dei Business Manager a cui hai accesso:

curl "https://graph.facebook.com/<API_VERSION>/me/businesses?access_token=<ACCESS_TOKEN>"

I campi di risposta includono:

Aggiornare i Business Manager

Aggiorna i campi nel Business Manager effettuando una richiesta POST a https://graph.facebook.com/{API_VERSION}/{BUSINESS_ID}. Ad esempio, per modifica il nome del Business Manager:

curl \
-F "name=My Actual Business Name" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Per modificare il settore aziendale, effettua la seguente richiesta POST:

curl \
-F "vertical=RETAIL" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Hai le seguenti opzioni:

Puoi aggiornare la Pagina principale effettuando la richiesta POST seguente. La Pagina principale deve essere di proprietà del Business Manager.

curl \
  -F "primary_page=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Puoi inoltre aggiornare tutti gli elementi sopra in un'unica richiesta POST:

curl \
  -F "name=My Actual Business Name" \
  -F "vertical=RETAIL" \
  -F "primary_page=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Gestire persone e ruoli

Ci sono due tipi di ruoli in Business Manager:

Per ulteriori informazioni sui ruoli, consulta Configurare i ruoli del catalogo in Business Manager.

Inizialmente il creatore del Business Manager è l'unico utente al suo interno ed è un amministratore.

Invitare persone

Per aggiungere i colleghi al Business Manager, è necessario invitarli. Per invitare una persona, indica un indirizzo e-mail valido a cui ha accesso. L'invio di richieste per aggiungere dipendenti a un Business Manager è limitato. Raggiunto questo limite, riceverai il codice di errore 17 e potrai riprendere dopo 24 ore.

Per invitare una persona come amministratore, invia una richiesta POST:

curl \
-F "email=some@email.com" \
-F "role=ADMIN" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users"

Per invitare una persona come dipendente, invia una richiesta POST:

curl \
-F "email=some@email.com" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users"

Facebook invia un'email di invito all'indirizzo e-mail di lavoro specificato. La persona invitata deve controllare la posta elettronica e seguire la procedura di iscrizione. Una volta terminata la procedura, la persona sarà visibile nell'elenco degli utenti.

Persone in Business Manager

A partire dalla v2.11 abbiamo endpoint separati per ottenere gli utenti in base al loro stato. Effettua una richiesta GET per recuperare ogni gruppo di utenti. Per ottenere tutti gli utenti del Business Manager (tieni presente che è richiesto l'accesso avanzato):

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users?access_token=<ACCESS_TOKEN>"

Per ottenere gli utenti del sistema, con accesso a livello di sistema:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>"

Per ottenere gli utenti in sospeso che sono stati inviati ad accedere al Business Manager, ma non hanno ancora accettato:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_users?access_token=<ACCESS_TOKEN>"

Gli endpoint restituiscono gli utenti attivi, in sospeso o del sistema relativi al tuo Business Manager. Ad esempio:

{
  "data": [
    {
      "id": "<BUSINESS_ID>",
      "name": "Alpha MK",
      "email": "some@email.com",
      "role": "EMPLOYEE",
    }
  ]
}

I risultati per gli utenti in sospeso sono simili a questi:

{
  "data": [
    {
      "id": "<BUSINESS_ID>",
      "email": "some@email.com",
      "role": "EMPLOYEE",
      "status": "PENDING",
      "owner": {
        "id": "USER_ID",
        "name": "Generic Emporium"
      }
    }
  ]
}

Le definizioni per i campi restituiti sono le seguenti:

Cambiare i ruoli

Per modificare il ruolo di un utente attivo nel tuo Business Manager, fornisci l'ID dell'utente. Ad esempio, puoi trasformare un utente con ruolo Employee in un Admin con questa richiesta POST:

curl \
  -F "role=ADMIN" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"

Per passare un utente dal ruolo Admin al ruolo Employee, invia una richiesta POST:

curl \
  -F "role=EMPLOYEE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"

Per modificare il ruolo di un utente in sospeso, invia questa richiesta POST:

curl \
  -F "role=EMPLOYEE" \
    -F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<PENDING_USER_ID>"

Eliminare utenti

Rimuovi le autorizzazioni concesse a una persona in base all'appartenenza ai tuoi Business Manager. Limita l'accesso ad account pubblicitari e Pagine. Se l'utente ha accesso ad account pubblicitari o Pagine esterne al tuo Business Manager, tali autorizzazioni non subiscono modifiche. Ad esempio, qualcuno potrebbe aver aggiunto se stesso o avere accesso attraverso un altro Business Manager.

Per rimuovere un utente attivo dal tuo Business Manager, effettua una chiamata DELETE:

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

Per annullare un utente in sospeso con una richiesta DELETE:

curl \
  -X DELETE \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<PENDING_USER_ID>"

Questa operazione rimuove gli utenti dal tuo Business Manager ed elimina l'accesso alle sue risorse.

Ottenere oggetti di connessione

Gli oggetti di connessione sono gli oggetti Facebook (ad esempio Pagine, app ecc.) che un amministratore gestisce. Un amministratore può essere un utente o un Business Manager, oppure, nel caso delle app, uno sviluppatore o un inserzionista. I tipi di oggetti di connessione sono i seguenti:

• Pagine e luoghi
• Eventi
• App
• Domini

Vedi delle query di esempio e scopri di più sugli oggetti di connessione.

Fatture

L'API Business Manager ti consente di visualizzare e gestire le fonti di credito associate a un Business Manager. L'API recupera tutte le fatture visibili a un Business Manager. Ciò significa che tramite l'API sono visibili tutte le fatture di cui è responsabile questo Business Manager, non solo quelle appartenenti a un singolo ID business.

Linea di credito normale gestita dal Business Manager

Per i partner dell'API Marketing che hanno abilitato la fatturazione, puoi approfittare della linea di credito normale gestita dal Business Manager.

I Facebook Marketing Partner (FBMP) devono contattare il loro rappresentante commerciale per configurare il loro Business Manager per il credito. Assicurati di chiedere la Linea di credito normale gestita dal Business Manager. Una volta configurata, puoi iniziare a creare account pubblicitari utilizzando l'apposita API. Gli addebiti verranno effettuati sulla linea di credito del Business Manager.

Per gli account pubblicitari creati tramite la seguente API, distribuiremo dinamicamente il credito tra gli account e aggiorneremo i limiti di credito e la spesa per evitare di raggiungere i limiti di credito. Potrai anche vedere un riepilogo del credito disponibile e l'importo del credito su ogni account pubblicitario.

Oggi supportiamo solo la responsabilità normale, la responsabilità sequenziale non è supportata. La procedura di configurazione rimarrà invariata.

Fatturazione fine mese

Una volta configurata la linea di credito per un Business Manager, che la utilizza per pubblicare inserzioni, alla fine di ogni mese generiamo una fattura relativa all'account. Per visualizzare le fatture del Business Manager, devi avere il ruolo Finance. Per gli amministratori e i dipendenti normali di un Business Manager, puoi assegnare le autorizzazioni in People nel Business Manager. Puoi anche assegnare autorizzazioni finanziarie a utenti di sistema usando il Business Manager.

Per recuperare le fatture relative all'account di un Business Manager utilizzando l'API, invia una richiesta GET:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_invoices?start_date=2017-01-01&end_date=2017-04-01"

Ecco un esempio dei risultati:

{
  "business_invoices": {
    "data": [
      {
        "id": "1659175694099710",
        "billing_period": "2017-03-01"
      },
      {
        "id": "1303851778395619",
        "billing_period": "2017-01-01"
      },
      {
        "id": "1415846861611329",
        "billing_period": "2017-02-01"
      }
    ],
    "paging": {
      "cursors": {
        "before": "MAZDZD",
        "after": "MgZDZD"
      }
    }
  },
  "id": "249554531892085"
}

Puoi ottenere i dettagli della fattura a livello di campagna con questa richiesta:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_invoices?fields=billed_amount_details,billing_period,entity,id,invoice_id,payment_term,type,campaigns&start_date=2019-06-01&end_date=2019-07-01"

La risposta è simile a questa:

{
  "business_invoices": {
    "data": [
      {
        "billed_amount_details": {
          "currency": "USD",
          "net_amount": "387.70",
          "tax_amount": "0.00",
          "total_amount": "387.70"
        },
        "billing_period": "2017-03-01",
        "entity": "FBUS",
        "id": "1659175694099710",
        "invoice_id": "22736800",
        "liability_type": "Normal",
        "invoice_type": "Invoice",
        "payment_term": "CUSTOMER",
        "type": "Invoice",
        "campaigns": {
          "data": [
            {
              "campaign_id": "6056967798500",
              "campaign_name": "Nhận ưu đãi",
              "tags": [
                "hello2"
              ],
              "billed_amount_details": {
                "currency": "USD",
                "net_amount": "207.62",
                "tax_amount": "0.00",
                "total_amount": "207.62"
              }
            },
            {
              "campaign_id": "6056958052500",
              "campaign_name": "Nhận ưu đãi",
              "billed_amount_details": {
                "currency": "USD",
                "net_amount": "180.08",
                "tax_amount": "0.00",
                "total_amount": "180.08"
              }
              "impressions": 100,
              "clicks": 50,
              "conversions": 30
            }
          ]
        }
      },
      {
        "billed_amount_details": {
          "currency": "USD",
          "net_amount": "382.99",
          "tax_amount": "0.00",
          "total_amount": "382.99"
        },
        ......
    "paging": {
      "cursors": {
        "before": "MAZDZD",
        "after": "MgZDZD"
      }
    }
  },
  "id": "1515766328651000"
}

Puoi anche recuperare campi aggiuntivi della fattura:

• invoice_date: data di generazione della fattura da parte di Facebook
• due_date: data di scadenza della fattura
• payment_status: mostra se la fattura è Paid, Unpaid o Partially Paid
• amount_due: l'importo attualmente dovuto e non ancora pagato
• download_uri: questo URI consente di scaricare la fattura in formato PDF

API Funding Source

Per recuperare la fonte di finanziamento del credito esteso associata a un Business Manager, invia questa richiesta GET.

curl "https://www.graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/extendedcredits"

Per configurare una fonte di finanziamento per un'azienda, vai alla relativa sezione nelle impostazioni del Business Manager.

Assegnazione di credito dinamica

L'assegnazione di credito dinamica, nota anche come DCAF, è il nostro sistema di assegnazione di credito che prevede l'aggiustamento periodico del credito disponibile sulla base del singolo account pubblicitario. Il nostro script automatizzato viene eseguito all'incirca ogni 30 minuti e distribuisce in modo uniforme il tuo credito disponibile tra tutti i tuoi account attivi abilitati per DCAF. Il credito disponibile include il credito totale approvato meno l'importo insoluto totale. In questo modo è più facile gestire la spesa al livello di account pubblicitario e distribuire i fondi a ogni account.

Un Business Manager può anche "disattivare" un account pubblicitario oggetto di fatturazione e rimuoverlo dalla lista degli account a cui deve essere assegnato credito. I Business Manager non hanno più bisogno che sia Facebook a gestire questo stato.