API Tools le permite obtener datos sin procesar en sus sistemas de análisis, lo que le ayuda a analizar mejor a los usuarios y a mejorar su mapa de recorrido del cliente (CJM). Esta opción ayuda a probar nuevas funcionalidades, a analizar el rendimiento de los productos y a hacer previsiones sobre el estado financiero de la aplicación.
Claves API
Para encontrar la lista de Claves API, vaya a Atribución > Herramientas API. En esta página, puede ver lo siguiente:
🔎 Puede añadir hasta 3 API-keys.
Demo API-keys:
Puede utilizar cualquiera de estas API-keys para obtener datos de instalaciones, eventos y conversiones. Cada una de estas solicitudes tiene sus propias condiciones.
Obtener instalaciones
Cabecera: API-KEY
Parámetros:
pagination.limit (uint) - límite.
pagination.offset (uint) - desplazamiento.
time_window.from_rfc3339 (cadena) - ejemplo:2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - marca de tiempo - prioridad más alta que from_rfc3339.
time_window.from_not_include bool - si está marcada "time > from" si no "time >= from".
time_window.to_rfc3339 (cadena) - ejemplo:2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - marca de tiempo - mayor prioridad que to_rfc3339.
non_organic_only (booleano).
Todos los campos son opcionales. Ordenar por created_at asc siempre. No se pueden añadir nuevos eventos con menos created_at.
Ejemplo de respuesta de la API:
{ "info": [ { "device": { "affise_device_id": "310d8335-80b1-4849-8925-ef54126004af", "random_user_id": "b2080f39-f9e1-4f7e-bc42-8863dfe028d5", "first_open_time": { "segundos": 1696156153 }, "app_id": 1, "affise_pkg_app_name": "com.itbxp.surf", "partner_id": 10, "device_parameters": { "platform": "android", "device_name": "5058", "device_type": "smartphone", "os_name": "Nougat", "os_version": "7.0", "android_id": "421a9e99321086d6", "gaid_adid": "d8313cad-070f-4c0e-824f-bb58d7be5acf", "referrer": "referrer=4107abce-890d-4098-b83b-01d9bdc195d4&clickid=651949b9660c680001ef66c8&pid=10" }, "click_affise": { "click_id": "4317abce-990d-4098-b83b-01d9bdc195d4", "created_at": { "segundos": 1696156090 }, "subs": {}, "geo": { "country": "ID", "region": "Jawa Timur", "city": "Tamansari", "isp": "?" }, "ip": "2001:448a:5139:1985:5d62:4fe6:118d:9c12", "user_agent": "Mozilla/5.0 (Linux; Android 7.0; 5058 Build/NRD90M; wv) AppleWebKit/537.36 (KHTML, como Gecko) Version/4.0 Chrome/117.0.0.0 Mobile Safari/537.36 agentweb/4.0.2 UCBrowser/11.6.4.950", "pub_click_id": "652949b9660c680001ef66c8" } }, "uuid": "924ee319-6e6d-44f3-9449-08d4b4dd1300", "timestamp": { "segundos": 1696156248 }, "geo": { "country": "ID", "region": "ID", "isp": "IND TELKOMSEL" }, "ip": "2001:448a:2130:1985:5d62:4fe6:118d:9c12", "created_at": { "segundos": 1696156279 } }
Obtener eventos
Cabeceras: API-KEY
Parámetros:
pagination.limit (uint) - límite.
pagination.offset (uint) - desplazamiento.
time_window.from_rfc3339 (cadena) - ejemplo:2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - marca de tiempo - prioridad más alta que from_rfc3339.
time_window.from_not_include bool - si está marcada "time > from" si no "time >= from".
time_window.to_rfc3339 (cadena) - ejemplo:2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - marca de tiempo - mayor prioridad que to_rfc3339.
non_organic_only (booleano).
Todos los campos son opcionales. Ordenar por created_at asc siempre. No se pueden añadir nuevos eventos con menos created_at.
Ejemplo de respuesta de la API:
{ "eventos": [ { "info": { "device": { "affise_device_id": "8f29848f-ecfa-49f2-93a7-d2d484a13515", "random_user_id": "071dcb20-1826-47ff-a310-e84ab4a673a1", "first_open_time": { "segundos": 1696122018 }, "app_id": 1, "affise_pkg_app_name": "com.itbxp.surf", "is_organic": true, "device_parameters": { "platform": "android", "device_name": "i55C", "device_type": "smartphone", "os_name": "Nougat", "os_version": "7.0", "android_id": "e627c254f84cd9a9", "gaid_adid": "0ed20689-2435-4816-ab58-e2bc03639ecb", "referrer": "referrer=8ba10af2-4cc9-4cda-806f-47181d47fcef&clickid=65176bfb55c3260001bad183&pid=10" } }, "uuid": "0f8e8e41-3b1e-4981-b36d-f919dc15f7ca", "timestamp": { "segundos": 1696122034 }, "geo": { "country": "ID", "region": "ID", "isp": "Indosat Ooredoo" }, "ip": "2001:448a:3041:2d33:b900:e218:be45:ae55", "created_at": { "segundos": 1696122079 } }, "created_at": { "segundos": 1696122079 }, "id": "afbcac17-4a0a-4df8-9acd-d0b7706185b9", "name": "ContentItemsView", "category": "native", "timestamp": { "seconds": 1696122019 }, "user_data": "shortcuts", "data":"{\"affise_event_content_items_view":[{\"title\":\"News\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32107\"},{\"title\":\"Kids\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32102\"},{\"title\":\"Goods\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32100\"},{\"title\":\"Utilities\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32110\"},{\"title\":\"Fun\",\"url\":\"https://appspress.g2afse.com/click?pid=127\&offer_id=32098\"},{\"title\":\"Food\",\"url\":\"https://appspress.g2afse.com/click?pid=127\&offer_id=32097\"}]}" }
Obtener conversiones
Cabeceras: API-KEY
Parámetros:
pagination.limit (uint) - límite.
pagination.offset (uint) - desplazamiento.
time_window.from_rfc3339 (cadena) - ejemplo:2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - marca de tiempo - prioridad más alta que from_rfc3339.
time_window.from_not_include bool - si está marcada "time > from" si no "time >= from".
time_window.to_rfc3339 (cadena) - ejemplo:2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - marca de tiempo - mayor prioridad que to_rfc3339.
non_organic_only (booleano).
Todos los campos son opcionales. Ordenar por created_at asc siempre. No se pueden añadir nuevos eventos con menos created_at.
⚠️ El ejemplo incluye valores adicionales que puede obtener si los pasa a través del referrer.
{ "conversiones": [ { "evento": { "info": { "dispositivo": { "affise_device_id": "6f9491d3-000a-1000-0f45-58674f4c7485", "random_user_id": "6f9000ee-018a-1000-8c19-58a34e8a8d72", "first_open_time": { "segundos": 1694089122, "nanos": 256000000 }, "app_id": 129, "affise_pkg_app_name": "com.affise.app", "device_parameters": { "platform": "android", "device_name": "sdk_gphone_x86_64", "device_type": "smartphone", "os_name": "Android11", "os_version": "11", "android_id": "b6ea55ccaee29142", "referrer": "referrer=4c5a6cff-4a76-4518-b2b7-a9d21abbd8ca&clickid=640f91362bc1a20001646bd7&pid=85" }, "click_affise": { "click_id": "4c9a6cff-4a76-4518-b2b7-a9d90abbd0ca", "created_at": { "seconds": 1694089122 }, "subs": { "sub1": "s1", "sub2": "s2", "sub3": "s3", "sub4": "s4", "sub5": "s5" }, "geo": { "country": "UK" }, "ip": "127.0.0.1", "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36", "campaign_id": "123", "campaign_name": "cname", "network_id": "123", "network_name": "nname", "tracker_id": "123", "tracker_name": "tname", "creative_id": "123", "pub_click_id": "640f91362bc1a20001646bd7", "partner_name": "pname" } }, "uuid": "f5a01792-018a-1000-bd27-633c0f2d5839", "timestamp": { "segundos": 1696338024 }, "geo": { "country": "US", "region": "US" }, "ip": "188.17.96.239", "user_agent": "Dalvik/2.1.0 (Linux; U; Android 11; sdk_gphone_x86_64 Build/RSR1.201211.001)", "created_at": { "segundos": 1696338042, "nanos": 67913469 } } }, "created_at": { "segundos": 1696338026 }, "id": "5c8791a4-3a4f-41aa-9319-225a30f847e5", "conversion_type": "install", "currency": "USD" } ]}{
Probar clave API
Para probar una clave API, haga lo siguiente:
Seleccione Probar instalaciones, Probar eventos o Probar conversiones.
En la lista desplegable API-KEY, seleccione una API-key determinada.
En el filtro Periodo, especifique el periodo.
Si sólo desea obtener eventos no orgánicos, haga clic en la casilla Sólo no orgánicos.
Haga clic en Solicitar.
Es posible que obtenga la siguiente respuesta
Errores de devolución
En la pestaña Errores de postbacks, puede comprobar los registros de los postbacks que envió su anunciante.
Por favor, póngase en contacto con el equipo de Atención al Cliente de Affise en relación con todas las cuestiones planteadas a través del correo electrónico: [email protected].