デバイスの帰属を確認する方法

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 Device Assistアプリを使ってアトリビューションを検証する方法

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 :Singular Device ID - ウェブトラッキングに使用。Singular Device IDは、initメソッドを呼び出した後、またはInitFinishedCallbackを使用して、singularSdk.getSingularDeviceId()を使用して読み取ることができます。

サンプル出力

エンドポイントは、次の例のように 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

以下を含む、インストールと属性決定に関する重要な情報:

re_engagement_info

install_infoと同じですが、リエンゲージメントアトリビューション用です。

events

SDKによってトラッキングされたアプリ内イベントの概要:

  • 最初に追跡されたイベントの時間
  • 最後に追跡されたイベントの時間
  • イベント数
  • 収益(ある場合)
uninstall_pre_requisites apns(iOS用)またはgcm_token(Android用)のいずれか。