Integrazione con piattaforma pubblicitaria

Conversioni X, inviate dal tuo server

ROASaurus invia acquisti, aggiunte al carrello, checkout e visualizzazioni di pagina all’endpoint delle conversioni della X Ads API. In ROASaurus non esiste un pixel del browser per X: riceve solo eventi server.

X (Twitter) in sintesi
ConnessioneConversioni web della X Ads API, firmate con OAuth 1.0a
EventiAcquisto (obbligatorio), aggiunta al carrello, checkout avviato, visualizzazione di pagina, ciascuno come event id di Events Manager
Identificativitwclid, email con hash, telefono con hash (E.164); IP e user agent solo insieme a uno di questi
CredenzialiPixel ID, chiave API e secret, token di accesso e secret
Pixel del browserNo, solo eventi server
Sincronizzazione della spesaSì: spesa delle campagne, impression e clic al giorno, dopo aver collegato l’account pubblicitario in Setup › Ad spend

Cosa invia ROASaurus a X

X non ha nomi di evento standard. Ogni tipo di evento è un event id che crei in X Events Manager, come tw-o1abc-o1def, e incolli in ROASaurus. L’event id dell’acquisto è obbligatorio. Aggiunta al carrello, checkout avviato e visualizzazione di pagina sono facoltativi; un tipo di evento senza id non viene inviato. Le visualizzazioni di prodotto non vengono inviate a X.

Ogni conversione elenca degli identificativi: il click id twclid, l’email con hash SHA-256 e il telefono in formato E.164, con hash. L’indirizzo IP e lo user agent vengono aggiunti solo accanto a uno di questi, perché X li conta soltanto in combinazione. ROASaurus invia inoltre un ID conversione, il valore, la valuta, il numero di articoli e i prodotti. Una conversione senza twclid, email o telefono viene saltata.

ROASaurus considera un invio riuscito solo quando X segnala almeno una conversione elaborata.

Come collegarsi

  1. Ottieni un’app per sviluppatori X con accesso all’Ads API.
  2. Genera i token utente OAuth 1.0a per un utente con accesso Ad Manager all’account pubblicitario: ti servono la chiave API e il secret, più il token di accesso e il secret.
  3. In X Events Manager, crea un evento per ogni tipo che vuoi e copia gli event id.
  4. In ROASaurus, vai su Tracking & platforms, clicca su Add pixel nella scheda X e inserisci il Pixel ID, gli event id e le quattro chiavi.

Limiti

  • Nessun pixel del browser: X riceve solo eventi server.
  • La spesa delle campagne X si sincronizza dopo che hai collegato l’account pubblicitario in Setup › Ad spend.
  • Un twclid da solo non crea un touchpoint di attribuzione. Tagga i tuoi annunci X con parametri UTM così le visite compaiono nell’attribuzione per fonte e campagna.

Correlati

FAQ

Domande, risposte

Perché X richiede quattro chiavi?

La X Ads API richiede OAuth 1.0a per le integrazioni personalizzate. Ogni richiesta viene firmata con la chiave API e il secret della tua app e con il token di accesso e il secret di un utente che può gestire l’account pubblicitario.

ROASaurus carica il pixel di X?

No. X riceve solo eventi server. Le conversioni vengono abbinate tramite il click id twclid oppure l’email o il telefono con hash dell’acquirente.

Quali eventi di X posso inviare?

Acquisto, aggiunta al carrello, checkout avviato e visualizzazione di pagina. Crea ciascuno in X Events Manager e incolla il relativo event id. Solo l’acquisto è obbligatorio.

Ogni vendita, ricondotta all’annuncio che l’ha generata

Tracciamento server-side, profitto e lifetime value in un’unica app. Prova gratuita di 14 giorni, senza carta di credito.

Inizia la prova gratuita →