Inserzioni collaborative

Le inserzioni collaborative sono una soluzione basata sulle inserzioni del catalogo Advantage+. Consente agli inserzionisti del brand di collaborare in sicurezza con un rivenditore o un partner di marketing e di raggiungere obiettivi pubblicitari, ad esempio il prodotto target per le vendite utilizzando i contenuti forniti dal rivenditore.

Il rivenditore o il partner di marketing dovrebbe condividere un segmento del catalogo con l'inserzionista del brand con tutti i propri prodotti. Questo segmento è una parte del suo catalogo o un superinsieme di insiemi di prodotti. L'inserzionista del brand può quindi accettare questo segmento del catalogo e utilizzarlo per iniziare a pubblicare inserzioni del catalogo Advantage+. Gli inserzionisti del brand non possono modificare il segmento del catalogo, ma da esso possono creare i propri insiemi di prodotti.

Un inserzionista pubblica essenzialmente una campagna di inserzioni del catalogo Advantage+ per la vendita con un catalogo prodotti. Pertanto, può usare i report pubblicitari standard di Facebook, che ora includono metriche relative al segmento del catalogo.

Inoltre, puoi usare report a livello di prodotto e report a livello di rivenditore per mostrare all'inserzionista del brand solo gli acquisti del brand.

Passaggi di alto livello

Per rivenditori e partner di marketing:

Passaggio 1: registrazione nelle inserzioni collaborative
Passaggio 2: creazione del segmento del catalogo - Il segmento deve contenere prodotti appartenenti a uno dei potenziali brand partner.
Passaggio 3: condivisione del segmento del catalogo con il brand partner
(Solo per i partner di marketing) Passaggio 4: fornitura di strumenti di scoperta per i brand

Per i brand:

Passaggio 1: accettazione del segmento del catalogo
Passaggio 2: creazione di una campagna pubblicitaria con il segmento del catalogo
Passaggio 3: visualizzazione dei report - Visualizza report relativi ai prodotti nel segmento del catalogo.
Passaggio 4 facoltativo: debug - Usa strumenti per diagnosticare e risolvere problemi, consulta Inserzioni del catalogo Advantage+, strumenti di debug.

Passaggi per rivenditori e partner di marketing

Passaggio 1: registrazione nelle inserzioni collaborative

Per completare questo passaggio, la tua app ha bisogno delle autorizzazioni business_management e catalog_management.

Al momento, questa operazione non è supportata tramite API e deve essere completata tramite interfaccia utente. Per iniziare questa procedura, clicca su "Diventa un partner di vendita" nella Directory dei rivenditori di inserzioni collaborative.

Passaggio 2: creazione di un segmento del catalogo

Per completare questo passaggio, la tua app ha bisogno delle autorizzazioni business_management e catalog_management.

Crea un segmento del catalogo da uno dei tuoi cataloghi esistenti. Il segmento deve contenere tutti i prodotti che desideri condividere con il tuo brand partner.

Per creare un segmento del catalogo tramite API, effettua una richiesta POST al segmento owned_product_catalogs. Per la creazione del segmento del catalogo sono obbligatori i seguenti campi:

parent_catalog_id: il catalogo principale da cui è stato creato il tuo segmento. Questo catalogo deve essere conforme alle inserzioni collaborative. Puoi trovare lo stato del tuo catalogo in Gestore delle vendite.
catalog_segment_filter: una regola codificata JSON usata per creare il segmento del catalogo.

Passaggio 3: condivisione del segmento del catalogo

Per completare questo passaggio, la tua app ha bisogno delle autorizzazioni business_management e catalog_management.

Condividi il tuo segmento del catalogo con il tuo brand partner. Per farlo tramite API, effettua una richiesta POST a /{catalog_segment_id}/agencies. Nella chiamata, puoi aggiungere i seguenti campi:

Campo Descrizione

