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.
Nombre | Contenido | Ejemplos | Obligatorio |
---|---|---|---|
*start_date | Fecha de inicio del informe (AAAA-MM-DD) | 2017-01-09 | x |
*end_date | Fecha de finalización del informe (AAAA-MM-DD) | 2017-01-10 | x |
dimensions |
Una lista de las dimensiones separadas por comas que desglosa los agregados por defecto para audiencia, país, campaña y anuncio (si no se pasa el parámetro). Dimensiones posibles: audiencia, país, campaña, anuncio, etiqueta de anuncio o plataforma. |
country, platform |
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
Nombre | Contenido | Ejemplo | Obligatorio |
---|---|---|---|
Request Header | Tipo de contenido | 'Content-Type: application/json' | x |
Request Header | Aceptación | 'Accept: application/json' | x |
Request Header | Token de autorización | 'Authorization: Token user_token="HJn4OYViZv", email="example@mydomain.com"' | x |
Request Type | POST | POST | x |
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:
Nombre | Contenido | Ejemplo | |
---|---|---|---|
timestamp | Marca horaria en UTC | 2017-01-11T00:00:00.000Z | |
event.platform | Plataforma (iOS /Android) | ios | |
event.country | Geoinformación de la puja en tiempo real | de | |
event.campaign | ID interna de la campaña de Remerge | 42 | |
event.campaign_name | Nombre externo de la campaña de Remerge | Test Campaign | |
**event.cost_currency | Moneda de la campaña interna de Remerge | EUR | |
***event.audience | Identificador de la App Store | 12345678 | |
event.ad_id | ID de las creaciones | 1406561 | |
event.ad_name | El nombre de archivo no depurado del activo de imágenes/videos | banner_300_50.png | |
event.ad_label_id | ID de la etiqueta de las creaciones | 18304 | |
event.ad_label_name | Nombre de la etiqueta de la creacion | non_purchasers_it | |
****event.ad_creative_url | URL de las creaciones | https://assets.remerge.io/ad_assets/files/000/006/696/original/banner_300_50.png?1478088208 | |
event.impressions | Contador de impresiones diarias en App.Country.Campaign.Ad Level | 2 | |
event.clicks | Contador de clics diarios en App.Country.Campaign.Ad Level | 1 | |
event.app_open_rate | Recuento en porcentaje de aplicaciones que se abrieron por clics | 83,57 | |
event.cost | Costo en la moneda del cliente en App.Country.Campaign.Ad Level | 0,12 | |
event.conversions | Contador de conversiones diarias en App.Country.Campaign.Ad Level | 1 | |
event.ap_conversions | Contador de conversiones atribuidas diarias en App.Country.Campaign.Ad Level | 5 | |
event.unique_user | Contador de usuarios únicos diarios en App.Country.Campaign.Ad Level | 2 |
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
Estado | Mensaje | Explicación |
---|---|---|
200 | OK | Resultados de la consulta devueltos como JSON |
401 | No autorizado | El token de autorización provisto no es válido |
422 | start_date: Se requiere el formado AAAA-MM-DD | Formato de la fecha de inicio inadecuado |
422 | end_date: Se requiere el formato AAAA-MM-DD | Formato de la fecha de finalización inadecuado |
422 | start_date: Debe ser una fecha válida | No se proporcionó una fecha real, como 2015-33-09 |
422 | end_date: Debe ser una fecha válida | No se proporcionó una fecha real, como 2015-33-09 |
422 | end_date: La fecha de finalización debe ser posterior a la fecha de inicio o igual a esta | La fecha de finalización es anterior a la fecha de inicio |
422 | queryID: Ya existe queryId | El usuario ya ha enviado una solicitud que la API todavía está procesando, es decir, el límite de tasa de consultas por usuario es 1. |
504 | Inactividad en el puerto de enlace | El servidor web demoró demasiado tiempo en procesar la solicitud. Por lo general, esto se debe a un intervalo de consulta demasiado amplio. En este caso, vuelve a intentarlo con un intervalo de 14 días, como máximo. |
Í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.