Documentazione: Tracciamento - AffiliationSoftware

Tracciamento

Tracciamento

 

Il codice di tracciamento consente al tuo network di affiliazione di riconoscere se un’azione è stata riferita da un affiliato e di assegnargli la rispettiva commissione. Per tracciare le conversioni generate dagli affiliati in modo automatico bisogna inserire il codice di tracciamento nella “thank you page” del sito.

Come tracciare le conversioni

14.1 Come funziona il tracciamento

Il codice di tracciamento è simile al monitoraggio delle conversioni di Google Adwords. Serve a riconoscere automaticamente se l‘azione (come una vendita o un’iscrizione) proviene da un affiliato iscritto al tuo network di affiliazione e assegnargli la rispettiva commissione. 

Il codice di tracciamento va inserito nella “thank you page” del sito, ovvero la pagina che vede l’utente subito dopo aver completato l’azione.

Il codice di tracciamento, denominato anche “Pixel di tracciamento”, consiste in un codice HTML che è invisibile agli utenti. L'importo delle commissioni viene calcolato tenendo conto dell’importo della vendita e del segmento di commissioni assegnato all’affiliato.

Puoi generare i tuoi codici di tracciamento (pixel o postback) dalla pagina:
Pannello admin > Impostazioni > Tracciamento

 

Tracciare le conversioni su un sito o un e-commerce
Se devi tracciare le conversioni su un sito o un ecommerce puoi verificare se è compatibile con AffiliationSoftware nel capitolo successivo. Se è compatibile ti basta contattarci e richiedere le istruzioni per inserire il tuo pixel di tracciamento. Se non è compatibile invece leggi la “Soluzione generale di tracciamento”.

Tracciare le conversioni su una piattaforma / network
Se ti appoggi a un'altra piattaforma o a un network di affiliazione, puoi inserire il pixel o il postback direttamente su quest’ultima. Se la piattaforma o il network è compatibile con AffiliationSoftware puoi contattarci e richiedere le istruzioni per inserire il tuo codice di tracciamento. Se non è compatibile puoi seguire la documentazione della piattaforma a cui ti appoggi.

Tracciamento manuale delle conversioni
Se non è possibile integrare il codice di tracciamento, l'unica alternativa é inserire manualmente le transazioni in base a quelle che risultano nei report. Per aiutarsi si può usare l'indirizzo IP del click, o aggiungere nei banner/link un parametro identificativo dell'affiliato o un suo subID, che verrà mostrato nei report.


14.2 SITI compatibili

Questa lista include E-commerce, CMS, piattaforme e network di affiliazione che sono compatibili con il sistema di tracciamento automatico di AffiliationSoftware (in ordine alfabetico).

2CheckOut (2CO)
3DCart
Ad4game
Addiliate
Adpump
Adsbridge
AffiliationSoftware
Affise
AMember
Aruba
AWeber
Awin
BigCommerce
Bookeo
Cake
Chargebee
Clickpoint
Commission Junction
Contact Form 7 (wordpress)

Cpalead
Createjoy
Easy digital download (wordpress)
ECWID e ECWID su WIX
FrameCommerce
GetResponse
Google Tag Manager
Hasoffers
HikaShop (Joomla)
Incomedia Website x5
Kajabi
Landingi
LeadPages
Magento
Memberpress (wordpress)
NetAffiliation
NewCart
OpenCart
OSCommerce

PayPal
PayPal DT (Data Transfer)
PayPal IPN (Instant Payment Notification)
PostAffiliate
PrestaShop
Rezgo
Shopify
Shopware
Stripe
Tradedoubler
Tradetracker
UberCart (Drupal)
VirtueMart (Joomla)
Voluum
WebNode
WooCommerce (wordpress)
Wordpress
ZenCart

Vedi tutti i siti compatibli

Se utilizzi un sito compatibile con AffiliationSoftware ti basta contattarci. Ti invieremo un email con delle istruzioni apposite, che spiegano come integrare il codice di tracciamento nel tuo sito.

Richiedi istruzioni

AffiliationSoftware è compatibile con il 99% dei siti web. Se il tuo sito non è presente in questa lista, oppure se sei uno sviluppatore web, ti consigliamo di consultare la soluzione generale per integrare il codice di tracciamento.

Soluzione generale


14.3 Soluzione generale 

La soluzione generale spiega come integrare il pixel di tracciamento di AffiliationSoftware nella “thank you page” del tuo sito web.