Campo	Descrizione
`business` tipo: stringa numerica o intero	Obbligatorio. ID dell'azienda con cui verrà condiviso il catalogo.
`permitted_tasks` tipo: array < enum {MANAGE, ADVERTISE} >	Obbligatorio. Attività che l'azienda sarà autorizzata a svolgere. Le opzioni disponibili sono: `['ADVERTISE', 'MANAGE']`.
`utm_settings` tipo: oggetto JSON {enum{campaign_source,campaign_medium,campaign_name}: string}	Facoltativo. Puoi specificare `campaign_source`, `campaign_medium` e `campaign_name`. Ad esempio: `{campaign_source: “fb_campaign_source”}`.

business

tipo: stringa numerica o intero

Obbligatorio.

ID dell'azienda con cui verrà condiviso il catalogo.

permitted_tasks

tipo: array < enum {MANAGE, ADVERTISE} >

Obbligatorio.

Attività che l'azienda sarà autorizzata a svolgere. Le opzioni disponibili sono: ['ADVERTISE', 'MANAGE'].

utm_settings

tipo: oggetto JSON {enum{campaign_source,campaign_medium,campaign_name}: string}

Facoltativo.

Puoi specificare campaign_source, campaign_medium e campaign_name.

Ad esempio: {campaign_source: “fb_campaign_source”}.

(Solo per i partner di marketing) Passaggio 4: fornitura di strumenti di scoperta per i brand

Per completare questo passaggio, la tua app ha bisogno dell'autorizzazione business_management. La chiamata API deve includere un token d'accesso dell'utente e l'utente deve avere l'autorizzazione per il partner, l'azienda o la richiesta di collaborazione suggeriti.

In qualità di partner di marketing, devi fornire ai brand un modo per individuare possibili partner di inserzioni collaborative. Puoi usare i seguenti endpoint per trovare rivenditori con cui lavorare:

GET {business-id}?fields=collaborative_ads_suggested_partners: trova partner per un'azienda specifica.
GET collaborative_ads_directory?fields=collaborative_ads_merchants: ottieni la lista completa dei rivenditori di inserzioni collaborative.
GET {cpas-advertiser-partnership-recommendation-id}?fields=advertiser_business_id,brand_business_id,brands,countries,merchant_business_id,status,status_reason: ricevi una raccomandazione su un singolo rivenditore.

Se un brand trova un partner, puoi contattare il rivenditore con una richiesta di collaborazione. Fallo facendo la seguente richiesta POST a /{cpas-collaboration-request-id}:

{business-id}/collaborative_ads_collaboration_requests?
brands=”[“[BRAND NAME]”, “[BRAND NAME 2]”]”&
contact_email=[CONTACT_EMAIL]&
contact_first_name=[CONTACT_FIRST_NAME]&
contact_last_name=[CONTACT_LAST_NAME]&
phone_number=[PHONE NUMBER]&
receiver_business=[RECEIVING BUSINESS ID]
requester_agency_or_brand=[REQUESTING ENTITY - AGENCY, BRAND or MERCHANT]

Tieni traccia dei tuoi contatti con i seguenti endpoint:

Passaggi per i brand

Passaggio 1: accettazione del segmento del catalogo

Se il tuo brand non ha accettato le Condizioni d'uso per la nuova azienda condivisa, devi farlo tu.

Dopo aver ricevuto la risorsa condivisa, l'utente amministratore strumenti business deve:

andare al Centro per la collaborazione;
selezionare l'azienda per cui accetta le Condizioni d'uso;
selezionare Partner dalla navigazione a sinistra;
cliccare sul pulsante Accetta risorse per iniziare il flusso di lavoro di accettazione.

Dopo aver accettato le condizioni, il tuo brand può aggiungere persone al segmento del catalogo usando l'endpoint /{product-catalog-id}/assigned_users. Nota: per questa operazione è necessaria l'autorizzazione business_management.

Passaggio 2: crea una campagna pubblicitaria

Per completare questo passaggio, la tua app ha bisogno delle autorizzazioni business_management e ads_management.

Il tuo brand può usare il segmento del catalogo accettato per creare campagne pubblicitarie. Devi usare un account pubblicitario separato per ogni rivenditore per cui desideri pubblicare inserzioni collaborative. Quando l'account pubblicitario dedicato è collegato a un rivenditore, può selezionare solo i segmenti del catalogo appartenenti a quel rivenditore specifico.

