デバイスのアトリビューション確認

連携テストおよびトラッキングリンク検証のために、Singular Device Assist アプリとAttributionDetails APIエンドポイントを使用してデバイスのアトリビューションを 検証するための総合ガイド。

アトリビューション検証のユースケース

アトリビューションを確認するタイミング

デバイスのアトリビューション検証は、連携とキャンペーンデプロイの ライフサイクルの複数の段階で重要です。

方法の比較

検証方法の選択

テストの要件と技術的な能力に基づいて適切な検証方法を選択してください。

方法1：Device Assistアプリ

テスト端末でデバイスのアトリビューション状態、インストールの詳細、 イベントトラッキングのサマリーを直接視覚的にすばやく確認できる モバイルアプリ。

Device Assistアプリの概要

アプリの機能

Device Assistアプリは、特定の端末についてSingularに記録された 包括的なアトリビューション情報を表示します。

表示されるアトリビューションデータ：

• インストールアトリビューション： インストールのタイムスタンプ、アトリビュートされた メディア、キャンペーン名
• リエンゲージメントアトリビューション： リエンゲージメントのタイムスタンプ、 アトリビュートされたメディア、キャンペーンの詳細
• イベントサマリー： Singularがその端末に対してトラッキングしたセッションと アプリ内イベント
• 端末識別子： トラッキングに使用されたIDFA、IDFV、GAIDまたはその他の識別子

Device Assistアプリの使い方

ステップバイステップの手順

Device Assistのトラブルシューティング

よくある問題

方法2：Attribution Details API

連携テストとCI/CDパイプラインのための自動化されたアトリビューション検証を 可能にするプログラム型APIエンドポイント。

APIエンドポイントの仕様

リクエスト形式

エンドポイントURL：

https://api.singular.net/api/attribution/attribution_details

リクエストメソッド： GET

完全なリクエスト例：

https://api.singular.net/api/attribution/attribution_details?keyspace=idfa&device_id=12345678-1234-1234-1234-123456789012&api_key=your_api_key_here

クエリパラメータ

必須パラメータ

APIレスポンス

レスポンス形式

APIはリクエストされた端末のアトリビューション詳細を含むJSON配列を返します。

レスポンスのサンプル

[
  {
    "app_long_name": "com.example.myapp",
    "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
      }
    ]
  }
]

レスポンスパラメータ

JSONレスポンスフィールド

APIの使用例

実装例

curl -X GET "https://api.singular.net/api/attribution/attribution_details?keyspace=idfa&device_id=12345678-1234-1234-1234-123456789012&api_key=your_api_key_here"

curl -X GET "https://api.singular.net/api/attribution/attribution_details?keyspace=aifa&device_id=12345678-1234-1234-1234-123456789012&api_key=your_api_key_here"

curl -X GET "https://api.singular.net/api/attribution/attribution_details?keyspace=sdid&device_id=singular_device_id_value&api_key=your_api_key_here"

import requests
import json

def check_attribution(keyspace, device_id, api_key):
    """
    Check device attribution using Singular API

    Args:
        keyspace: Device identifier type (idfa, idfv, aifa, sdid)
        device_id: Device identifier value
        api_key: Singular Reporting API key

    Returns:
        Attribution data as JSON or None if error
    """
    url = "https://api.singular.net/api/attribution/attribution_details"

    params = {
        'keyspace': keyspace,
        'device_id': device_id,
        'api_key': api_key
    }

    try:
        response = requests.get(url, params=params)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error checking attribution: {e}")
        return None

# Example usage
attribution_data = check_attribution(
    keyspace='idfa',
    device_id='12345678-1234-1234-1234-123456789012',
    api_key='your_api_key_here'
)

if attribution_data:
    print(json.dumps(attribution_data, indent=2))

    # Extract install info
    if attribution_data and len(attribution_data)  0:
        install_info = attribution_data[0].get('install_info', {})
        print(f"\nInstall Network: {install_info.get('network')}")
        print(f"Campaign: {install_info.get('campaign_name')}")
        print(f"Install Time: {install_info.get('install_time')}")

/**
 * Check device attribution using Singular API
 *
 * @param {string} keyspace - Device identifier type (idfa, idfv, aifa, sdid)
 * @param {string} deviceId - Device identifier value
 * @param {string} apiKey - Singular Reporting API key
 * @returns {Promise} Attribution data or error
 */
async function checkAttribution(keyspace, deviceId, apiKey) {
    const url = 'https://api.singular.net/api/attribution/attribution_details';

    const params = new URLSearchParams({
        keyspace: keyspace,
        device_id: deviceId,
        api_key: apiKey
    });

    try {
        const response = await fetch(`${url}?${params.toString()}`);

        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }

        return await response.json();
    } catch (error) {
        console.error('Error checking attribution:', error);
        throw error;
    }
}

// Example usage
checkAttribution(
    'idfa',
    '12345678-1234-1234-1234-123456789012',
    'your_api_key_here'
)
.then(data = {
    console.log('Attribution Data:', JSON.stringify(data, null, 2));

    // Extract install info
    if (data && data.length  0) {
        const installInfo = data[0].install_info || {};
        console.log('\nInstall Network:', installInfo.network);
        console.log('Campaign:', installInfo.campaign_name);
        console.log('Install Time:', installInfo.install_time);
    }
})
.catch(error = {
    console.error('Failed to check attribution:', error);
});

APIのトラブルシューティング

よくあるAPIの問題

ベストプラクティス

連携テストとキャンペーン検証における効果的なアトリビューション検証の ための推奨事項。

テストワークフロー

推奨テストプロセス

1. 新しい端末を使用： キャッシュされたアトリビューションを避けるために、 クリーンな端末を使用するか、テスト前に広告識別子をリセットしてください
2. すぐに確認： テスト中の素早いフィードバックのために、インストール後 5〜10分以内にアトリビューションを確認してください
3. 複数のシナリオをテスト： 異なるソース（オーガニック、有料キャンペーン、 リエンゲージメント）のアトリビューションを検証してください
4. 結果を記録： 連携検証のドキュメント化のためにアトリビューション検証の 結果を記録してください
5. 可能な限り自動化： 継続的な検証のために、自動化テストスイートで Attribution Details APIを使用してください

方法選択ガイド

各方法を使用するタイミング

連携検証チェックリスト

アトリビューション検証チェックリスト

追加リソース

アトリビューションテスト、SDK連携、トラッキングリンク設定に関する 完全なドキュメント。

関連ドキュメント

• テスティングコンソールの使い方 — SDK連携テスト完全ガイド
• トラッキングリンクのテスト方法 — トラッキングリンク検証手順
• Singularのモバイルアプリアトリビューションを理解する — アトリビューションの方法論とプロセス
• トラッキングリンクパラメータとレポートディメンション — 完全なパラメータリファレンス
• リエンゲージメントアトリビューションFAQ — リエンゲージメントアトリビューションのドキュメント