Di seguito sono riportate alcune domande e risposte comuni su Events API e Postback API.

In che modo l'Events API è diverso da quello di Report dell'ottimizzazione dei media?

L'Events API sfrutta un sistema end-to-end ottimizzato per accelerare l'elaborazione dei dati, garantendo la trasmissione delle notifiche relative alle transazioni in meno di dieci minuti. Il Report dell'ottimizzazione dei media impiega l'approccio tradizionale alla gestione dei flussi di dati prima che questi vengano resi disponibili per la rendicontazione.

Quali transazioni sono disponibili con l'Events API?

L'Events API include tutte le transazioni che vengono segnalate al nostro network. Poiché offriamo agli advertiser la possibilità di segnalare le transazioni utilizzando i metodi Enterprise Web Service, pixel e caricamento in batch, il tempo necessario per elaborare le transazioni caricate tramite processi batch avrà un impatto su quando i dati saranno disponibili nell'API.

Quali campi di dati sono disponibili mediante l'Events API?

L'API fornisce i seguenti campi di dati della transazione; fare clic sul + per visualizzare le descrizioni e le note:

etransaction_id

Descrizione: questo campo, denominato anche TID, è un ID univoco per ogni transazione all'interno di un ordine.

Note: campo alfanumerico. Se un consumatore ha effettuato un acquisto contenente tre diversi SKU, l'API restituirà tre record, uno per ogni SKU. Tutti e tre i rapporti condivideranno un valore order_id, mentre etransaction_id sarà unico per ogni record.

advertiser_id

Descrizione: questo campo, denominato anche MID, è l'ID unico dell'advertiser.

Note: campo numerico.

sid

Descrizione: questo campo è l'ID unico del publisher.

Note: campo numerico.

order_id

Descrizione: questo campo fornisce l'ID unico dell'ordine degli inserzionisti.

Note: campo numerico.

offer_id

Descrizione: questo campo, denominato anche OID, fornisce l'ID dell'offerta su cui è stata commissionata la transazione.

Note: campo numerico.

sku_number

Descrizione: questo campo fornisce il codice SKU dell'articolo.

Note: campo alfanumerico. Il dato è disponibile solo se segnalato dall'advertiser.

sale_amount

Descrizione: questo campo è l'importo pagato dal consumatore per l'articolo nell'ordine.

Note: campo numerico.

quantity

Descrizione: questo campo contiene la quantità dell'articolo acquistato.

Note: campo numerico.

commissions

Descrizione: questo campo fornisce la commissione base totale per tale transazione.

Note: campo numerico.

transaction_date

Descrizione: questo campo indica la data e l'ora in cui è stato effettuato l'ordine sul sito dell'advertiser.

Note: campo in formato data e ora.

process_date

Descrizione: questo campo indica la data e l'ora in cui tale transazione è stata elaborata da Rakuten Advertising. Il fuso orario è GMT.

Note: campo in formato data e ora.

transaction_type

Descrizione: questo campo indica se la transazione è in tempo reale o in batch.

Note: campo alfanumerico.

product_name

Descrizione: questo campo contiene il nome del prodotto dell'articolo acquistato o restituito.

Note: campo alfanumerico.

u1

Descrizione: si tratta di un campo definito dall'utente che permette di fare riferimento a una campagna o a un valore particolare di un membro. Si riferisce al suo parametro &u1=.

Note: campo alfanumerico.

currency

Descrizione: la valuta dell'importo di vendita per la transazione.

Note: campo alfanumerico.

is_event

Descrizione: questo campo indica se la transazione in tempo reale è un evento o una transazione.

Note: campo Y o N.

Evento: queste transazioni servono come indicatore dell'avvenuta transazione, che può essere eliminata dopo la revisione da parte dell'advertiser e finalizzata tramite il caricamento in batch. NON utilizzare queste transazioni per determinare i pagamenti finali delle commissioni. Il mancato rispetto di questo parametro può causare errori di segnalazione.

Transazione: queste transazioni sono finalizzate, quindi possono essere considerate come transazioni che saranno pagate in attesa di eventuali cancellazioni.

Qual è la latenza dei dati prevista?

Lo SLA per la disponibilità delle transazioni mediante l'Events API è di 10 minuti.

Cosa significa il flag "is_event"?

Gli Advertiser che utilizzano il processo Batch per poter caricare le transazioni, possono fornire ai publisher informazioni direzionali sulle transazioni utilizzando il Pixel di ottimizzazione dei media Rakuten Affiliate. Le transazioni segnalate tramite il Pixel di ottimizzazione dei media sono indicate nei risultati con il valore Y. È consigliabile non utilizzare queste transazioni per calcolare il totale delle commissioni che si riceveranno. È importante notare che questi dati sono supportati solo dagli inserzionisti abilitati per il Report dell'ottimizzazione dei media.

Per maggiori informazioni sullo scopo del parametro is_event=<is_event> e su come interpretarne i dati, consultare la guida alle transazioni Events API nella sezione del Developer Portal.

Con quale frequenza è possibile interrogare il servizio?

La frequenza delle chiamate al servizio sarà determinata dal livello selezionato nell'API del Developer Portal durante il processo di registrazione.

È possibile ricevere notifiche push relative a transazioni ed eventi quando si verificano (postback)?

Sì, è possibile registrare un URL tramite l'API Postback. Questi dati e il loro formato saranno gli stessi forniti dall'API pull.

I postback possono supportare URL dinamici, permettendo la personalizzazione dell'output del proprio postback. Per saperne di più sui campi disponibili e sulla personalizzazione dell'URL di postback, consultare il Developer Portal.

Perché alcune transazioni non vengono segnalate dall'Events API?

L'Events API riporta sia le transazioni che gli eventi segnalati a Rakuten Affiliate utilizzando Enterprise Web Service e Batch. Le transazioni segnalate a Rakuten Affiliate utilizzando un qualsiasi metodo di caricamento in batch non verranno visualizzate nello stesso arco di tempo di quelle segnalate tramite Enterprise Web Service.

Perché l'Events API fornisce dati diversi rispetto ad altri report?

L'Events API riporta le transazioni e gli eventi segnalati a Rakuten Affiliate utilizzando Enterprise Web Service e Batch. Le transazioni segnalate a Rakuten Affiliate con qualsiasi altro metodo di caricamento in batch non verranno visualizzate nello stesso arco di tempo di quelle segnalate tramite Enterprise Web Service. Inoltre, per garantirne la velocità, limitiamo il volume dei dati di clic memorizzati a 30 giorni. Quindi, per transazioni che sono il risultato di clic più vecchi di 30 giorni, Events API non avrà un valore u1 associato alla transazione.

Come funzionano le cancellazioni? Come appariranno nell'Events API?

Le cancellazioni nell'Events API appariranno come in altri strumenti di reportistica. La data della transazione e l'ID ordine corrisponderanno alla transazione originale. La data di elaborazione sarà la data della cancellazione. Alcuni valori, come "commissions" e "sales_amount", saranno negativi.