Singular provides two methods for checking a device's attribution: the Device Assist app and the Attribution Details API endpoint.
Verificar a atribuição faz parte do processo of testing a new SDK/S2S integration, bem como testing a new Singular Link depois de o criar e antes de começar a utilizá-lo em campanhas.
Para obter o guia completo sobre como testar links singulares, consulte Como testar um link de rastreamento.
Para obter o guia completo para testar a nova integração SDK/S2S, consulte Usar o console de teste.
Guide for | Gerentes de UA, desenvolvedores |
Tools | Um dispositivo móvel para teste |
Como verificar a atribuição usando o aplicativo Singular Device Assist
1 | Baixe o aplicativo Singular Device Assist para iOS ou Android. |
2 |
Abra a aplicação e selecione Check Implementation. |
3 |
O Identificador do seu dispositivo será selecionado por predefinição. Selecione Check Implementation novamente. |
4 |
O aplicativo exibe as informações de atribuição para este aplicativo conforme registrado no Singular, incluindo:
|
Como verificar a atribuição usando o ponto de extremidade Detalhes da atribuição
Note: Este ponto de extremidade é um recurso beta. Use esse endpoint apenas para testes. Não o chame dentro do seu aplicativo ou em um ambiente de produção.
Para verificar a atribuição de um dispositivo, execute a seguinte consulta:
https://api.singular.net/api/attribution/attribution_details?keyspace=
&device_id=&api_key=
Parâmetros da consulta
Parameter | Format | Description |
api_key | Cadeia de caracteres | Chave de API fornecida no console do Singular |
device_id | Cadeia de caracteres | ID de publicidade do dispositivo |
keyspace | Cadeia de caracteres | O tipo de ID de publicidade: IDFA : Utilizado em dispositivos iOS (Identificador para anunciantes) IDFV : Utilizado em dispositivos iOS (identificador para fornecedores) AIFA : Utilizado em dispositivos Android, também conhecido como GAID SDID : ID de dispositivo único - utilizado para rastreio na Web. Pode ler o ID de dispositivo singular utilizando singularSdk.getSingularDeviceId() depois de chamar o método init ou utilizando InitFinishedCallback. |
Exemplo de saída
O ponto de extremidade retorna uma resposta no formato JSON, como no exemplo a seguir:
[
{
"app_long_name": "my.app.com",
"app_name": "My App",
"install_info": {
"install_time": "2020-06-10 11:58:46",
"network": "Network 1 ",
"additional_parameters": {
"kw": "my keyword",
"pcid": "1234"
},
"campaign_name": "Campaign Name",
"view_through_attribution": false
},
"re_engagement_info": {
"notes": "Attributions from Self-Attributing networks including: Twitter, Facebook, Google Ads, Snapchat, etc are redacted and always show as 'Unattributed'",
"install_time": "2020-06-15 15:27:12",
"network": "Unattributed"
},
},
"uninstall_pre_requisites": {
"gcm_token": "enE8iQR10RI:APA91bERgfA_xm8T7zgqH9OW_1s05SFFmKnle1zIm0cMrDfuaSxEmC_3j72dj4qN36vh5V8TAEnrXa3Pq3SmLW-XNOHP7daMwcBrBTibdkv_pKMJbN9SbefV6_9nuEfIeI5Zhtz0nlLY"
},
"events": [
{
"event_name": "Session",
"first_event_time": "2020-04-02 00:09:55",
"last_event_time": "2020-04-07 20:59:55",
"event_count": 2
},
{
"event_name": "Save New Transaction",
"first_event_time": "2020-04-02 00:11:51",
"last_event_time": "2020-04-02 00:11:51",
"event_count": 1
}
]
}
]
Parâmetros de saída
Parameter | Description |
install_info |
Informações importantes sobre a instalação e a decisão de atribuição, incluindo:
|
re_engagement_info |
O mesmo que install_info, mas para atribuição de reengajamento. |
events |
Um resumo dos eventos in-app rastreados pelo SDK, incluindo:
|
uninstall_pre_requisites | Apns (para iOS) ou gcm_token (para Android). |