Como verificar a atribuição de dispositivos

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.

Screen_Shot_2021-08-08_at_16.14.57.png

3

O Identificador do seu dispositivo será selecionado por predefinição. Selecione Check Implementation novamente.

Screen_Shot_2021-08-08_at_16.15.15.png

4

O aplicativo exibe as informações de atribuição para este aplicativo conforme registrado no Singular, incluindo:

  • Tempo de instalação, rede atribuída e nome da campanha
  • Tempo de reengajamento, rede atribuída e nome da campanha
  • Um resumo das sessões e eventos in-app que ocorreram neste dispositivo, conforme rastreados pelo Singular.

Screen_Shot_2021-08-08_at_16.15.38.png

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:

  • A hora do primeiro evento rastreado
  • A hora do último evento rastreado
  • Contagem de eventos
  • Receita (se houver)
uninstall_pre_requisites Apns (para iOS) ou gcm_token (para Android).