Segui queste istruzioni solo se non hai un sito compatibile con AffiliationSoftware o se sei uno sviluppatore web. Sono richieste conoscenze di HTML.

 

PASSO 1

Genera il codice di tracciamento per la campagna pubblicitaria. Puoi generare il tuo codice di tracciamento andando alla pagina:

Pannello Admin > Impostazioni > Tracciamento

 

PASSO 2

Copia e incolla il codice di tracciamento nella "thank you page" del tuo sito web.

La "thank you page” (pagina di ringraziamento) è la pagina visualizzata dagli utenti subito dopo aver completato un acquisto o un’iscrizione.

Il codice di tracciamento è invisibile agli utenti e può essere inserito in qualunque punto della pagina, tra i tag <body> e </body>.

 

PASSO 3

Se hai impostato commissioni in percentuale inserisci nel parametro "cost" l'importo totale della vendita. È su questo importo che verrà calcolata la percentuale che spetta all'affiliato.

Per riconoscere le conversioni puoi inserire nel parametro "orderid" una stringa identificativa, ad esempio il numero d’ordine o l’email del nuovo iscritto.

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234' width='1' height='1' border='0' />

Puoi valorizzare questi parametri anche dinamicamente, ad esempio con PHP:

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=<?php echo( $importo ); ?>&orderid=<?php echo( $ordineNum ); ?>' width='1' height='1' border='0' />

 

PASSO 4

Finito! Quando un affiliato genera una conversione, AffiliationSoftware lo riconosce e gli assegna automaticamente la rispettiva commissione.

Per verificare il funzionamento del codice di tracciamento puoi fare un test, come spiegato nel capitolo “Risoluzioni dei problemi”.

 

ESEMPIO

Esempio di "thank you page" con integrato il codice di tracciamento di AffiliationSoftware.

<html>
<head>
<title>Grazie per l'acquisto</title>
</head>
<body>
<h1>Grazie per l'acquisto</h1>
<!-- AffiliationSoftware.com - Inizio codice di tracciamento -->
<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234' width='1' height='1' border='0' />
<!-- AffiliationSoftware.com - Fine codice di tracciamento -->
</body>
</html>


14.4 Tracciamento postback

Il Postback URL (chiamato anche "Callback URL" o “Server2server”) è un tipo di tracciamento che serve a connettere il tuo network di affiliazione con altri network o piattaforme compatibili. Al contrario del Pixel, il Postback funziona lato server e non può leggere i dati memorizzati nel PC. Per tracciare con il Postback bisogna passare un parametro nei banner/link e poi recuperarlo nel Postback. Questo parametro, chiamato “TOKEN”, contiene un ID univoco che consente ad AffiliationSoftware di riconoscere l’affiliato e registrargli la commissione.

 

Come creare un tracciamento Postback

Il postback ti consente di tracciare automaticamente le conversioni di una campagna pubblicitaria fornita da un network o una piattaforma di affiliazione.

1. Nel campo “URL di destinazione” di tutti i banner/link della campagna aggiungi:

&SUBID=[token]

2. Nel postback, recupera il valore del TOKEN aggiungendo:

https://esempio.affiliationsoftware.app/script/postback.php?cost=79.95&orderid=ordine1234&c=SUBID

Il parametro “SUBID” va sostituito con quello del network/piattaforma che fornisce la campagna. Si può usare qualsiasi parametro che accetti un valore alfanumerico. Esempio: subid1 o aff_sub1.

 

Come creare un Postback globale

Il postback globale ti consente di tracciare automaticamente le conversioni di tutte le campagne pubblicitarie fornite da un network o una piattaforma di affiliazione.

Il postback di AffiliationSoftware funziona come postback globale senza bisogno di alcuna modifica. Segui le istruzioni sopra per creare un tracciamento Postback globale.


14.5 VARIABILI di tracciamento

Nel codice di tracciamento ci sono diversi parametri che si possono modificare in base alle proprie esigenze. Di seguito viene spiegato a cosa serve ogni parametro.


Campagna (cid)

Inserisci l’ID della campagna a cui collegare il codice di tracciamento. Puoi trovare l’ID della campagna nelle pagine tracciamento e campagne pubblicitarie.

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234' width='1' height='1' border='0' />

ID ordine (orderid)
Inserisci l’ID o il numero della vendita. Questo dato sarà visibile nella colonna “dettagli” della pagina transazioni, sia lato admin che affiliati. Puoi usarlo come riferimento quando convalidi le commissioni.

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234' width='1' height='1' border='0' />

