기기 귀인 확인

연동 테스트 및 트래킹 링크 검증을 위해 Singular Device Assist 앱과 Attribution Details 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 — 리인게이지먼트 귀인 문서