API Conversions

ClickID e i parametri fbp e fbc

Questa guida tratta i parametri parametri _fbc, _fbp e ClickID di Meta. I parametri _fbc e _fbp rappresentano i valori dei cookie del browser e possono essere inviati con gli eventi del tuo server. Consulta Informazioni sulle impostazioni dei cookie per il pixel di Meta.

Ti consigliamo di inviare sempre i valori dei cookie del browser _fbc e _fbp rispettivamente nei parametri dell'evento fbc e fbp, quando disponibili. Questi valori sono soggetti a modifiche nel corso di più sessioni di browser, per questo ti consigliamo di aggiornare il profilo di un utente con il valore più recente ogniqualvolta possibile.

Che cos'è ClickID di Meta

ClickID è un parametro generato da Meta che viene trasmesso insieme all'URL del sito web di un inserzionista quando un utente clicca su un'inserzione su Facebook e/o Instagram. La condivisione di ClickID può aiutarti ad attribuire più conversioni e a raggiungere più persone, migliorando quindi le prestazioni delle inserzioni. L'aggiunta automatica di ClickID non influisce sugli altri parametri di monitoraggio eventualmente abilitati.

Esempio di URL con ClickID:https://example.com/?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc

Vantaggi di ClickID

  • Aumenta il volume delle conversioni
  • Migliora l'attribuzione e l'ottimizzazione delle campagne
  • Migliora le prestazioni delle inserzioni

1. Recupero del ClickID di Meta

Recupero dal parametro URL della query fbclid

Ogni volta che è presente nei parametri URL della query, cerca di ottenere il parametro lato server leggendolo dalla stringa di query dell'URL di richiesta HTTP.

Esempio:

GET /?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc 
HTTP/2.0
Host: www.example.org

Nota: il valore ClickID distingue tra minuscole e maiuscole. Non applicare modifiche prima dell'uso, ad esempio cambiando le maiuscole o le minuscole.

Recupero dal cookie _fbc

Il valore ClickID è disponibile all'interno del cookie _fbc in 2 casi:

  • Il pixel di Meta è installato sul sito web. In questo caso, il pixel di Meta memorizza automaticamente il valore ClickID nel cookie del browser _fbc una volta disponibile
  • Lo memorizzi già nel cookie dal server o nella memoria del backend, seguendo le best practice elencate nella sezione "Memorizzazione di ClickID"

In entrambi i casi il ClickID formattato può essere ricavato dal cookie _fbc leggendo le intestazioni dei cookie della richiesta HTTP. Scopri come formattare correttamente ClickID nella sezione "Formattazione di ClickID" di seguito.

2. Formattazione del ClickID

Se il cookie _fbc non è disponibile perché sul sito web non è in esecuzione il pixel di Meta, è comunque possibile inviare il parametro dell'evento fbc con l'evento dell'API Conversions se è presente un parametro della query fbclid nell'URL della richiesta della pagina attuale.

Il valore ClickID formattato deve avere la struttura version.subdomainIndex.creationTime.<fbclid>, dove:

  • la versione è sempre il prefisso: fb
  • subdomainIndex è il dominio su cui il cookie è definito ('com' = 0, 'example.com' = 1, 'www.example.com' = 2).
  • creationTime è l'indicazione temporale UNIX dal momento epoch in millisecondi in cui _fbc è stato salvato. Se non salvi il cookie _fbc, usa l'indicazione temporale in cui hai notato o ricevuto per la prima volta questo valore fbclid.
  • <fbclid> è il valore del parametro della query fbclid nell'URL della pagina.

Ecco un esempio dell'aspetto che il valore fbc potrebbe avere (tieni presente che la porzione <fbclid> non è valida):

fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890

3. Memorizzazione del ClickID

Nota: prima di memorizzare ClickID è fondamentale formattarlo come descritto nella precedente sezione “Formattazione di ClickID”. In questo modo, avrai la certezza che il valore inviato a Meta tramite l'API Conversions sia valido.

Configura il ClickID formattato nel cookie _fbc nella risposta HTTP

Consigliamo vivamente di impostare _fbc come:

  • Cookie HTTP nelle intestazioni della risposta HTTP
  • con la scadenza di 90 giorni

