Ir al contenido principal
Todas las colecciones
Herramientas API
Herramientas API
Daria Mamchenkova avatar
Escrito por Daria Mamchenkova
Actualizado hace más de 7 meses

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:

  • La lista de API-keys, que puede añadir, eliminar y regenerar:

🔎 Puede añadir hasta 3 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:

  1. Seleccione Probar instalaciones, Probar eventos o Probar conversiones.

  2. En la lista desplegable API-KEY, seleccione una API-key determinada.

  3. En el filtro Periodo, especifique el periodo.

  4. Si sólo desea obtener eventos no orgánicos, haga clic en la casilla Sólo no orgánicos.

  5. 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].

¿Ha quedado contestada tu pregunta?