Per creare e pubblicare inserzioni procedi come fai normalmente per il tuo catalogo prodotti, ma devi fornire catalog_segment_ID invece di un ID catalogo:

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<CATALOG_SEGMENT_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Se l'operazione viene eseguita correttamente, ottieni un nuovo ID della campagna pubblicitaria:

{
"id": "<CAMPAIGN_ID>"
}

Ci sono quattro campi che normalmente puoi impostare con le inserzioni del catalogo Advantage+ che non puoi impostare con un segmento del catalogo:

multi_share_end_card è impostato su false per impostazione predefinita e non può essere modificato
Non puoi modificare description in template_data
template_url_spec che puoi usare per gli URL dei deep link deve indirizzare al sito web del venditore
Le specifiche di monitoraggio personalizzate sono disabilitate

Passaggio 3: visualizzazione dei report

Una volta pubblicate le inserzioni, gli inserzionisti del brand possono ottenere metriche sulle prestazioni delle inserzioni. Abbiamo diverse nuove metriche di insight a diversi livelli di oggetti pubblicitari. Consulta catalog_segment_value e le metriche correlate per:

catalog_segment_value include un dettaglio degli eventi di conversione, inclusi acquisti, aggiunte al carrello e visualizzazione dei prodotti per il segmento del catalogo a ciascun livello di oggetto pubblicitario. Aggrega gli eventi su siti web, dispositivi mobili e origini omnicanale. Scopri di più sulle metriche sugli insight stimate e in fase di sviluppo.

Passaggio 4: debug e diagnosi dei problemi

Ora i brand dovrebbero risolvere i problemi ed eseguire il debug di eventuali problemi con la pubblicazione delle loro inserzioni del catalogo Advantage+ per il segmento del catalogo.

Consulta Strumenti di debug per le inserzioni del catalogo Advantage+.

Insights

Le seguenti metriche stimate sono correlate alle inserzioni collaborative: consulta Informazioni sulle metriche stimate, in fase di sviluppo e di terzi.

Per interrogare una qualsiasi delle nostre metriche di report:

La tua app deve avere le autorizzazioni ads_management e business_management. Consulta Analisi dell'app.
Devi avere un token d'accesso dell'utente e questo utente deve poter visualizzare i report per l'account pubblicitario in questione.

Puoi effettuare query sui seguenti oggetti: account pubblicitario, campagna pubblicitaria, gruppo di inserzioni e inserzione.

Il dettaglio action_converted_product_id non è supportato a livello di account pubblicitario.

Metric	Description
`catalog_segment_value`	Value from conversion events, including a breakdown of purchases, add-to-carts and view products for the catalog segment at each ad object level.
`catalog_segment_value_omni_purchase_roas`	Total return on ad spend (ROAS) from purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailer' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_value_website_purchase_roas`	Total return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_value_mobile_purchase_roas`	The total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_actions`	Similar to `catalog_segment_value`, when using this metric a breakdown of actions is given for the catalog segment at each ad object level.
`converted_product_value`	Value of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK. The API only returns Product IDs —see `/{product-item-id}` for information. If you want to get brand names as well, please use Ads Manager.
`converted_product_quantity`	Quantity of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK. The API only returns Product IDs —see `/{product-item-id}` for information. If you want to get brand names as well, please use Ads Manager.

Dettagli

I dettagli vengono usati per raggruppare i risultati dei tuoi insight in diversi insiemi: consulta Dettagli. Puoi usare i seguenti dettagli con le metriche delle inserzioni collaborative:

Data: ottieni insight per un intervallo di date specifico. Per usare questo dettaglio, aggiungi time_range alla tua query. Ad esempio: &time_range[since]=2020-03-01&time_range[until]=2020-04-01.
Livello del prodotto: ottieni insight per un prodotto specifico. Usa questo dettaglio per converted_product_value e converted_product_quantity metrics aggiungendo &action_breakdowns=action_converted_product_id alla tua query.

Uso combinato dei dettagli

Usa i seguenti dettagli combinati per le inserzioni collaborative:

Il dettaglio action_converted_product_id non è supportato a livello di account pubblicitario.

action_converted_product_id
action_type, action_converted_product_id