As ferramentas de API permitem que você obtenha dados brutos em seus sistemas de análise, o que ajuda a analisar melhor os usuários e a aprimorar o mapa da jornada do cliente (CJM). A opção ajuda a testar novas funcionalidades, a analisar o desempenho do produto e a fazer previsões sobre a condição financeira do aplicativo.
Chaves de API
Para encontrar a lista de chaves de API, vá para Attribution > API Tools (Atribuição > Ferramentas de API). Nessa página, você pode ver o seguinte:
🔎 Você pode adicionar até 3 chaves de API.
Chaves de API de demonstração:
Você pode usar qualquer uma dessas chaves de API para obter dados de instalações, eventos e conversões. Cada uma dessas solicitações tem suas próprias condições.
Obter instalações
Cabeçalhos: API-KEY
Parâmetros:
pagination.limit (uint) - limite.
pagination.offset (uint) - deslocamento.
time_window.from_rfc3339 (string) - exemplo: 2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - carimbo de data/hora - prioridade mais alta que from_rfc3339.
time_window.from_not_include bool - se marcado "time > from", caso contrário "time >= from".
time_window.to_rfc3339 (string) - exemplo: 2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - registro de data e hora - prioridade mais alta que to_rfc3339.
non_organic_only (booleano).
Todos os campos são opcionais. Ordem por created_at asc sempre. Novos eventos com menos created_at não podem ser adicionados.
Exemplo de resposta da 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, 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": { "seconds": 1696156248 }, "geo": { "country": "ID", "region": "ID", "isp": "IND TELKOMSEL" }, "ip": "2001:448a:2130:1985:5d62:4fe6:118d:9c12", "created_at": { "seconds": 1696156279 } }
Obter eventos
Cabeçalhos: API-KEY
Parâmetros:
pagination.limit (uint) - limite.
pagination.offset (uint) - deslocamento.
time_window.from_rfc3339 (string) - exemplo: 2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - registro de data e hora - prioridade mais alta que from_rfc3339.
time_window.from_not_include bool - se marcado "time > from", caso contrário "time >= from".
time_window.to_rfc3339 (string) - exemplo: 2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - registro de data e hora - prioridade mais alta do que to_rfc3339.
non_organic_only (booleano).
Todos os campos são opcionais. Ordem por created_at asc sempre. Novos eventos com menos created_at não podem ser adicionados.
Exemplo de resposta da 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": "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": { "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\":\"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\"}]}" }
Obter conversões
Cabeçalhos: API-KEY
Parâmetros:
pagination.limit (uint) - limite.
pagination.offset (uint) - deslocamento.
time_window.from_rfc3339 (string) - exemplo: 2022-01-01T12:00:27.87+00:20.
time_window.from.seconds (uint) - registro de data e hora - prioridade mais alta que from_rfc3339.
time_window.from_not_include bool - se marcado "time > from", caso contrário "time >= from".
time_window.to_rfc3339 (string) - exemplo: 2022-01-01T12:00:27.87+00:20.
time_window.to.seconds (uint) - registro de data e hora - prioridade mais alta que to_rfc3339.
non_organic_only (booleano).
Todos os campos são opcionais. Ordem por created_at asc sempre. Novos eventos com menos created_at não podem ser adicionados.
⚠️ O exemplo inclui valores adicionais que você pode obter se os passar por meio do referenciador.
{ "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": "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, como 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" } ]}{
Experimentar a chave de API
Para testar uma chave de API, faça o seguinte:
Selecione Try installs (Testar instalações), Try events (Testar eventos) ou Try conversions (Testar conversões).
Na lista suspensa API-KEY, selecione uma determinada chave de API.
No filtro Período, especifique o período.
Se você quiser obter apenas eventos não orgânicos, clique na caixa de seleção Non organic only (Apenas não orgânicos ).
Clique em Request (Solicitar).
Você pode ter a seguinte resposta:
Erros de postback
Na guia Erros de postbacks, você pode verificar os logs dos postbacks que seu anunciante enviou.
Entre em contato com a equipe de Suporte ao Cliente da Affise sobre todas as questões levantadas por meio do e-mail: [email protected].