A continuación encontrará algunas preguntas y respuestas frecuentes sobre la Events API y la Postback API (interfaz de programación de aplicaciones).

¿En qué se diferencia la Events API del informe de optimización de medios?

La Events API utiliza un sistema integral optimizado para acelerar el procesamiento de los datos y garantizar que las notificaciones de las transacciones se produzcan en menos de diez minutos. El informe de optimización de medios utiliza el enfoque de flujo de datos tradicional antes de que los datos estén disponibles para la elaboración de informes.

¿Qué transacciones están disponibles a través de la Events API?

La Events API incluye todas las transacciones que se comunican a nuestra red. Dado que ofrecemos a los anunciantes la posibilidad de notificar las transacciones mediante los servicios web empresariales, píxeles y métodos de carga por lotes, el tiempo que lleve procesar las transacciones cargadas mediante procesos por lotes influirá en el momento en que los datos estén disponibles en la API (interfaz de programación de aplicaciones).

¿Qué campos de datos están disponibles a través de la Events API?

La API (interfaz de programación de aplicaciones) incluye los siguientes campos de datos de transacción; haga clic en el signo + para ver las descripciones y las notas:

etransaction_id

Descripción: este campo, también denominado TID, es un identificador único para cada transacción dentro de un pedido.

Notas: campo alfanumérico. Si un consumidor hizo una compra que contenía tres SKU diferentes, la API (interfaz de programación de aplicaciones) devolverá tres registros, uno por cada SKU. Los tres registros compartirán un valor «order_id», pero el «etransaction_id» será único para cada registro.

advertiser_id

Descripción: este campo, también denominado MID (identificación del anunciante), es el único identificador del anunciante.

Notas: campo numérico

SID (número de identificación de la página web)

Descripción: este campo es el único identificador del publicador.

Notas: campo numérico

order_id

Descripción: este campo indica el número de pedido único de los anunciantes para el pedido.

Notas: campo numérico

offer_id

Descripción: este campo, también denominado OID, indica el identificador de la oferta sobre la que se comisionó la transacción.

Notas: campo numérico.

sku_number

Descripción: este campo indica el SKU del artículo.

Notas: campo alfanumérico. Este dato solo está disponible si el anunciante lo notifica.

sale_amount

Descripción: este campo es el importe que el consumidor pagó por el artículo del pedido.

Notas: campo numérico

quantity

Descripción: este campo indica la cantidad del artículo comprado.

Notas: campo numérico

commissions

Descripción: este campo indica la comisión base total para esta transacción.

Notas: campo numérico

transaction_date

Descripción: este campo es la fecha y hora en que se hizo el pedido en el sitio web del anunciante.

Notas: campo con formato de fecha y hora.

process_date

Descripción: este campo es la fecha y la hora en que Rakuten Advertising procesó esta transacción. La zona horaria es GMT.

Notas: campo con formato de fecha y hora.

transaction_type

Descripción: este campo designa si la transacción es en tiempo real o por lotes.

Notas: campo alfanumérico.

product_name

Descripción: este campo indica el nombre del artículo comprado o devuelto.

Notas: campo alfanumérico.

u1

Descripción: se trata de un campo que usted define y que le permite hacer referencia a un valor concreto de la campaña o del miembro. Se refiere a su &u1=parameter.

Notas: campo alfanumérico.

currency

Descripción: la divisa del importe de venta de la transacción.

Notas: campo alfanumérico.

is_event

Descripción: este campo designa si la transacción en tiempo real es un evento o una transacción.

Notas: campo S o N.

Evento: estas transacciones tienen la finalidad de servir como indicador de que se ha producido una transacción que puede eliminarse tras la revisión del anunciante y finalizarse a través de la carga por lotes. NO debe utilizar estas transacciones para determinar su pago final de comisiones. Si se omite, podrían producirse errores en los informes.

Transacción: estas transacciones ya han finalizado, por lo que puede contabilizarlas como transacciones que se pagarán mientras no se produzcan cancelaciones.

¿Cuál es la latencia de datos prevista?

El SLA para que las transacciones estén disponibles a través de Events API es de 10 minutos.

¿Qué significa el indicador «is_event»?

Los anunciantes que utilizan el proceso por lotes para cargar transacciones pueden facilitar a los publicadores información direccional sobre las transacciones utilizando el píxel de optimización de medios de Rakuten Affiliate. Las transacciones notificadas a través del píxel de optimización de medios se indican en los resultados con el valor Y. No debe utilizar estas transacciones para determinar las comisiones totales que recibirá. Es importante tener en cuenta que estos datos solo están disponibles para los anunciantes a los que se ha habilitado el informe de optimización de medios.

Para más información sobre la finalidad del parámetro is_event=<is_event> y cómo interpretar sus datos, consulte la guía de transacciones de la Events API en el Developer Portal.

¿Con qué frecuencia puedo consultar el servicio?

La frecuencia de las llamadas al servicio estará determinada por el nivel que haya seleccionado en el Developer Portal de la API (interfaz de programación de aplicaciones) durante el proceso de suscripción.

¿Puedo recibir notificaciones push de transacciones y eventos cuando se produzcan (Postback)?

Sí, puede registrar una URL a través de la Postback API (interfaz de programación de aplicaciones). Estos datos y su formato serán los mismos que los que se incluyen en la Pull API (interfaz de programación de aplicaciones).

Los Postbacks pueden admitir URL dinámicas, lo que le permite personalizar la salida de su Postback. Para más información sobre los campos disponibles y la personalización de la URL del Postback, consulte el Developer Portal.

¿Por qué la Events API no notifica algunas transacciones?

La Events API notifica tanto las transacciones como los eventos que se comunican a Rakuten Affiliate a través de los servicios web empresariales y por lotes. No verá las transacciones que se notifiquen a Rakuten Affiliate mediante cualquier método de carga por lotes dentro de la misma línea de tiempo que la notificada a través de los servicios web empresariales.

¿Por qué la Events API incluye datos diferentes a los de otros informes?

La Events API notifica tanto las transacciones como los eventos que se comunican a Rakuten Affiliate a través de los servicios web empresariales y por lotes. No verá las transacciones que se notifiquen a Rakuten Affiliate mediante cualquier método de carga por lotes dentro de la misma línea de tiempo que la notificada a través de los servicios web empresariales. Además, para garantizar la velocidad, hemos limitado el volumen de datos de clics almacenados a 30 días. Por lo tanto, para las transacciones que son el resultado de clics que tienen más de 30 días, la Events API no tendrá un valor u1 asociado a la transacción.

¿Cómo funcionan las cancelaciones? ¿Cómo se verán en la Events API?

Las cancelaciones en la Events API se verán de la misma manera que en otras herramientas de informes. La fecha de transacción y el número de pedido coincidirán con la transacción original. La fecha de procesamiento será la fecha de la cancelación. Algunos valores, como «commissions» y «sales_amount», serán negativos.