API de informes de Remerge

Remerge es una plataforma de retargeting de aplicaciones. Además de nuestro panel de control y de nuestras capacidades analíticas, los clientes pueden obtener informes basados en JSON de la API de informes de Remerge de sus campañas activas para su internal Business Intelligence (BI) diariamente.

Ten en cuenta lo siguiente: 

• SOLO se puede acceder a la API de informes de Remerge a través de la Terminal (o mediante una API) de la siguiente manera:
  
  
  • Terminal: Esta opción requiere que se use la herramienta de transferencia de datos Curl, conforme a los ejemplos de Solicitud de inicio de sesión (tu gerente de cuenta de Remerge debería brindarte las credenciales) y de Solicitud POST que figuran a continuación.
  • API: Los clientes pueden emplear su API interna y sus herramientas de transferencia de datos.
    
    
• NO se puede acceder a la API de informes de Remerge desde un navegador web.
• Remerge almacena tus datos SOLO durante un período limitado de seis meses. Por lo tanto, para mitigar una posible situación en la que desees obtener datos anteriores a dicho período, te recomendamos que lleves tu propio registro de datos.

El rendimiento del cliente se desglosa en cinco dimensiones: Marca horaria, País, Aplicaciones, Campaña y Anuncios relacionados. Por lo tanto, los resultados se pueden importar con facilidad, dividir en partes más pequeñas y distribuirse de conformidad con las dimensiones provistas a cualquier plataforma de Inteligencia empresarial que elija el cliente. Consulta la sección Índice abajo para obtener más detalles sobre parámetros y campos específicos.

Endoint

Se puede acceder a la API mediante el siguiente endpoint:

 https://api.remerge.io/report

Parámetros de solicitud

La API de informes de Remerge provee una interfaz simple para consultar los datos. Los únicos parámetros requeridos son la fecha de inicio y de finalización. 

Ten en cuenta lo siguiente: Para obtener los datos de ayer, debes asegurarte de seleccionar la fecha de hoy como tu end_date, por ejemplo, para recibir los datos del 2021-12-08, establece 2021-12-08 como tu start_date y 2021-12-09 como tu end_date.

Una solicitud válida se debería ver de la siguiente manera: https://api.remerge.io/report?start_date=2017-01-10&end_date=2017-01-11&dimensions=campaign,ad

Nota:

• Te recomendamos utilizar un programa de edición de texto (tal como Sublime o Atom) para garantizar que se transfieran a la terminal todos los símbolos de tu consulta de manera correcta.
• A menos que limites las dimensiones en tu URL de solicitud, la respuesta generará todas las dimensiones potenciales.

Autorización

Ejemplo

Solicitud de inicio de sesión

curl -H 'Content-Type: application/json' -H 'Accept: application/json' -X POST -d '{"user" : { "email" : "your@email.com", "password": "password"}}' https://api.remerge.io/users/sign_in

Devolución del token requerido como JSON

{"email":"your@email.com","token":"J-QeJxyza7JH19QUDb4","user_id":1234,"user_name":"Peter Example","user_token":"J-QeJ49Yasdf219QUDb4"}

Encabezados obligatorios de la solicitud para una solicitud de informe válida

Solicitud de ejemplo

A continuación hay un ejemplo de una solicitud  POST para la API de informes de Remerge que usa la herramienta de transferencia de datos curl:

curl -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Authorization: Token user_token="xxXxxXXXXXXx-xXxxXXX", email="example@mydomain.com"' -X POST "https://api.remerge.io/report?start_date=2022-01-01&end_date=2022-01-02&dimensions=audience%2Ccountry%2Ccampaign%2Cad%2Cad_label%2Cplatform"

Campos de respuesta

La respuesta devuelve un objeto JSON que tiene un array de resultados y un numero de elementos. Cada elemento del array consta de los siguientes campos:

Respuesta de ejemplo de JSON (dos opciones de visualización de la misma consulta)

Opción 1: 

Opción 2: 

Si no hay datos para el intervalo dado, la solicitud devuelve un conjunto de resultados vacío y cuenta: 0

Lista de posibles errores 

Índice

* Marca horaria de la API:  La start_date y la end_date se establecen por defecto en 00:00 de la medianoche de ese día. Esto significa que, por ejemplo, si deseas consultar un día en particular, debes usar ese día como start_date y el día siguiente como end_date. Asegúrate de solicitar SOLO un día de datos a la vez. Por ejemplo, cada día, solicita los datos de ayer y guárdalos en tu base de datos interna.

** Asegúrate de separar tu informe por campaña después de emplear diferentes monedas para distintas campañas.

*** Remerge usa el término Audiencia en referencia a toda tu aplicación móvil (a diferencia de algunos contextos, en los que una audiencia se refiere a un segmento). Al extraer un informe, la API de informes de Remerge devolverá un campo llamado Audiencia. Esto significa que dicho informe contiene datos estáticos para toda tu aplicación.

**** En el caso de los anuncios dinámicos, la URL de las creaciones que se muestra es solo un marcador de posición, ya que las URL de las creaciones reales se toman de manera dinámica de la fuente. Lamentablemente, no se pueden mostrar en este informe.