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 un cliente API) de la siguiente manera:
  
  
  • Mediante la Terminal, requiere el uso de 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 proveerte las credenciales) y de Solicitud POST que figuran a continuación.
  • Los clientes también pueden emplear su propia API interna y sus herramientas de transferencia de datos.
    
    
• NO se puede acceder a la API de informes de Remerge desde un navegador web.

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. Para obtener información adicional sobre los parámetros y los campos específicos, te recomendamos que consultes la  sección Índice que se encuentra más abajo.

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.

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="HJn4OYViZv", email="example@mydomain.com"' -X POST "https://api.remerge.io/report?start_date=2017-01-10&end_date=2017-01-11" -v

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: 

{results: [{"timestamp":"2017-01-11T00:00:00.000Z","event":{"impressions":2,"audience":"12345678","app_open_rate":1.0,"clicks":1,"ad":"test.jpg","user_id":2,"conversions":1,"campaign":"42","country":"de","cost":0.12,"campaign_name":"Test Campaign"}}],count: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, solicita todos los días los datos de ayer y guárdalos en tu base de datos interna).

** Asegúrate de separar tu informe por campaña, en el caso de que estés empleando 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, simplemente, 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.