Importo vendita (cost)
Inserisci l’importo totale della vendita. Questo importo viene usato per calcolare le commissioni in percentuale. Questo parametro è obbligatorio se hai impostato commissioni in percentuale, in caso contrario puoi lasciare 1. Usare il punto come separatore decimale. 

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234' width='1' height='1' border='0' />

Deduzioni (d)
È possibile dedurre eventuali costi fissi dall’importo della vendita (cost). Se imposti una deduzione, il calcolo della percentuale verrà effettuato cosi: (importo vendita – deduzioni) * percentuale affiliato.

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&d=6.50' width='1' height='1' border='0' />

Segmento (g)
Se inserito, consente di forzare il tracciamento su uno specifico segmento di commissioni, anche se l’affiliato non vi è assegnato. Utile se la campagna ha più commissioni o più prodotti da tracciare.

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&g=prodotto2' width='1' height='1' border='0' />

Tipo (type)
Se inserito, consente di forzare il tracciamento su un tipo specifico di commissioni. Utile se la campagna ha più tipi di commissioni, come vendita e lead.

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&type=s' width='1' height='1' border='0' />

Note (notes)
Se inserito, consente di memorizzare dei dati a scelta. Questi dati saranno visibili solo nel pannello admin e nascosti negli altri pannelli.

<img src='https://esempio.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&notes=prova' width='1' height='1' border='0' />

Token (c)
Il postback serve a tracciare le conversioni su altri network o piattaforme di affiliazione. Per funzionare il postback necessita di un parametro chiamato “Token”. Il Token va passato nei banner/link e poi recuperato nel postback. Ulteriori informazioni  

https://esempio.affiliationsoftware.app/script/postback.php?cost=79.95&orderid=ordine1234&c=TOKEN


14.6 Risoluzione dei problemi

Prima di avviare una campagna puoi fare un test per assicurarti che sia tutto configurato in modo corretto. Segui queste istruzioni per verificare se il tracciamento è funzionante. Se dopo il test la transazione viene registrata significa che tutto funziona correttamente.

 

Verifica la campagna pubblicitaria

Segui questa procedura per verificare se una campagna pubblicitaria è configurata correttamente.

1. Verifica che nella campagna sia impostata la commissione di 1° livello.

2. Verifica che sia inserito almeno un banner o un link per fare promuovere la campagna agli affiliati 

3. Genera il codice di tracciamento, assicurandoti di aver selezionato la campagna corretta.

4. Verifica di aver inserito il codice di tracciamento nel sito o nella piattaforma che vuoi tracciare.

 

Verifica il tracciamento (pixel)

Segui questa procedura per verificare se il pixel di tracciamento è configurato correttamente.

1. Accedi al Pannello Affiliati, se necessario iscriviti alla campagna e vai alla pagina "Banner e Link".

2. Clicca su un banner/link e verifica che il click venga conteggiato nelle statistiche.

3. Genera il pixel di tracciamento in formato URL, copialo e incollalo nella barra degli indirizzi del browser e verifica che la transazione venga registrata.

4. Se il pixel di tracciamento è inserito nel sito, simula un acquisto (o un’iscrizione) e verifica che la transazione venga registrata.

 

Verifica il tracciamento (postback)

Segui questa procedura per verificare se il postback di tracciamento è configurato correttamente.

1. Verifica che il parametro TOKEN sia inserito in tutti i banner/link della campagna.

2. Accedi al Pannello Affiliati, se necessario iscriviti alla campagna e vai alla pagina "Banner e Link".

3. Copia il link della campagna, aggiungi alla fine &debug e incollalo nella barra degli indirizzi del browser.

4. Verifica che il click venga conteggiato nelle statistiche e copia il TOKEN visualizzato.

5. Genera il postback, copialo e incollalo nella barra degli indirizzi del browser aggiungendo il TOKEN e verifica che la transazione venga registrata.

 

Errori e logs di tracciamento

Se dopo il test la transazione non è stata registrata procedi come segue.

1. Verifica nei logs se il tracciamento è stato richiamato (in base a data e ora). Se non risulta la chiamata assicurati che il tracciamento sia inserito nel sito o nella piattaforma che vuoi tracciare.

2. Verifica nel debug se il tracciamento ha restituito un errore (in base a data e ora). Se restituisce un errore risolvilo modificando le impostazioni della campagna.