Abaixo estão algumas perguntas e respostas comuns sobre Events API e Postback API.

Qual é a diferença entre o Events API e o relatório de otimização de mídia?

O Events API utiliza um sistema de ponta a ponta que é otimizado para um processamento mais rápido dos dados, a fim de garantir que as notificações das transações possam ser feitas em menos de dez minutos. O relatório de otimização de mídia usa a abordagem tradicional de fluxo de dados antes que os dados estejam disponíveis para relatório.

Quais transações estão disponíveis por meio do Events API?

O Events API inclui todas as transações que são reportadas à nossa rede. Como oferecemos aos anunciantes a possibilidade de informar transações usando Enterprise Web Services, pixel e métodos de upload em lote, o tempo necessário para processar as transações enviadas por meio de processos em lote afetará o tempo em que os dados estarão disponíveis na API.

Quais campos de dados estão disponíveis pela Events API?

A API disponibiliza os seguintes campos de dados da transação; clique em "+" para descrições e notas:

etransaction_id

Descrição: esse campo, também chamado de "TID", é um ID único para cada transação em um pedido.

Notas: campo alfanumérico. Se um consumidor fez uma compra contendo três SKUs diferentes, a API retornará três registros, um para cada SKU. Todos os três registros compartilharão um valor "order_id", mas o "etransaction_id" será exclusivo para cada registro.

advertiser_id

Descrição: esse campo, também referido comoMID (Número de Identificação do Comerciante), é o ID exclusivo do anunciante.

Notas: campo numérico

sid

Descrição: esse campo é o ID exclusivo do afiliado.

Notas: campo numérico.

order_id

Descrição: esse campo fornece o ID de pedido exclusivo do anunciante para o pedido.

Notas: campo numérico.

offer_id

Descrição: esse campo, também chamado de OID, fornece o ID da oferta na qual a transação foi comissionada.

Notas: campo numérico.

sku_number

Descrição: esse campo disponibiliza o SKU para o item.

Notas: campo alfanumérico. Ele só estará disponível se o anunciante informar.

sale_amount

Descrição: esse campo é o valor que o consumidor pagou por esse item no pedido.

Notas: campo numérico.

quantity

Descrição: esse campo contém a quantidade do item comprado.

Notas: campo numérico.

commissions

Descrição: esse campo fornece a comissão base total para essa transação.

Notas: campo numérico.

transaction_date

Descrição: esse campo é a data e a hora em que o pedido foi feito no site do anunciante.

Notas: campo com formatação de tempo.

process_date

Descrição: esse campo é a data e a hora em que essa transação foi processada pela Rakuten Advertising. O fuso horário é GMT.

Notas: campo com formatação de tempo.

transaction_type

Descrição: esse campo indica se a transação é em tempo real ou em lote.

Notas: campo alfanumérico.

product_name

Descrição: esse campo contém o nome do produto do item comprado ou devolvido.

Notas: campo alfanumérico.

u1

Descrição: esse é um campo que você define e permite fazer referência a uma campanha específica ou a um valor de membro. Ele se refere ao seu &u1=parameter.

Notas: campo alfanumérico.

currency

Descrição: A moeda do valor da venda para a transação.

Notas: campo alfanumérico.

is_event

Descrição: esse campo designa se a transação em tempo real é um evento ou transação.

Notas: campo Y ou N.

Evento: essas transações devem servir como um indicador da ocorrência de uma transação que pode ser eliminada após a análise do anunciante e finalizada por meio de upload de lote. Você NÃO deve usar essas transações para determinar os pagamentos de comissões finais para você. Se isso for ignorado, você poderá ver erros de comunicação.

Transação: essas transações são finalizadas para que você possa contabilizá-las como transações que serão pagas pendentes de cancelamentos.

Qual é a latência de dados esperada?

O SLA (Acordo de Nível de Serviço) para as transações estarem disponíveis por meio do Events API é de 10 minutos.

O que significa a sinalização "is_event"?

Anunciantes que usam o processo em lote para carregar transações podem fornecer aos afiliados informações direcionais sobre transações usando o Rakuten Affiliate Media Optimization Pixel. As transações reportadas através do Media Optimization Pixel são indicadas nos resultados com um valor de Y. Você não deve usar essas transações para determinar o total de comissões que você receberá. É importante observar que esses dados são suportados apenas por anunciantes que estão habilitados para o relatório de otimização de mídia.

Para obter mais informações sobre a finalidade do parâmetro is_event= e como interpretar seus dados, consulte o guia "Events API Transactions" no Developer Portal.

Com que frequência posso consultar o serviço?

A frequência das chamadas de serviço será determinada pelo nível selecionado na API do Developer Portal durante o processo de assinatura.

Posso receber notificações push de transações e eventos quando eles ocorrem (postback)?

Sim, você pode registrar um URL por meio da Postback API. Esses dados e o formato serão os mesmos que os fornecidos na pull API.

Postbacks suportam URLs dinâmicos, permitindo que você personalize a saída de seu postback. Saiba mais sobre os campos disponíveis e a personalização do URL de postback no Developer Portal.

Por que algumas transações não são informadas pelo Events API?

O Events API informa tanto as transações quanto os eventos que são informados à Rakuten Affiliate usando o Enterprise Web Services e o lote. Você não verá as transações informadas à Rakuten Affiliate usando qualquer método de upload em lote dentro da mesma linha do tempo reportada via Enterprise Web Services.

Por que a Events API fornece dados diferentes de outros relatórios?

O Events API reporta transações e eventos que são reportados à Rakuten Affiliate usando o Enterprise Web Services and Batch. Você não verá as transações relatadas à Rakuten Affiliate usando qualquer método de upload em lote na mesma linha do tempo reportada via Enterprise Web Services. Além disso, para garantir a velocidade, nós estamos restringindo o volume de dados de clique armazenados para 30 dias. Portanto, para transações resultantes de cliques com mais de 30 dias, o Events API não terá um valor u1 associado à transação.

Como funcionam os cancelamentos? Como eles aparecerão no Events API?

Os cancelamentos na Events API terão a mesma aparência que eles têm em outras ferramentas de relatórios. A data da transação e o ID do pedido corresponderão à transação original. A data do processo será a data do cancelamento. Alguns valores, como "commissions" e "sales_amount", serão negativos.