Passar para o conteúdo principal
Ferramentas de API
Daria Mamchenkova avatar
Escrito por Daria Mamchenkova
Atualizado há mais de uma semana

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:

  • A lista de chaves de API, que você pode adicionar, excluir e gerar novamente:
    ​

🔎 Você pode adicionar até 3 chaves de API.

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

URL: https://restapi.affattr.com/v1/report/raw/installs

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

URL: https://restapi.affattr.com/v1/report/raw/events

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


​URL: https://restapi.affattr.com/v1/report/raw/conversions

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:

  1. Selecione Try installs (Testar instalações), Try events (Testar eventos) ou Try conversions (Testar conversões).

  2. Na lista suspensa API-KEY, selecione uma determinada chave de API.

  3. No filtro Período, especifique o período.

  4. Se você quiser obter apenas eventos não orgânicos, clique na caixa de seleção Non organic only (Apenas não orgânicos ).

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

Artigos relacionados
Macros de URL de rastreamento de anunciantes
Parâmetros e macros de atribuição probabilística
Macros de links de cross-postback
API para ofertas (administradores)
Respondeu à sua pergunta?