어떻게 도와드릴까요?

데이터 협업 플랫폼(Data Collaboration Platform, DCP) - 협업 측정 준비

  • 업데이트 시간

한눈에 보기: 측정 데이터 소스를 생성하는 방법과, 이를 어트리뷰션 작업이 활용할 수 있는 형태로 제공하는 방법을 알아보세요.

개요

측정 프로세스를 설정하는 첫 번째 단계는, 세 가지 입력값인 전환, 인게이지먼트, 캠페인 매핑을 준비하는 것입니다. 이러한 입력값은 데이터 제공 모드(인앱 이벤트 또는 사용자 정의 소스 파일)에 따라 사전 정의된 스키마 또는 이벤트 구조를 기반으로 준비되어야 합니다.

제공 모드가 사용자 지정 소스 파일일 경우, 필요한 변환 및 인게이지먼트 기록 폴더가 클라우드에 업로드되면 어트리뷰션 작업이 자동으로 트리거됩니다. 인앱 이벤트 모드의 경우, 관련 인앱 이벤트가 선택되면 작업이 트리거됩니다.

인앱 이벤트 준비

귀하의 앱에 연동된 앱스플라이어 SDK가 전송하는 인앱 이벤트를 통해 전환 및 인게이지먼트 데이터를 전송할 수 있습니다.

참고

SDK 또는 서버-to-서버 요청을 통해 앱스플라이어 인앱 이벤트를 이미 전달하고 있다면, 이 옵션이 사용자 정의 소스 파일 옵션보다 구현하기 더 쉬울 수 있습니다.

전환 인앱 이벤트 준비

전환 인앱 이벤트는 SKU 정보를 포함해야 합니다. 다음 예시에서는, af_order_info 키가 SKU 정보를 식별합니다:

"event_value": {
    "af_currency": "EUR",
    "af_content": "retail",
    "af_order_id": "637f7c400f0e3fddd9e5bcbc",
    "af_order_info": [
        {
            "sku": "a",
            "revenue": 1.1,
            "qty": 2
        },
        {
            "sku": "b",
            "revenue": 100.5,
            "qty": 1
        }
    ]
}

인앱 이벤트를 준비하는 방법에 대한 자세한 내용은 아래의 인앱 이벤트 생성하기 섹션을 참조하세요.

리인게이지먼트 인앱 이벤트

현장 캠페인은 인앱 이벤트를 통해 인게이지먼트를 유도할 수 있습니다. 인앱 이벤트 인게이지먼트는 event_value 키 내에 어트리뷰션 데이터를 포함해야 합니다. 다음의 event_value JSON 구조를 살펴보세요:

"event_value": {
    "media_source": "onsite",
    "campaign_name": "winter_bags",
    "campaign_id": "637f7c400f0e3fddsdfaafe33",
    "engagement_type": "click"
}

아래 필드를evant_value JSON 키에 사용할 수 있습니다:

필드 설명 필수 인앱 이벤트 체계 내에서 사용 가능 유형
campaign_id 캠페인 ID 예 아니요 string
campaign_name 캠페인 이름 아니요 아니요 string
engagement_type 클릭과 노출 구분 예 아니요 string
media_source 이벤트에 어트리뷰션되거나 제한된 미디어 소스(자세히 보기) 예 아니요 string
ad_id 광고 ID 아니요 아니요 string
ad_name 광고 이름 아니요 아니요 string
ad_type 예: 배너, 꼬리말(footer) 아니요 아니요 string
adset_id 하나 이상의 광고가 포함된 그룹을 식별하는 광고 세트 ID 아니요 아니요 string
adset_name 하나 이상의 광고가 포함된 그룹을 식별하는 광고 세트 이름 아니요 아니요 string
channel 미디어 소스 채널 예시: Google의 YouTube, Meta Ads의 인스타그램 아니요 아니요 string

인앱 이벤트를 준비하는 방법에 대한 자세한 내용은 아래의 인앱 이벤트 생성하기 섹션을 참조하세요.

인앱 이벤트 생성하기

인앱 이벤트를 통해 전환 및 인게이지먼트 데이터를 제공하려면 앱에 연동된 AppsFlyer SDK를 설정하십시오. 인앱 이벤트 생성에 대한 자세한 내용은 다음을 참조하세요:

커스텀 소스 파일 준비

현장 캠페인을 운영 중인 경우, 아래 표에 명시된 방식을 사용하여 전환 및 인게이지먼트의 소스로 사용자 정의 소스 파일을 활용할 수 있습니다.

