API Tools позволяет получать необработанные данные в системах аналитики, что помогает лучше анализировать пользователей и улучшать карту их путешествий (Customer Travel Map, CJM). Опция помогает тестировать новую функциональность, анализировать производительность продукта и делать прогнозы о финансовом состоянии приложения.
Ключи API
Чтобы найти список ключей API, перейдите в раздел " Атрибуция" > "Инструменты API". На этой странице вы можете увидеть следующее:
Список API-ключей, которые вы можете добавлять, удалять и регенерировать:
🔎 Вы можете добавить до 3 API-ключей.
Демо-версии API-ключей:
Вы можете использовать любой из этих API-ключей для получения данных об установках, событиях и конверсиях. Каждый из этих запросов имеет свои условия.
Получить установки
Заголовки: API-КЛЮЧ
Параметры:
pagination.limit (uint) - лимит.
pagination.offset (uint) - смещение.
time_window.from_rfc3339 (string) - пример:2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - временная метка - более высокий приоритет, чем from_rfc3339.
time_window.from_not_include bool - если отмечено "time > from", иначе "time >= from".
time_window.to_rfc3339 (строка) - пример:2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - временная метка - более высокий приоритет, чем to_rfc3339.
non_organic_only (boolean).
Все поля являются необязательными. Порядок по created_at asc всегда. Новые события с меньшим значением created_at не могут быть добавлены.
Пример ответа API:
{ "info": [ { "device": { "affise_device_id": "310d8335-80b1-4849-8925-ef54126004af", "random_user_id": "b2080f39-f9e1-4f7e-bc42-8863dfe028d5", "first_open_time": { "seconds": 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": { "seconds": 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, like 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": { "seconds": 1696156248 }, "geo": { "country": "ID", "region": "ID", "isp": "IND TELKOMSEL" }, "ip": "2001:448a:2130:1985:5d62:4fe6:118d:9c12", "created_at": { "seconds": 1696156279 } }Получение событий
Заголовки: API-KEY
Параметры:
pagination.limit (uint) - лимит.
pagination.offset (uint) - смещение.
time_window.from_rfc3339 (string) - пример:2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - временная метка - более высокий приоритет, чем from_rfc3339.
time_window.from_not_include bool - если отмечено "time > from", иначе "time >= from".
time_window.to_rfc3339 (строка) - пример:2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - временная метка - более высокий приоритет, чем to_rfc3339.
non_organic_only (boolean).
Все поля являются необязательными. Порядок по created_at asc всегда. Новые события с меньшим значением created_at не могут быть добавлены.
Пример ответа API:
{ "events": [ { "info": { "device": { "affise_device_id": "8f29848f-ecfa-49f2-93a7-d2d484a13515", "random_user_id": "071dcb20-1826-47ff-a310-e84ab4a673a1", "first_open_time": { "seconds": 1696122018 }, "app_id": 1, "affise_pkg_app_name": "com.itbxp.surf", "is_organic": true, "device_parameters": { "platform": "android", "device_name": "i55C", "device_type": "смартфон", "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": { "seconds": 1696122034 }, "geo": { "country": "ID", "region": "ID", "isp": "Indosat Ooredoo" }, "ip": "2001:448a:3041:2d33:b900:e218:be45:ae55", "created_at": { "seconds": 1696122079 } }, "created_at": { "seconds": 1696122079 }, "id": "afbcac17-4a0a-4df8-9acd-d0b7706185b9", "name": "ContentItemsView", "category": "native", "timestamp": { "seconds": 1696122019 }, "user_data": "shortcuts", "data":"{\"affise_event_content_items_view\":[{\"title\":\"Новости\",\"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\"}]}" }Получить конверсии
Заголовки: API-KEY
Параметры:
pagination.limit (uint) - лимит.
pagination.offset (uint) - смещение.
time_window.from_rfc3339 (string) - пример:2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - временная метка - более высокий приоритет, чем from_rfc3339.
time_window.from_not_include bool - если отмечено "time > from", иначе "time >= from".
time_window.to_rfc3339 (строка) - пример:2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - временная метка - более высокий приоритет, чем to_rfc3339.
non_organic_only (boolean).
Все поля являются необязательными. Порядок по created_at asc всегда. Новые события с меньшим значением created_at не могут быть добавлены.
⚠️ Пример включает дополнительные значения, которые можно получить, если передать их через реферер.
{ "conversions": [ { "event": { "info": { "device": { "affise_device_id": "6f9491d3-000a-1000-0f45-58674f4c7485", "random_user_id": "6f9000ee-018a-1000-8c19-58a34e8a8d72", "first_open_time": { "seconds": 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": "смартфон", "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": { "seconds": 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": { "seconds": 1696338042, "nanos": 67913469 } } }, "created_at": { "seconds": 1696338026 }, "id": "5c8791a4-3a4f-41aa-9319-225a30f847e5", "conversion_type": "install", "currency": "USD" } ]}{Попробовать API-ключ
Чтобы попробовать API-ключ, выполните следующие действия:
Выберите пункт Попробовать установки, Попробовать события или Попробовать конверсии.
В раскрывающемся списке API-KEY выберите определенный API-ключ.
В фильтре Период укажите период.
Если вы хотите получить только неорганические события, установите флажок Только неорганические.
Нажмите кнопку Запросить.
Вы можете получить следующий ответ:
Ошибки постбэка
На вкладке Ошибки постбэков вы можете проверить журналы постбэков, которые отправил ваш рекламодатель.
По всем возникающим вопросам обращайтесь в службу поддержки клиентов Affise по электронной почте: [email protected].