API Offline Conversions

Usa l'API Offline Conversions per inviare eventi di conversione offline e scoprire quanti clienti hanno visualizzato le tue inserzioni su Facebook o cliccato su di esse prima di effettuare una conversione.

Prima di iniziare

Per usare questa API, hai bisogno di:

1. Facebook Business Manager

Se non ne hai ancora uno, crealo.

2. ID app Facebook

Per l'accesso all'API Marketing. Per creare un'app:

  • Accedi a Business Manager > Impostazioni di Business Manager.
  • Seleziona App.
  • Clicca su Aggiungi nuova app e segui le istruzioni.

3. Analisi dell'app e autorizzazioni

Le regole relative all'analisi e alle autorizzazioni dell'app dipendono da come stai implementando la nostra API:

Tipo di implementazioneAnalisi dell'app e autorizzazioni

Implementazione diretta

In questo caso, sei un inserzionista che desidera utilizzare direttamente le conversioni offline.


In questo caso:

  • La tua app non deve essere sottoposta all'Analisi dell'app.
  • Non devi richiedere alcuna autorizzazione.

Partner che implementano l'API come piattaforma

In questo caso, sei un partner terzo che offre funzionalità di conversioni offline agli inserzionisti che utilizzano i tuoi servizi.


In questo caso:

  • La tua app deve essere sottoposta all'Analisi dell'app.
  • Devi richiedere l'autorizzazione ads_management durante l'Analisi dell'app.

4. Utente di sistema e token Business Manager

Con l'accesso come utente di sistema, la tua app può inviare dati a Facebook tramite l'API. Per crearlo:

  • Accedi a Business Manager > Impostazioni di Business Manager.
  • Seleziona Utenti di sistema.
  • Clicca su Aggiungi nuovo utente di sistema.
  • Seleziona Utente di sistema amministratore come ruolo per l'utente di sistema.

Un token d'accesso fornisce l'accesso ai dati di Facebook. Per creare token d'accesso utente di sistema:

  • Accedi a Business Manager > Impostazioni di Business Manager.
  • Seleziona Utenti di sistema.
  • Seleziona l'utente di sistema e clicca su Genera nuovo token.
  • Seleziona l'app > per scope, seleziona ads_management.

5. Account pubblicitario

Hai bisogno di un account pubblicitario per lanciare campagne pubblicitarie su Facebook. Per crearne uno, fai riferimento all'API Marketing o all'articolo del Centro assistenza per gli inserzionisti "Configurazione di persone, Pagine e account pubblicitari in Business Manager".

6. Accesso all'account pubblicitario per l'utente di sistema

Fornisci all'utente del sistema l'accesso al tuo account pubblicitario.

  • Accedi a Business Manager > Impostazioni di Business Manager.
  • Seleziona Utenti di sistema.
  • Seleziona l'utente di sistema e clicca su Assegna risorse.
  • Seleziona il tuo account pubblicitario.

7. Insieme di eventi offline

Si tratta di file caricati con i dati delle conversioni offline. Quando crei un'inserzione, imposta tracking_spec sull'ID dell'insieme di eventi offline per un'attribuzione corretta degli eventi. Puoi quindi creare insiemi di eventi, visualizzare le statistiche per le tue importazioni ed eliminare e modificare questi dati in Business Manager.

Con le implementazioni precedenti, potevi eseguire operazioni CRUD sugli insiemi di eventi offline al livello di Business Manager per condividere insiemi di eventi con altri oggetti ed entità.

Caricamento dei dati degli eventi

Devi specificare l'accesso per creare insiemi di eventi offline, caricare o visualizzare i dati per un insieme di eventi. Devi disporre dell'accesso anche per assegnare queste autorizzazioni a un account pubblicitario. Devi avere uno dei seguenti ruoli:

  • Amministratore di Business Manager
  • Utente di sistema amministratore che ha creato l'insieme di eventi offline
  • Amministratore dell'elemento ad_account associato all'insieme di eventi offline

Consulta il riferimento per l'insieme di eventi di conversione offline.

1. Creare un insieme di eventi offline