전환 소스 스킴

아래 표의 방식을 사용하여 변환 사용자 정의 소스 파일을 생성하십시오:

필드 설명 사용자 정의 데이터 소스에 반드시 필요 기대값 유형 데이터 유효성 검사
appsflyer_id 앱이 디바이스에 설치될 때 SDK에 의해 생성된 고유 ID입니다. 이 ID는 인앱 이벤트를 추적하고, 전환 데이터를 수집하며, 인앱 이벤트를 연계하는 데 사용됩니다. 앱을 삭제하고 다시 설치하면 새로운 ID가 생성됩니다. iCloud 백업에서 앱을 복원하는 것은 설치로 간주되지 않습니다. CTV의 경우, 이 필드는 광고주가 관리하는custom_device_id로 채워집니다. 선택적 PII 필드 PII 필드 중 하나는 필수입니다. 문자열 없음
advertising_id 사용자가 재설정 가능한 디바이스 ID, 일명 GAID CTV의 경우, 예를 들어, RIDA 또는 VIDA가 CTV ID입니다. 선택적 PII 필드 PII 필드 중 하나는 필수입니다. 문자열 없음
cuid 앱 소유주가 설정한 고유한 앱 유저 ID입니다. 선택적 PII 필드 PII 필드 중 하나는 필수입니다. 문자열 없음
android_id 영구 디바이스 ID 선택적 PII 필드 PII 필드 중 하나는 필수입니다. 문자열 없음
idfa iOS 디바이스에서 유저가 재설정할 수 있는 광고 ID. idfa 가 사용 불가능한 경우, 일반적으로 0으로 채워집니다. 선택적 PII 필드 PII 필드 중 하나는 필수입니다. 문자열 없음
idfv iOS가 제공하는 공급업체 ID 선택적 PII 필드 PII 필드 중 하나는 필수입니다. 문자열 없음
event_name 앱에서 전송한 어트리뷰션 이벤트 유형 또는 인앱 이벤트 이름 예시 이벤트 유형: 인스톨, 리인게이지먼트 등. 리타깃팅 리포트의 데이터 로커인 경우: 리타깃팅은 리인게이지먼트를 의미하며, 인스톨은 리어트리뷰션을 의미합니다. SKAN의 경우, 인앱 이벤트 이름은 앱스플라이어혹은 Meta Ads에 설정된 이름입니다. 필수 문자열 없음
event_time 이벤트 시간은 가장 가까운 시간으로 반올림됨 필수 날짜 및 시간 없음
sku 전환 이벤트에 포함된 항목 중 하나의 스톡 키핑 유닛(SKU) ID 필수 문자열 없음
sku_quantity 전환 이벤트에 포함된 SKU 단위 수. 필수 정수 없음
app_id 앱스플라이어의 고유한 앱 식별자. 예: iOS: id123456789, 안드로이드: com.appsflyer.referrersender 선택 사항 문자열 없음
app_name 광고주가 설정 선택 사항 문자열 없음
app_version 광고주가 설정 선택 사항 문자열 없음
city 디바이스 IP를 기반으로 한 유저의 가장 정밀한 위치 일반적으로 도시명을 포함하지만, 구나 자치구도 포함될 수 있음. 선택 사항 문자열 없음
country_code ISO 3166 (alpha-2)를 사용하는 국가 코드입니다. 예시: 미국, 중국 참고: 영국은 GB가 아닌 UK로 표시됨. 선택 사항 문자열 없음
device_category 가능한 값: phone, tablet, other 선택 사항 문자열 없음
event_currency SDK에 보고된 이벤트 수익 통화 코드입니다. 선택 사항 문자열 DCR 포멧 요건에 부합하는 시간, 날짜 구성
event_revenue 이벤트 수익 통화를 사용한 수익값 $-10,000에서 $+10,000(또는 이에 상응하는 금액) 범위를 벗어난 금액은 로데이터에는 표시되지만 집계 보고서에는 표시되지 않습니다. 선택 사항 decimal 없음
platform 기기 플랫폼: iOS, 안드로이드, 또는 Windows Mobile 선택 사항 문자열 없음
region SDK에 의해 리포트된 디바이스 IP 주소 기반. SKAN의 경우,country_code에 의해 결정됩니다. 선택 사항 문자열 없음
sku_revenue 해당 event_revenue_currency 필드에 지정된 통화로 표시된 SKU 관련 매출액 선택 사항 decimal 없음
state SDK에 의해 리포트된 디바이스 IP 주소 기반. 선택 사항 문자열 없음