una volta recuperato dal parametro URL della query fbclid o dal cookie del browser _fbc.

Nota. Imposta il cookie solo se:

  • il cookie _fbc è inesistente e ClickID è stato recuperato dal parametro della query fbclid
  • fbclid nel parametro URL della query non è uguale al valore corrispondente nel valore del cookie _fbc. Nel cookie, fbclid corrisponde alla stringa successiva all'ultimo "." nel valore del cookie.

Esempio:

HTTP/2.0 200 OK
Content-Type: text/html
Set-Cookie:
_fbc=fb.1.1709136167115.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc; Expires=Thu, 21 Oct 2021 07:28:00 GMT;

Memorizzazione del ClickID formattato sul server

In alternativa all'opzione relativa ai cookie indicata qui sopra, puoi memorizzare e gestire il valore del ClickID formattato nella memoria del backend. In questo caso dovrai assicurarti di memorizzare e inviare il valore più recente ottenuto dal parametro URL della query, se presente.

4. Invio del parametro fbc con gli eventi dell'API Conversions

Una volta ottenuto il valore del ClickID, dovrai formattarlo correttamente prima di inviarlo con un evento tramite l'API Conversions. Vedi le istruzioni di seguito. Consigliamo di inviare il parametro fbc con ogni evento che invii all'API Conversions.

Nome del parametro: fbc

Valore del parametro: deve avere la struttura version.subdomainIndex.creationTime.fbclid, in cui:

  • la versione è sempre il prefisso: fb
  • subdomainIndex è il dominio su cui il cookie è definito ('com' = 0, example.com' = 1, 'www.example.com' = 2). Se stai generando questo campo su un server e non stai salvando un cookie _fbc, usa il valore 1.
  • creationTime è l'indicazione temporale UNIX del momento epoch in millisecondi in cui il cookie _fbc è stato salvato. Se non salvi il cookie _fbc, usa l'indicazione temporale in cui hai visto o ricevuto per la prima volta questo valore fbclid.
  • fbclid è il valore del parametro della query fbclid nell'URL della pagina.

Esempio di valore:

fb.1.1554763741205.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc

Esempio di payload dell'API Conversions:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1712248396,
            "action_source": "website",
            "user_data": {

                "fbc": "fb.1.1554763741205.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc",

                "em": ["7b17fb0bd173f625b58636fb796407c22b3d16fc78302d79f0fd30c2fc2fc068"],
                "ph": ["6069d14bf122fdfd931dc7beb58e5dfbba395b1faf05bdcd42d12358d63d8599"],
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            }
        }
    ]
}

Strumenti di assistenza per l'integrazione

Strumento di assistenza payload

Lo strumento di assistenza payload consente di strutturare il payload della richiesta dell'API Conversions per garantire che i dati inviati a Meta siano formattati correttamente. Offre anche l'SDK Business in più linguaggi di programmazione, utile per integrarti con l'API Conversions. Sono disponibili facendo clic sul pulsante "Ricevi codice" nella sezione "Genera codice".

fbp

Quando è installato su un sito web e utilizza cookie proprietari, il pixel di Meta salva automaticamente un identificatore unico in un cookie _fbp per il dominio del sito web, se non esiste già.

Il valore del parametro dell'evento fbp deve avere la struttura version.subdomainIndex.creationTime.randomnumber, dove:

  • version è sempre questo prefisso: fb
  • subdomainIndex è il dominio su cui il cookie è definito ('com' = 0, 'example.com' = 1, 'www.example.com' = 2). Se generi questo campo su un server e non salvi un cookie _fbp, usa il valore 1.
  • creationTime è l'indicazione temporale UNIX dal momento epoch in millisecondi in cui il cookie _fbp è stato salvato. Se non salvi il cookie _fbp, usa l'indicazione temporale del momento in cui hai visto o ricevuto per la prima volta questo valore fbp.
  • Randomnumber è generato dall'SDK del pixel di Meta per garantire che ogni cookie _fbp sia unico.

Ecco un esempio dell'aspetto che il valore fbp potrebbe avere:

fb.1.1596403881668.1116446470

Per saperne di più