curl 
  -F 'access_token=<SYSTEM_USER_ACCESS_TOKEN>' 
  -F 'name=offline_event_set',
  -F 'description=conversion data used for superbowl campaign',
  https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ID>/offline_conversion_data_sets
{
  "id": <OFFLINE_EVENT_SET_ID>
}

Effettua una chiamata HTTP POST:

POST /<BUSINESS_MANAGER_ID>/offline_conversion_data_sets HTTP/1.1
Host: graph.facebook.com
curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<BUSINESS_MANAGER_ID>/offline_conversion_data_sets

La risposta include un id dell'insieme di eventi:

curl \
  -F 'tracking_spec=[{action.type:"offline_conversion", dataset:["123"]}]' \
  -F 'access_token=<SYSTEM_USER_ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<AD_ID>

Parametri

curl \
  -F 'access_token=SYSTEM_USER_ACCESS_TOKEN' \
  -F 'upload_tag=store_data' \
  -F 'data=[ \
    { 
      match_keys: {"phone": ["HASH1","HASH2"], "email": ["HASH3","HASH4"]}, 
      currency: "USD", 
      value: 16,
      event_name: "Purchase",
      event_time: 1456870902,
      contents: [
        {id: "A", quantity: 1},
        {id: "B", quantity: 2},
        {id: "C", quantity: 1}
      ]
      custom_data: {
        event_source: "in_store"
      },
    }, 
    { 
      match_keys: {"lead_id": "12345"}, 
      event_name: "Lead",
      event_time: 1446336000,
      contents: [
        {id: "A", quantity: 1},
        {id: "B", quantity: 2},
        {id: "C", quantity: 1}
      ]
      custom_data: {
        event_source: "email",
        action_type: "sent_open_click",
        email_type: "email_type_code", 
        email_provider: "gmail_yahoo_hotmail",
      }
    }, 
  ]'
  https://graph.facebook.com/VERSION/OFFLINE_EVENT_SET_ID/events
Parametro Descrizione

name

tipo: stringa

Nome dell'insieme di eventi.

Esempio: In store purchases, Lead registrations

description

tipo: stringa

Descrizione dell'insieme di eventi.

Esempio: In store purchases for the Superbowl campaign

2. Assegnare autorizzazioni a un account pubblicitario

Per assegnare autorizzazioni di monitoraggio e lettura a un account pubblicitario:

POST /<OFFLINE_EVENT_SET_ID>/adaccounts HTTP/1.1
Host: graph.facebook.com
curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/adaccounts

Parametri

{
  match_keys: MATCH_KEYS,
  event_time: EVENT_TIME,
  event_name: "Purchase",
  value: 400,
  currency: "USD",
  contents: [
    {
        id: "A",
        quantity: 1,
        brand: "brand_of_A",
        category: "Apparel & Accessories | Clothing",
        price: 100,
    },
    {
        id: "B",
        quantity: 2,
        brand: "brand_of_B",
        category: "Apparel & Accessories | Shoes",
        price: 50,
    },
    {
        id: "C",
        quantity: 1,
        brand: "brand_of_C",
        category: "Apparel & Accessories | Jewelry | Watches",
        price: 200,
    }
  ],
}
Parametro Descrizione

business

tipo: intero

Assegna un account pubblicitario a questo ID aziendale.

account_id

tipo: intero

ID dell'account pubblicitario con monitoraggio offline abilitato.

3. Impostare il monitoraggio delle inserzioni

Quando aggiorni l'elemento tracking_spec, noi lo sovrascriviamo. Assicurati innanzitutto di inviare una richiesta GET, quindi allega l'elemento String associato per l'insieme di eventi offline alla tracking_spec esistente. Fai riferimento alla gestione delle inserzioni o usa Gestione inserzioni. Ad esempio, fornisci una specifica di monitoraggio appropriata:

curl \
  -F 'tracking_spec=[{action.type:"offline_conversion", dataset:["123"]}]' \
  -F 'access_token=<SYSTEM_USER_ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<AD_ID>

Per aggiornare la specifica di monitoraggio dell'inserzione:

POST /<AD_ID>/?tracking_specs=[{"action.type":"offline_conversion","dataset": <OFFLINE_EVENT_SET_ID>}] HTTP/1.1
Host: graph.facebook.com
curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<AD_ID>/?tracking_specs=[{"action.type":"offline_conversion","dataset": <OFFLINE_EVENT_SET_ID>}]

Parametri


Parametro Descrizione

action.type

tipo: stringa

Monitora questa azione per il gruppo di inserzioni.

Esempio: offline_conversion

dataset

tipo: intero

ID per l'insieme di eventi offline.

Esempio: 11111111111

4. Caricare eventi offline

Devi caricare la transazione entro 62 giorni dalla conversione. Carica i dati di conversione:

curl \
  -F 'access_token=SYSTEM_USER_ACCESS_TOKEN' \
  -F 'upload_tag=store_data' \
  -F 'data=[ \
    { 
      match_keys: {"phone": ["HASH1","HASH2"], "email": ["HASH3","HASH4"]}, 
      currency: "USD", 
      value: 16,
      event_name: "Purchase",
      event_time: 1456870902,
      contents: [
        {id: "A", quantity: 1},
        {id: "B", quantity: 2},
        {id: "C", quantity: 1}
      ]
      custom_data: {
        event_source: "in_store"
      },
    }, 
    { 
      match_keys: {"lead_id": "12345"}, 
      event_name: "Lead",
      event_time: 1446336000,
      contents: [
        {id: "A", quantity: 1},
        {id: "B", quantity: 2},
        {id: "C", quantity: 1}
      ]
      custom_data: {
        event_source: "email",
        action_type: "sent_open_click",
        email_type: "email_type_code", 
        email_provider: "gmail_yahoo_hotmail",
      }
    }, 
  ]'
  https://graph.facebook.com/VERSION/OFFLINE_EVENT_SET_ID/events

Per inviare conversioni, effettua una chiamata HTTP POST:

POST /<OFFLINE_EVENT_SET_ID>/events HTTP/1.1
Host: graph.facebook.com
curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/events

Parametri


Parametro Descrizione

upload_tag

tipo: stringa

Obbligatorio.

Monitora i caricamenti degli eventi.

Esempio: monthly, in-store uploads

data

tipo: json array

Obbligatorio.

Include il numero di eventi caricati. Carica un evento di conversione a persona fino a 2000 eventi per chiamata API.

Esempio: vedi esempio in alto

namespace_id

tipo: intero

Facoltativo.

L'ambito usato per risolvere l'elemento extern_id o tpid. Può essere un altro ID set di dati o partner dati.

Esempio: 12345

Usa lo stesso upload_tag per tutte le chiamate API con caricamento degli eventi nello stesso batch per raggrupparle. In questo modo, puoi eseguire il debug dei caricamenti degli eventi; deve essere usato per tutti i caricamenti degli eventi in più di una chiamata API.

I parametri contenuti in data includono:

Parametro Descrizione

match_keys

tipo: dizionario JSON

Obbligatorio.

Le informazioni di identificazione utilizzate per associare gli utenti su Facebook.

Esempio: {"phone": ["{HASH}","{HASH}"], "email": ["{HASH}","{HASH}"], "fn": "{HASH}",}.

event_time

tipo: intero

Obbligatorio.

La marca temporale UNIX dell'evento di conversione.

Esempio: 1456870055

event_name

tipo: stringa

Obbligatorio.

Tipo di evento.

Esempio: ViewContent, Search, AddToCart, AddToWishlist, InitiateCheckout, AddPaymentInfo, Purchase, Lead, Other

currency

tipo: stringa

Obbligatorio.

Il codice valuta ISO di tre lettere per questo evento di conversione. Obbligatorio per gli eventi Purchase.

Esempio: USD

value

tipo: doppio

Obbligatorio.

Valore dell'evento di conversione. Obbligatorio per gli eventi Purchase.

Esempio: 16.00

content_type

tipo: stringa

Facoltativo.

Qualsiasi content-typeinserzione dinamica valida.

Esempio: product

contents

tipo: array JSON

Facoltativo. Richiesto se si integrano le inserzioni con il catalogo prodotti.

Esempio: obbligatorio: id, quantity


Consigliato: price, brandcategory