인게이지먼트 소스 스킴

아래 스키마를 사용하여 인게이지먼트 데이터 소스를 생성하십시오.

참고

 

인게이지먼트 소스 스키마에 매핑된 개인 식별 정보(PII) 필드는 위의 전환 소스 스키마에 매핑된 PII와 교집합을 가져야 합니다.

 

필드 설명 필수 기대값 유형
appsflyer_id 앱 설치 시 SDK에서 생성된 고유 ID 선택적 PII 필드 PII 필드 중 하나는 필수입니다. string
cuid 앱 소유주가 설정한 고유한 앱 유저 ID입니다. 선택적 PII 필드 PII 필드 중 하나는 필수입니다. string
idfa iOS 디바이스에서 유저가 재설정할 수 있는 광고 ID. 사용 불가능한 경우, 0으로 채워집니다. 선택적 PII 필드 PII 필드 중 하나는 필수입니다. string
idfv iOS가 제공하는 공급업체 ID 선택적 PII 필드 PII 필드 중 하나는 필수입니다. string
app_id 앱스플라이어의 고유한 앱 식별자. 예시: iOS: id123456789, 안드로이드: com.appsflyer.referrersender 선택 사항 string
campaign_id 캠페인 ID 필수 string
campaign_name 캠페인 이름 선택 사항 string
media_source 이벤트에 어트리뷰션되거나 제한된 미디어 소스(자세히 보기) 필수 string
engagement_type 클릭과 노출 구분 필수 string
event_name 광고주가 설정 필수 string
event_time 이벤트 시간은 가장 가까운 시간으로 반올림됨 필수 datetime
app_name 광고주가 설정 선택 사항 string
app_version 광고주가 설정 선택 사항 string
ad_id 광고 ID 선택 사항 string
ad_name 광고 이름 선택 사항 string
ad_type 예: 배너, 꼬리말(footer) 선택 사항 string
adset_id 하나 이상의 광고가 포함된 그룹을 식별하는 광고 세트 ID 선택 사항 string
adset_name 하나 이상의 광고가 포함된 그룹을 식별하는 광고 세트 이름 선택 사항 string
channel 미디어 소스 채널 예시: Google의 YouTube, Meta Ads의 인스타그램 선택 사항 string
platform 기기 플랫폼: iOS, 안드로이드, 또는 Windows Mobile 선택 사항 string

소스를 준비하고 클라우드 서비스에 업로드하는 방법에 대한 자세한 내용은 본 문서의 사용자 지정 데이터 소스 생성 및 연결 섹션을 참조하십시오.

캠페인 매핑 소스 준비

캠페인 매핑 데이터의 출처는 아래 표에 설명된 스키마를 가진 사용자 지정 데이터 소스 파일입니다.

참고

모든 협업에 단일 매핑 파일을 사용하는 것을 권장합니다. 이는 유지 관리 및 업데이트가 더 쉽기 때문입니다.

캠페인 매핑 스킴

아래 스키마를 사용하여 인게이지먼트 데이터 소스를 생성하십시오.

필드 유형 필수 기대값 유형 설명
collaborator_name 예 문자열 협업자의 이름
collaborator_id 예 문자열 협업자에 대한 고유 식별자
campaign_id 예 문자열 캠페인에 대한 고유 식별자
conversion_targets 예 문자열 배열 캠페인 대상 SKU를 쉼표로 구분한 목록을 받는 매개변수입니다. (예: sku1, sku2 등)

소스를 생성하고 클라우드 서비스에 업로드하는 방법에 대한 자세한 내용은 본 문서의 사용자 지정 데이터 소스 생성 및 연결 섹션을 참조하십시오.

어트리뷰션 작업 수집 흐름

각 어트리뷰션 작업은 단 하루로 할당되며 해당 날짜가 종료된 후 실행됩니다. 이 프로세스의 시작 단계에서, 작업은 클라우드 서비스 또는 인앱 이벤트로부터 관련 전환, 인게이지먼트 및 캠페인 매핑 데이터를 수집합니다.

캠페인 매핑 소스 수집

