Condivisione del pixel di Meta tra aziende
Potrebbero esserci più casi d'uso che richiedono alle aziende di accedere a un dataset del pixel di un Business Manager in un altro Business Manager (di solito un'agenzia), ad esempio per gestire le inserzioni, analizzare le prestazioni o caricare gli eventi.
Di seguito sono riportate le integrazioni API necessarie per stabilire una relazione tra il pixel e il Business Manager dell'agenzia. Se il Business Manager destinatario (agenzia) gestisce anche le inserzioni per il cliente e deve usare il pixel per gli account pubblicitari, vedi il passaggio 3.
Prerequisiti: requisiti per l'app
Le app devono avere la funzione Accesso standard a Gestione inserzioni (accesso avanzato). Inoltre, le app devono avere le autorizzazioni seguenti:
business_managementads_managementoads_reademanage_pages
Passaggio 1: avviare la condivisione del pixel con l'agenzia
Per questa operazione, è necessario un token d'accesso utente con le autorizzazioni dell'app precedenti da un amministratore strumenti business che possiede il pixel.
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
Le opzioni e i parametri per questa richiesta includono:
| Nome | Descrizione |
|---|---|
tipo: numerico | Obbligatorio. L'ID business dell'agenzia che riceve l'accesso al pixel |
tipo: list:string | Obbligatorio. Esempio: ['ANALYZE', 'UPLOAD', 'ADVERTISE'] Attività consentite all'agenzia sul pixel Valori possibili: ANALYZE: visualizzare, analizzare e pubblicizzare. UPLOAD: caricare i dati sulle conversioni sul sito web in questo dataset. ADVERTISE: collegare gli account pubblicitari a questo dataset di Facebook. Usare questo dataset per la pubblicità. EDIT: gestire dataset, modificare le impostazioni, analizzare e pubblicizzare. (L'accesso a EDIT è attualmente limitato, contatta il tuo rappresentante di Meta per autorizzare la tua app) |
Gestiamo le richieste in base allo stato della relazione con l'altro Business Manager:
- Azienda che hanno una relazione approvata esistente. Condividiamo il pixel direttamente con loro.
- Aziende che hanno una relazione in corso esistente. Aggiungiamo il pixel alla richiesta in modo che, quando il Business Manager destinatario approva la richiesta, viene eseguita la condivisione del pixel.
- Aziende che non hanno alcuna relazione. Creiamo un accordo di condivisione a cui alleghiamo il pixel in modo che, quando il Business Manager destinatario approva la richiesta, il pixel viene condiviso.
Se il pixel viene condiviso correttamente con il Business Manager, viene restituita la seguente risposta:
{
success: true,
}
Se la richiesta è in attesa di accettazione dell'accordo di condivisione, la richiesta API restituisce la seguente risposta con pending_request_id. Quando il Business Manager destinatario accetta la richiesta, il pixel viene condiviso automaticamente. Vedi il passaggio 2 per accettare/rifiutare la richiesta.
{
"success": true,
"pending_request_id": "{request_id}"
}
C'è un limite al numero di Business Manager con cui è possibile condividere un pixel.
Passaggio 2: accettazione di una richiesta in sospeso (se necessario)
Dopo aver avviato la richiesta di condivisione del pixel, il Business Manager dell'agenzia potrebbe ricevere una richiesta di accordo di condivisione in sospeso se non ha già una relazione con il Business Manager che possiede il pixel. Gli amministratori strumenti business destinatari possono vedere e accettare la richiesta sul proprio Business Manager.
Per approvare o rifiutare la richiesta di conferma della relazione usando l'API, ottieni il request_id dalla risposta di errore nel passaggio 1.
L'API richiede un token d'accesso utente dall'amministratore strumenti business destinatario con business_mangement o ads_management permission per l'app.
POST <request_id>?request_status="approve"
In caso di azione eseguita correttamente, l'API restituisce questa risposta:
{
success: bool
}
Le opzioni e i parametri per questa richiesta includono:
| Nome | Descrizione |
|---|---|
tipo: stringa | Obbligatorio. Se il Business Manager che riceve una richiesta di condivisione del pixel approva o rifiuta la richiesta. Valori possibili: |
Passaggio 3: condivisione del pixel con gli account pubblicitari del Business Manager dell'agenzia
Se un'agenzia gestisce le inserzioni per un cliente e deve consentire agli account pubblicitari dedicati del cliente di usare il dataset del pixel, usa questa API.
Quando il pixel è condiviso in un Business Manager con le autorizzazioni Advertise/Analyze, il Business Manager può consentire agli account pubblicitari al suo interno di usare il dataset del pixel per la pubblicità.
L'API richiede un token d'accesso utente con le autorizzazioni business_management, ads_management o ads_read dall'amministratore strumenti business.
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
| Nome | Descrizione |
|---|---|
tipo: numerico | Obbligatorio. Business Manager che gestisce le inserzioni e ha accesso al pixel e agli account pubblicitari. L'utente il cui token d'accesso è stato usato deve disporre delle autorizzazioni di amministratore su questo Business Manager. |
tipo: numerico | Obbligatorio. Account pubblicitario da consentire sul pixel. |
Passaggio 4: eliminazione della connessione di condivisione del pixel
Se la connessione tra il pixel e il Business Manager dell'agenzia non è più necessaria, usa la seguente API per eliminarla.
Delete <adspixel>/agencies?business=<agency_business_id>
L'API richiede un token d'accesso utente amministratore dal Business Manager che possiede il pixel.
In caso di azione eseguita correttamente, l'API restituisce questa risposta:
{
success: true
}