Obbligatorio: [ {id: "A", quantity: 1}, {id: "B", quantity: 2}, {id: "C", quantity: 1}]


Consigliato: [ {id: "A", quantity: 1, brand: "Brand_A", category: "", price: 10.0}]

custom_data

tipo: dizionario JSON

Facoltativo.

Informazioni su questo evento di conversione.

Esempio: {category: 'ICECREAM'}

order_id

tipo: stringa

Facoltativo.

Identificativo unico per ogni transazione o ordine in un insieme di eventi offline. Ad esempio, per la vendita al dettaglio può essere un ID ricevuta.

Esempio: ATN10001, 123456

item_number

tipo: stringa

Facoltativo.

Identificativo unico per distinguere gli eventi all'interno dello stesso ordine o della stessa transazione.

Esempio: 1, a

Ad esempio, puoi caricare informazioni con il campo data:

{
  match_keys: MATCH_KEYS,
  event_time: EVENT_TIME,
  event_name: "Purchase",
  value: 400,
  currency: "USD",
  contents: [
    {
        id: "A",
        quantity: 1,
        brand: "brand_of_A",
        category: "Apparel & Accessories | Clothing",
        price: 100,
    },
    {
        id: "B",
        quantity: 2,
        brand: "brand_of_B",
        category: "Apparel & Accessories | Shoes",
        price: 50,
    },
    {
        id: "C",
        quantity: 1,
        brand: "brand_of_C",
        category: "Apparel & Accessories | Jewelry | Watches",
        price: 200,
    }
  ],
}

Usa lo stesso upload_tag per tutte le chiamate API con caricamento degli eventi nello stesso batch per raggrupparle. In questo modo, puoi eseguire il debug dei caricamenti degli eventi; deve essere usato per tutti i caricamenti degli eventi in più di una chiamata API.

Chiavi di corrispondenza

L'elemento match_keys è un insieme di identificativi che permettono di trovare le corrispondenze per le persone in base all'attribuzione. Fai riferimento al pubblico personalizzato dai dati CRM per normalizzare e sottoporre ad hashing i tuoi dati. Solo l'algoritmo SHA256 è supportato e non vengono accettati dati non in formato hash.

Tipo di chiave, singola e multipla Nome della chiave Hashing obbligatorio

Indirizzo/i e-mail

email

Numero/i di telefono

phone

Genere

gen

Data di nascita. Formato AAAA

doby

Data di nascita. Formato MM

dobm

Data di nascita. Formato GG

dobd

Cognome

ln

Nome

fn

Iniziale del nome

fi

Città

ct

Stati degli Stati Uniti

st

CAP

zip

Paese

country

Identificativo IDFA Apple

madid

ID pubblicitario di Android

madid

ID utente di terzi

extern_id

NON applicare algoritmo di hashing

ID contatto delle inserzioni per acquisizione contatti

lead_id

NON applicare algoritmo di hashing

Risposta:

Nome Tipo Descrizione

num_processed_entries

intero

Numero delle voci elaborate

Negli errori, vedrai un'eccezione che include le voci non valide e il relativo motivo. Correggi gli errori o ignora le righe di dati con errori e riprova a eseguire la chiamata API.

Visualizzazione delle statistiche dei caricamenti

L'amministratore di Business Manager o l'utente di sistema che ha creato l'insieme di eventi offline può recuperare le statistiche dei caricamenti. Anche gli amministratori dell'ad_account che sono connessi all'insieme di eventi offline possono leggere questi dati.

Per visualizzare le statistiche sugli insiemi di eventi offline come le voci valide e quelle per cui sono state trovate corrispondenze:

GET /<OFFLINE_EVENT_SET_ID>/uploads HTTP/1.1
Host: graph.facebook.com
curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/uploads

Visualizza i dettagli giornalieri degli eventi offline su Offline Events Manager in Business Manager. Per dettagli più precisi, effettua questa chiamata:

GET /<OFFLINE_EVENT_SET_ID>/stats HTTP/1.1
Host: graph.facebook.com
curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/stats

Parametri


Parametro Descrizione

start

tipo: intero

Facoltativo.

La marca temporale UNIX. Interroga gli eventi che iniziano in questo intervallo.