각 어트리뷰션 실행 전에 DCP는 사용자 지정 소스에서 캠페인 매핑 레코드를 로드합니다. 해당 기록을 불러오는 데는 두 가지 모드 중에서 선택할 수 있습니다:

  • 최신 전략: DCP는 레코드 업로드 날짜를 기준으로 가장 최근의 레코드를 가져옵니다.

    예를 들어, 소스 데이터에 업로드 날짜가 1월 18일, 1월 17일 또는 12월 29일인 레코드가 포함된 경우, 시스템은 1월 18일 날짜를 가진 레코드를 선택합니다.

  • 일일 전략: DCP는 업로드 날짜가 어트리뷰션 실행 날짜와 일치하는 레코드만 처리합니다. 예를 들어, 실행이 1월 19일 자정에 발생하면 시스템은 업로드 날짜가 1월 19일인 캠페인 레코드만 선택합니다.

전환 소스 수집

매일 종료 시점에 DCP는 해당 날짜 전용 폴더와 그 안의 전환 기록에 접근할 수 있는 경우에만 해당 일자의 어트리뷰션 분석 작업을 실행합니다. 그러나 특정 날짜의 폴더는 나중에 업로드할 수 있습니다. 예를 들어, 1월 17일 폴더를 1월 22일에 업로드할 수 있습니다.

  • 매일 종료 시점에 DCP는 해당 일자의 어트리뷰션을 실행합니다. 해당 작업은 DCP가 해당 날짜의 폴더를 찾을 수 있을 때만 실행됩니다. 폴더 이름은 해당 일자와 동일합니다.
  • 해당 일자 폴더에는 폴더 생성일로부터 30일 전까지의 이벤트 기록이 포함될 수 있습니다. 예를 들어, 1월 17일 폴더에서는 작업이 12월 18일부터 1월 17일까지의 기록을 처리합니다.
  • 특정 날짜의 폴더 업로드를 건너뛰면, 30일 이내에 업로드할 수 있습니다. 예를 들어, 1월 17일 폴더 업로드를 건너뛴 경우 2월 17일까지 업로드할 수 있습니다. 그러나 폴더 날짜에 최대한 가깝게 업로드하는 것을 권장합니다.
  • DCP가 당일 폴더를 찾지 못하면, 이후 7일간 매 10분마다 해당 폴더를 계속 검색합니다.

인게이지먼트 소스 수집

각 전환 레코드에 대해 DCP는 해당 전환을 유발한 인게이지먼트 이벤트를 검색합니다.

  • 인게이지먼트 기록은 날짜가 기재된 폴더에 포함되어 있습니다. 그러나 매일 인게이지먼트 폴더를 업로드할 필요는 없습니다. 예를 들어, 1월 14일 폴더를 업로드하지 않고 1월 13일과 1월 15일 폴더만 업로드할 수 있습니다. 이 예시에서는 1월 14일의 기록을 1월 15일 폴더에서 가져옵니다.
  • 주어진 전환 폴더에 대한 어트리뷰션은 전환 폴더와 동일한 날짜 또는 이후 날짜를 가진 인게이지먼트 폴더가 존재할 경우에만 시작됩니다. 예를 들어, 1월 17일 전환 폴더에 대한 어트리뷰션은 1월 17일 인게이지먼트 폴더 또는 1월 18일과 같이 17일 이후 날짜의 폴더가 존재할 경우에만 시작됩니다.
  • 어트리뷰션 작업은 어트리뷰션 룩백 기간 내에 발생한 모든 인게이지먼트 이벤트를 수집합니다.

인앱 데이터 수집

전환 및 인게이지먼트 데이터는 인앱 이벤트, 맞춤 소스 또는 둘의 조합에서 비롯될 수 있습니다. DCP를 사용하면 단일 모드를 사용할지 혼합할지 선택할 수 있어, 전환은 인앱 이벤트에서 발생하고, 인게이지먼트는 사용자 정의 파일에서 가져오거나 그 반대의 방식으로 설정할 수 있습니다.

전환, 인게이지먼트 또는 둘 다에 대한 인앱 이벤트를 구성할 때는 앱 ID와 전환 또는 인게이지먼트 이벤트 이름을 반드시 지정해야 합니다. 결국 어트리뷰션 작업은 지정된 이름과 앱 ID를 가지며 전환일과 동일한 이벤트 날짜를 가진 모든 이벤트를 선택합니다.

커스텀 데이터 소스 생성 및 연결

사용자 지정 소스를 통해 데이터를 연결하려면 다음의 DCP 지식 기반 문서 지침을 따라야 합니다: