Cosa fa la Conversion API
Una Conversion API (CAPI) invia eventi di conversione dal server di Storeep direttamente alla piattaforma pubblicitaria, bypassando il browser dell'acquirente. Poiché funziona da server a server, non è influenzata da ad blocker, impostazioni di privacy del browser o limiti di tracciamento iOS, e trasmette dettagli del cliente in forma hashata per migliorare la qualità dell'abbinamento per Smart Bidding e pubblici simili. Per i pixel lato client, consulta l'articolo correlato Browser pixels.
Puoi utilizzare contemporaneamente un pixel browser e una CAPI per la stessa piattaforma. Storeep assegna a entrambi un ID evento condiviso, creato dal tipo di evento e dal numero d'ordine, così la piattaforma li deduplica in una sola conversione invece di contarne due.
Quali piattaforme offrono una CAPI
- Facebook / Meta Conversion API.
- TikTok Events API.
- Snapchat Conversions API.
X e Google Ads non dispongono di una Conversion API lato server in Storeep; sono solo lato browser.
Cosa viene inviato
Per ogni ordine idoneo, Storeep invia il valore e la valuta dell'ordine, le linee prodotto e i segnali dell'acquirente: email hashata, telefono hashato, un ID cliente hashato (external_id), l'indirizzo IP, lo user agent e, per Facebook e Snapchat, il paese di mercato hashato. Vengono inoltre inoltrati eventuali ID di clic pubblicitari trovati nei cookie dell'acquirente (Facebook _fbc e _fbp, TikTok ttclid, Snapchat ScCid) così la piattaforma può attribuire la conversione al clic originale.
Tipi di evento di conversione
- Facebook: solo Lead o Purchase. La CAPI di Facebook non invia eventi di aggiunta al carrello o checkout.
- TikTok: Lead, Purchase, Place an order o Complete payment.
- Snapchat: Purchase o Reserve.
Valuta e ordini a valore zero
Ogni evento utilizza la valuta dell'ordine quando la piattaforma lo supporta; altrimenti il valore viene convertito in USD. La CAPI di Facebook ignora qualsiasi ordine con totale pari a 0, perché Meta rifiuta le conversioni senza valore, mantenendo così la coerenza con il pixel browser di Facebook.
Tracciamento ordini abbandonati
Questo è il comportamento chiave da comprendere. Un ordine completamente nuovo attiva sempre l'invio tramite CAPI. Un ordine abbandonato è diverso: viene inviato solo se attivi l'opzione Ordini abbandonati per quella voce CAPI, e solo nel momento in cui lo stato dell'ordine passa da abbandonato a qualsiasi altro stato.
- Con Ordini abbandonati disattivato, gli ordini abbandonati recuperati non vengono mai inviati alla piattaforma.
- Con l'opzione attiva, l'evento viene inviato quando l'ordine esce dallo stato abbandonato, sia che tu cambi lo stato manualmente sia che l'app Automator lo cambi automaticamente.
- Se Automator non è installato, devi spostare tu stesso l'ordine in un altro stato affinché l'evento venga inviato.
- L'opzione è per singola voce, quindi puoi abilitare il tracciamento degli ordini abbandonati per un Pixel ID e lasciarlo disattivato per un altro.
Installazione di una CAPI e dei suoi campi
- Apri Apps nel menu a sinistra.
- Trova l'app Conversion API che desideri e clicca su Install, quindi conferma.
- Apri nuovamente l'app e clicca su Add new pixel per creare una voce.
Ogni voce presenta questi campi:
- Activate: se attivo, gli eventi di conversione vengono inviati da server a server. Attivo di default.
- Ordini abbandonati: l'opzione di tracciamento descritta sopra. Disattivata di default.
- Ad account name: un'etichetta solo per tuo riferimento.
- Pixel ID: il tuo Pixel ID Meta, TikTok o Snapchat.
- Markets: i mercati dello store coperti da questa voce. Seleziona uno o più.
- Conversion event type: le opzioni della piattaforma elencate sopra.
- Access token: il token di accesso alla Conversions API che generi nel gestore eventi della piattaforma. Obbligatorio.
- Activate test mode: se attivo, gli eventi vengono inviati come eventi di test.
- Test code: il codice evento di test dalla piattaforma, ad esempio TEST_1234. Obbligatorio quando la modalità test è attiva.
Modalità test
Con la modalità test attiva, gli eventi appaiono nella vista eventi di test della piattaforma così puoi confermare l'integrazione senza toccare i dati reali. Gli eventi di test non alimentano le offerte pubblicitarie o l'ottimizzazione, quindi disattiva la modalità test prima di avviare campagne reali.
Come i mercati delimitano una CAPI
Una voce CAPI si attiva solo per gli ordini effettuati nei mercati che hai selezionato su di essa. Un ordine in un mercato che non hai scelto non attiva quella voce, quindi puoi utilizzare un Pixel ID e un access token diversi per paese dallo stesso store.
Cosa controllare
- Usa lo stesso Pixel ID sul pixel browser e sulla CAPI così la piattaforma deduplica le due consegne in una sola conversione.
- Se gli eventi smettono di apparire nel gestore eventi della piattaforma, il tuo access token potrebbe essere scaduto. Rigeneralo e aggiorna la voce.
- Ogni voce è indipendente. Puoi aggiungere più voci per piattaforma, ognuna con il proprio Pixel ID, access token, mercati, tipo di evento e impostazione ordini abbandonati.
- Ricorda di disattivare la modalità test prima di andare live, altrimenti le tue conversioni reali non verranno conteggiate.