Esempio: 1456870055

end

tipo: intero

Facoltativo.

La marca temporale UNIX. Esclude gli eventi che si verificano da questo momento in poi.

Esempio: 1456870056

fields

tipo: string[]

Facoltativo.

Lista di stringhe. Questo endpoint fornisce tutti i campi fino alla versione 3.0 e, successivamente, fornisce count, event e time per impostazione predefinita. I campi aggiuntivi sono: matched_count, attributed_count, usd_amount, matched_usd_amount, attributed_usd_amount o duplicate_count.

summary

tipo: booleano

Facoltativo.

Restituisce il tempo medio di ritardo di caricamento in secondi quando il tempo di aggregazione è impostato su upload_time e questo campo è impostato su true.

aggr_time

tipo: stringa

Facoltativo.

Risultati aggregati basati su questo tempo impostato. Le opzioni sono upload_time e event_time. L'impostazione predefinita è event_time.

Creare conversioni personalizzate offline

Per le conversioni personalizzate offline al momento non viene eseguito il backfill. Non attribuiamo i dati degli eventi caricati effettuati prima che tu abbia creato la conversione personalizzata. Non puoi usare i dati delle conversioni offline personalizzate per l'ottimizzazione della pubblicazione delle inserzioni. Consulta il riferimento per le conversioni personalizzate.

Per creare una conversione personalizzata usando i tuoi eventi offline, esegui una richiesta POST:

POST /act_<ACCOUNT_ID>/customconversions HTTP/1.1
Host: graph.facebook.com
curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/act_<ACCOUNT_ID>/customconversions

Parametri:

Parametro Descrizione

name

tipo: stringa

Il nome della nuova conversione personalizzata.

Esempio: Offline purchases over 100 dollars

event_source_id

tipo: intero

L'ID dell'insieme di eventi offline da monitorare.

Esempio: 11111111111

custom_event_type

tipo: stringa

Uno dei nove eventi standard del pixel di Facebook.

Esempio: "ViewContent", "Search", "AddToCart", "AddToWishlist", "InitiateCheckout", "AddPaymentInfo", "Purchase", "Lead", "CompleteRegistration", "Other"

rule

tipo: stringa con codifica JSON

Gli operatori e i dati della tua regola di conversione. Consulta il Riferimento per le conversioni personalizzate. Ad esempio, acquisti superiori a 100 USD.

Esempio: {"and":[{"event_name":{"eq": "Purchase"}},{"value":{"gt":100}}]}

La risposta in caso di azione eseguita correttamente:

{
  "id": <CUSTOM_CONVERSION_ID>
}

Misurazione con i dati personalizzati

Puoi usare il campo custom_data per creare regole che in seguito determineranno se una conversione viene o meno conteggiata. È simile al pubblico personalizzato offline. Il numero massimo di conversioni personalizzate che puoi usare per ogni account pubblicitario è pari a 40.

Ad esempio, includi la categoria dei prodotti nei caricamenti con custom_data:

data=[
  {
    match_keys: {"phone": ["<HASH>","<HASH>"], "email": ["<HASH>","<HASH>"]}, 
    currency: "USD", 
    value: 16,
    event_name: "Purchase",
    event_time: 1456870902,
    custom_data: {
      product_category: "ICECREAM",
    },
  },
]

Usa quindi custom_data.{YOUR_CUSTOM_PARAM} per creare una regola per la conversione personalizzata:

curl \
  -F 'name=Ice Cream Purchasers' \
  -F 'custom_event_type=Purchase' \
  -F 'event_source_id=<OFFLINE_EVENT_SET_ID>' \
  -F 'rule={"and": [{"event_name":{"eq":"Purchase"}},{"custom_data.product_category":{"i_contains":"ICECREAM"}}]}' \
  -F 'access_token=<ACCESS_TOKEN>' \

"https://graph.facebook.com/<API_VERSION>/act_<ACCOUNT_ID>/customconversions"

Conversioni offline per i partner

