如何验证设备归属

Singular provides two methods for checking a device's attribution: the Device Assist app and the Attribution Details API endpoint.

验证归属是of testing a new SDK/S2S integration 流程的一部分,在创建之后和开始在营销活动中使用之前,testing a new Singular Link

有关测试单一链接的完整指南,请参阅如何测试跟踪链接

有关测试新 SDK/S2S 集成的完整指南,请参阅使用测试控制台

Guide for UA 管理员、开发人员
Tools 用于测试的移动设备

如何使用 Singular 设备辅助应用程序验证归因

1 下载iOS Android 版 Singular Device Assist 应用程序。
2

打开应用程序并选择Check Implementation

Screen_Shot_2021-08-08_at_16.14.57.png

3

默认情况下会选择您的设备标识符。再次选择Check Implementation

Screen_Shot_2021-08-08_at_16.15.15.png

4

应用程序会显示 Singular 中记录的此应用程序的归属信息,包括

  • 安装时间、归因网络和营销活动名称
  • 再次参与时间、归属网络和营销活动名称
  • 由 Singular 跟踪的在此设备上发生的会话和应用程序内事件的摘要。

Screen_Shot_2021-08-08_at_16.15.38.png

如何使用归因详细信息端点验证归因

Note: 此端点为测试版功能。此端点仅用于测试。请勿在应用程序内或生产环境中调用。

要检查设备的归属,请运行以下查询:

https://api.singular.net/api/attribution/attribution_details?keyspace=
&device_id=&api_key=

查询参数

Parameter Format Description
api_key 字符串 在 Singular 控制台中提供的 API 密钥
device_id 字符串 设备的广告 ID
keyspace 字符串 广告 ID 类型:
IDFA : 用于 iOS 设备(广告商标识符)
IDFV :用于 iOS 设备(供应商标识符)
AIFA :在 Android 设备中使用,也称为 GAID
SDID :单一设备 ID - 用于网络跟踪。您可以在调用 init 方法或 InitFinishedCallback 后使用 singularSdk.getSingularDeviceId() 读取奇异设备 ID。

输出示例

端点以 JSON 格式返回响应,如下面的示例所示:


[
  {
    "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
    }
  ]
  }
]

  

输出参数

Parameter Description
install_info

有关安装和归属决策的重要信息,包括

  • install_time
  • network
  • campaign_name
  • view_through_attribution: true(如果归因是基于广告印象),false(如果归因是基于广告点击)。更多信息,请参阅Singular 的安装归因流程
  • additional_parameters: 广告网络通过跟踪链接发送给 Singular 的任何参数。有关这些参数的详细信息,请参阅 "跟踪链接参数和报告尺寸"。
re_engagement_info

与 install_info 相同,但用于再参与归因

events

SDK 跟踪的应用内事件摘要,包括

  • 跟踪的第一个事件的时间
  • 跟踪的最后一个事件的时间
  • 事件计数
  • 收入(如有)
uninstall_pre_requisites apns(iOS)或gcm_token(Android)。