Per attribuire gli eventi di conversione offline all'inserzione del tuo cliente, segui questi passaggi. Le chiamate API per molti di questi passaggi sono le stesse di quando qualcuno gestisce il suo insieme di eventi offline e la sua campagna.

  1. Partner: creazione di un insieme di eventi offline
  2. Partner: condivisione dell'insieme di eventi con il Business Manager del cliente
  3. Cliente: assegnazione dell'autorizzazione per il monitoraggio offline dell'account pubblicitario
  4. Cliente: impostazione del monitoraggio offline per le inserzioni
  5. Partner: caricamento degli eventi offline e visualizzazione delle statistiche
  6. Partner: presentazione dei dati statistici sulle inserzioni al cliente

Questi passaggi variano in base a come vengono impostate le autorizzazioni per il tuo partner o la tua agenzia negli account pubblicitari del cliente:

  • Potresti controllare tutti gli account pubblicitari, gli insiemi di eventi o altre risorse del tuo cliente.
  • Potresti avere l'autorizzazione per eseguire determinate azioni sulle risorse del tuo cliente.

Per configurare queste autorizzazioni, consulta Gestione delle risorse di Business Manager.

Partner: condivisione dell'insieme di eventi

Condividi l'insieme di eventi con il Business Manager del tuo cliente, il quale può usarlo per il monitoraggio delle inserzioni.

GET /<OFFLINE_EVENT_SET_ID>/agencies HTTP/1.1
Host: graph.facebook.com
curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/agencies

Parametri


Parametro Descrizione

business

tipo: intero

ID Business Manager del tuo cliente

Cliente: assegnazione dell'autorizzazione per il monitoraggio offline dell'account pubblicitario

Condivi gli insiemi di eventi offline creati da un partner con il cliente. Devi essere l'amministratore di Business Manager o l'utente di sistema amministratore che ha creato l'insieme di eventi offline per abilitare il monitoraggio delle inserzioni in un account pubblicitario. Puoi farlo anche se sei amministratore dell'account pubblicitario connesso all'insieme di eventi offline. Per effettuare questa chiamata API, il Business Manager nella chiamata deve avere accesso all'insieme di eventi offline.

Con questa chiamata, puoi assegnare il monitoraggio degli eventi offline e la visualizzazione delle autorizzazioni a un account pubblicitario:

POST /<OFFLINE_EVENT_SET_ID>/adaccounts HTTP/1.1
Host: graph.facebook.com
curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/adaccounts

Parametri

Parametro Descrizione

business

tipo: intero

Assegna un account pubblicitario a questo ID aziendale.

account_id

tipo: intero

ID account pubblicitario con monitoraggio offline attivo

Fornire ID esterni

In alcuni casi, potresti dover usare il tuo ID esterno per rappresentare un cliente e trovare una corrispondenza con qualcuno su Facebook. Per farlo, usa l'elemento extern_id seguendo queste linee guida.

I partner dati che sono stati sottoposti al processo di corrispondenza possono usare l'ID partner come ID spazio dei nomi e l'elemento extern_id come tuo tpid.

Uso esclusivo di match_keys

Usiamo il parametro match_keys per trovare qualcuno su Facebook e inviare i dati per cui sono state individuate corrispondenze per la successiva elaborazione. Non elaboriamo né archiviamo i dati per cui non sono state trovate corrispondenze. Non puoi usare anche il parametro namespace_id.

Uso di match_keys ed extern_id

Usiamo il parametro match_keys per trovare gli utenti su Facebook e trasmettere le mappature da {dataset_id, extern_id} a {facebook_user_id}. Inviamo i dati per cui vengono trovate corrispondenze per la successiva elaborazione ed eliminiamo quelli per cui non vengono trovate corrispondenze.

Non puoi usare anche il parametro namespace_id.

Uso esclusivo di extern_id

Se hai già inviato i dati con i parametri match_keys e extern_id, Facebook usa {dataset_id, extern_id} per recuperare {facebook_user_id}. Se non vengono trovate corrispondenze, i dati senza corrispondenza non vengono elaborati.

Uso di namespace_id

Il parametro namespace_id si applica all'intera chiamata API. Puoi usarlo per fare riferimento a un altro insieme di eventi offline accessibile o controllato da un ID Business Manager o un ID del profilo partner. Se hai già inviato i dati con i parametri match_keys e extern_id, Facebook usa {namespace_id, extern_id} per recuperare un {facebook_user_id}. Devi fornire solo un parametro extern_id per ogni riga di dati.

Dati statistici e attribuzione

Vedi gli eventi offline attribuiti a un'inserzione che qualcuno ha visualizzato o su cui hai cliccato. Attribuiamo le conversioni offline dopo più di un giorno. Ciò significa che devi impostare la tua finestra di attribuzione su 28d_view o action_attribution_windows=['28d_view']', altrimenti non vedrai conversioni nei report. Consulta API Insights e la guida ai dati statistici.

GET /act_<ADACCOUNT_ID>/insights HTTP/1.1
Host: graph.facebook.com
curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/act_<ADACCOUNT_ID>/insights

Parametri

Parametro Descrizione

action_breakdowns

tipo: stringa[]

I dettagli dei dati su impression, clic o conversioni. Sono raggruppati per tipo di evento: offline, online, ecc.

Esempio: ["action_type", "placement", "age", "gender", "country", "region"]

fields

tipo: stringa[]

Le metriche di base delle inserzioni.

Esempio: ["impressions", "clicks", "actions",]

level

tipo: stringa

Aggregazione o deduplicazione dei dati a questo livello dei risultati dei report.

Esempio: ad o adset o campaign

date_preset

tipo: stringa

Intervalli di tempo relativi per le query delle metriche.

Esempio: last_n_days (n = 7,14,28) o yesterday o today o last_month o lifetime

I risultati si presentano così:

{
  "data": [
    {
      "date_start": "2015-12-01",
      "date_stop": "2015-12-01",
      "actions": [
        {
          "action_type": "offline_conversion.purchase",
          "value": 1
        },
        {
          "action_type": "offsite_conversion.lead",
          "value": 3
        },
      ],
      ...
    }
  ]
}

Ad esempio, per visualizzare l'attribuzione:

curl -G \
  -d 'access_token=<SYSTEM_USER_ACCESS_TOKEN>' \
  -d 'fields=unique_actions,action_values' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/insights

Il risultato si presenta così:

{
  "data": [
    {
      "unique_actions": [
        {
          "action_type": "link_click",
          "value": 94
        },
        {
          "action_type": "offline_conversion",
          "value": 1
        },
        {
          "action_type": "offline_conversion.purchase",
          "value": 1
        },
        {
....
          "value": 1
        }
      ],
      "action_values": [
        {
          "action_type": "offline_conversion.purchase",
          "value": 27.5
        },
        {
          "action_type": "offline_conversion",
          "value": 27.5
        }
      ],
      "date_start": "2016-06-06",
      "date_stop": "2016-06-07"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD"
    }
  }
}

Opzioni per il trattamento dei dati per API lato server e API Offline Conversions

Per queste due API, implementa le opzioni per il trattamento dei dati aggiungendo data_processing_options, data_processing_options_country e data_processing_options_state all'interno di ciascun evento nel parametro dati dei tuoi eventi.

Per non abilitare in modo esplicito la modalità LDU (Limited Data Use, utilizzo dei dati limitato), specifica un array vuoto per ciascun evento:
{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": []
        }
    ]
}
Per abilitare la modalità LDU e specificare i dati geografici degli utenti:
{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": ["LDU"],
            "data_processing_options_country": 1,
            "data_processing_options_state": 1000
        }
    ]
}
Per abilitare la modalità LDU con la geolocalizzazione (opzione valida per l'API lato server con indirizzo IP client specificato):
{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>",
                "client_ip_address": "256.256.256.256"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": ["LDU"],
            "data_processing_options_country": 0,
            "data_processing_options_state": 0
        }
    ]
}

Interfaccia utente per il caricamento manuale

L'API Offline Conversions ti consente di caricare manualmente gli eventi da un file .csv. In questo caso, aggiungi Opzioni trattamento dati, Paese trattamento dati e provincia/stato trattamento dati come colonne all'interno del file. Ulteriori informazioni sono disponibili nell'interfaccia utente per il caricamento manuale.

Uploader automatico Offline Conversions


Scopri di più sulle opzioni per il trattamento dei dati.