기술 자료

UA

캠페인 목표

어트리뷰션

파트너 연동

UA

AppsFlyer 연동 확인

UA 대시보드에서 AppsFlyer 연동 규칙과 연동 설정 경고를 해결하는 방법을 검토합니다.
읽는 시간 4분최근 업데이트: 3일 전
UA 캠페인을 AppsFlyer와 통합하면 Unity 대시보드에서 통합 설정이 올바르게 구성되었는지 확인합니다. 이러한 연동 오류를 해결하지 않으면 새 캠페인이나 일시 중지된 캠페인을 실행할 수 없으며, 라이브 캠페인에 심각한 성과와 어트리뷰션 문제가 발생할 수 있습니다.

필수 통합 규칙

캠페인을 게재하려면 다음 규칙을 준수해야 합니다. 이러한 문제를 해결하는 방법에 대한 지침은 필수 해상도 섹션을 참조하십시오. 캠페인을 게재하려면 다음 연동이 필요하지 않습니다. 하지만 다음 권장 규칙을 준수하지 않으면 캠페인 성과와 어트리뷰션에 부정적인 영향을 미칠 수 있습니다.
  • Organic을 포함한 모든 소스의 사용자에게 설치 이벤트 포스트백 보내기
  • Organic을 포함한 모든 소스의 사용자에게 이벤트 포스트백 포스트백을 보냅니다. 여기에는 다음 포스트백 타입이 포함됩니다.
    • Organic을 포함한 모든 소스의 사용자에게 인앱 구매 이벤트 포스트백을 보냅니다.
    • Organic을 포함한 모든 소스의 사용자에게 광고 수익 이벤트 포스트백을 보냅니다.
    • Organic을 포함한 모든 소스의 사용자에게 세션 이벤트 포스트백을 보냅니다.
    • Organic을 포함한 모든 소스의 사용자에게 레벨 완료 이벤트 포스트백을 보냅니다.
이러한 문제를 해결하는 방법에 대한 지침은 권장 해석 섹션을 참조하십시오.

필수 해상도

필수 통합 규칙을 충족하려면 다음 섹션을 참고하십시오.

게임 ID와 일치해야 합니다.

이 확인 규칙을 충족하려면 AppsFlyer 대시보드에 입력한 게임 ID가 Unity UA 대시보드의 게임 ID와 정확히 일치하는지 확인합니다. Unity 대시보드의 앱 페이지에서 게임 ID를 가져오려면 다음 단계를 따르십시오.
  1. 대시보드 왼쪽 내비게이션 메뉴에서 Apps를 선택합니다. 제공된 표에는 조직의 각 앱이 나열되어 있습니다. 각 앱 이름 다음에 대시보드에는 앱 플랫폼과 게임 ID가 표시됩니다.
  2. ID 옆의 Copy 기호를 선택하여 클립보드에 복사합니다.
또한 대시보드의 캠페인, 캠페인 세부 정보 및 크리에이티브 팩 페이지에서 게임 ID를 가져올 수도 있습니다. 자세한 내용은 게임 ID 기술 자료를 참고하십시오.

포스트백 창은 전체 수명으로 설정해야 합니다.

AppsFlyer에서 이 확인 규칙을 충족하려면 인앱 이벤트 포스트백 창을 
lifetime
로 설정합니다. 이 창을 설정하려면 다음 단계를 따르십시오.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. In-app event postback window를 Lifetime으로 설정합니다.
    AppsFlyer 통합 설정의 인앱 이벤트 포스트백 기간

    Lifetime postback window

클릭 검색 룩백 기간은 최소 2일이어야 합니다.

이 확인 규칙을 충족하려면 클릭 검색 백 창을 
2
일로 설정합니다. 이 창을 설정하려면 다음 단계를 따르십시오.
  1. 통합 탭의 설치 어트리뷰션 섹션으로 이동합니다.
  2. Install engaged click-through lookback window 섹션에서 Days를 선택합니다.
  3. 슬라이더를 사용하여 창을 2 일로 설정합니다.
    AppsFlyer 연동 설정의 설치 관련 클릭 검색창 설정

    2-day click-through lookback window

뷰스루 룩백 기간은 최소 7일이어야 합니다.

이 확인 규칙을 충족하려면 뷰스루 룩백 창을 
7
일로 설정합니다. 이 창을 설정하려면 다음 단계를 따르십시오.
  1. 통합 탭의 설치 어트리뷰션 섹션으로 이동합니다.
  2. Install engaged view-through lookback window 섹션에서 Days를 선택합니다.
  3. 슬라이더를 사용하여 창을 7 일로 설정합니다.
  4. Install view-through attribution 토글을 활성화합니다.
    AppsFlyer 연동 설정의 설치 참여 뷰스루 룩백 창 설정

    7-day view-through lookback window

뷰스루 어트리뷰션을 활성화해야 합니다.

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 뷰스루 어트리뷰션을 활성화해야 합니다. 뷰스루 어트리뷰션을 활성화하려면 다음 단계를 따르십시오.
  1. 통합 탭의 설치 어트리뷰션 섹션으로 이동합니다.
  2. Install engaged view-through lookback window 섹션을 따라 Install view-through attribution 토글을 활성화합니다.
    AppsFlyer 연동 설정의 설치 뷰스루 어트리뷰션 토글

    View-through attribution enabled

레벨 완료 이벤트 포스트백에는 반드시 값이 포함되어야 합니다.

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 레벨 완료 이벤트를 매핑할 때 값 및 매출을 선택해야 합니다. 이 데이터 공유 설정을 구성하려면 다음 단계를 따릅니다.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. 매핑 표의 포함 열에서 값 및 수익을 선택합니다.
올바른 매핑 예시는 다음과 같습니다.

AppsFlyer event

mapped to partner event

for users from

포함

af_level_achieved
level_complete
All media sources, including organic값 및 매출
AppsFlyer 이벤트 매핑 표의 값 및 수익 선택

Share Level Complete event values and revenue

구매 이벤트 포스트백에는 반드시 값이 포함되어야 합니다.

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 Purchase 이벤트를 매핑할 때 값 및 매출을 선택해야 합니다. 이 데이터 공유 설정을 구성하려면 다음 단계를 따릅니다.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. 매핑 표의 포함 열에서 값 및 수익을 선택합니다.
올바른 매핑 예시는 다음과 같습니다.

AppsFlyer event

mapped to partner event

for users from

포함

af_purchase
purchase
All media sources, including organic값 및 매출
AppsFlyer 이벤트 매핑 표의 값 및 수익 선택

Share Purchase event values and revenue

매출 이벤트 포스트백에는 반드시 값이 포함되어야 합니다.

중요
AppsFlyer를 사용하여 광고 수익 이벤트를 매핑하려면 먼저 광고 수익 공유를 활성화해야 합니다. 자세한 내용은 AppsFlyer 광고 수익 어트리뷰션 기술 자료를 참고하십시오.
이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 광고 수익 이벤트를 매핑할 때 값 및 수익을 선택해야 합니다. 이 데이터 공유 설정을 구성하려면 AppsFlyer 통합 설정의 통합 탭에서 다음 단계를 따르십시오.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. 매핑 표의 포함 열에서 값 및 수익을 선택합니다.
올바른 매핑 예시는 다음과 같습니다.

AppsFlyer event

mapped to partner event

for users from

포함

af_ad_revenue
ad_revenue
All media sources, including organic값 및 매출
AppsFlyer 이벤트 매핑 표의 값 및 수익 선택

Share Ad Revenue event values and revenue

세션 이벤트 포스트백에는 반드시 값이 포함되어야 합니다.

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 세션 이벤트를 매핑할 때 값 및 수익 없음을 선택해야 합니다. 이 데이터 공유 설정을 구성하려면 다음 단계를 따릅니다.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. 매핑 표의 포함 열에서 값 및 수익 없음을 선택합니다.
올바른 매핑 예시는 다음과 같습니다.
Values & no revenue

AppsFlyer event

mapped to partner event

for users from

포함

af_app_opened
 
session
 All media sources, including organic
AppsFlyer 이벤트 매핑 표의 값 및 수익 없음 선택

Share Session event values only

구매 이벤트 포스트백은 올바르게 매핑되어야 합니다.

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 Purchase 이벤트를 올바르게 매핑해야 합니다. Purchase 이벤트 포스트백을 매핑하려면 다음 단계를 따르십시오.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. 다음과 같이 구매 이벤트 행을 매핑합니다.

AppsFlyer event

mapped to partner event

for users from

포함

af_purchase
purchase
All media sources, including organic값 및 매출
AppsFlyer 연동 설정의 이벤트 매핑 표

Purchase event mapping for In-app Purchase campaigns

AppsFlyer 이벤트는 올바른 Unity 이벤트 이름에 매핑되어야 합니다.

이 확인 규칙을 충족하려면 모든 AppsFlyer 이벤트 포스트백을 올바르게 매핑해야 합니다. 이벤트를 매핑하려면 다음 단계를 따릅니다.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. 다음과 같이 포스트 인스톨 이벤트를 파트너 이벤트에 매핑된 열에 Unity 이벤트에 매핑합니다.
    • 세션 이벤트 to 
      session
    • 레벨 
      level_complete
      로 이벤트 완료
    • 광고 수익 이벤트 to 
      ad_revenue
    • 인앱 구매 이벤트를
      purchase
올바른 이벤트 매핑 예시는 다음과 같습니다.

AppsFlyer event

mapped to partner event

for users from

포함

af_purchase
purchase
All media sources, including organic값 및 매출
{custom_sdk_event_name}
level_complete
All media sources, including organicValues & revenue
af_app_opened
session
All media sources, including organicValues & no revenue
af_ad_revenue
ad_revenue
All media sources, including organicValues & revenue
중요
AppsFlyer를 사용하여 광고 수익 이벤트를 매핑하려면 먼저 광고 수익 공유를 활성화해야 합니다. 자세한 내용은 AppsFlyer 광고 수익 어트리뷰션 기술 자료를 참고하십시오.

앱은 최소 하나의 인스톨 포스트백을 수신해야 합니다.

이 확인 규칙을 충족하려면 캠페인이 인스톨 포스트백을 받을 수 있도록 기본 포스트백 설정을 올바르게 구성해야 합니다. 다음과 같이 AppsFlyer 연동 설정을 구성합니다.
  1. 통합 탭의 기본 포스트백 섹션으로 이동합니다. 
  2. Install
    행에서 for users from 드롭다운에서 All media sources, including organic을 선택합니다.
    AppsFlyer 통합 설정의 Default postbacks 섹션

    Share all sources, including organic

캠페인은 하나 이상의 광고 수익 포스트백을 수신해야 합니다.

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 광고 수익 데이터를 활성화해야 합니다. 광고 수익 이벤트 데이터를 캠페인과 공유하려면 다음 단계를 따릅니다.
  1. AppsFlyer 연동 설정의 Ad revenue 탭으로 이동합니다.
  2. Get ad revenue data 토글을 활성화합니다.
    AppsFlyer 연동 설정의 Ad revenue 탭과 Get ad revenue 토글

    Get ad revenue toggle

  3. AppsFlyer 대시보드 사이드 메뉴에서 Settings > Revenue Settings로 이동합니다.
    중요
    Revenue Settings 메뉴에 액세스하려면 AppsFlyer ROI360 구독이 필요합니다. 자세한 내용은 AppsFlyer 광고 수익 어트리뷰션 기술 자료를 참고하십시오.
  4. Revenue settings 페이지의 Ad revenue 탭에서 New ad revenue integration을 선택합니다.
  5. 수익 파트너 목록에서 Unity Ads를 선택합니다.
  6. 파트너 설정에서 리포트 유형으로 **Impression-level (via SDK) with Device-level (via S2S API)**을 선택합니다.
    AppsFlyer 광고 수익 파트너 설정의 노출 레벨과 기기 레벨 옵션

    AppsFlyer Revenue settings configuration

  7. API 자격 증명을 입력합니다. App Key 필드에 게임 ID를 입력합니다. Unity 대시보드에서 Secret key를 검색하려면 다음 단계를 참고하십시오.

Unity 대시보드에서 Secret key를 검색하려면 다음 단계를 따릅니다.
  1. 왼쪽 내비게이션 메뉴에서 API Management로 이동합니다.
  2. Advertising Management API > Service account를 선택합니다.
    UA 대시보드의 API Management 페이지

    Advertising Management Service account

  3. 서비스 계정이 없는 경우 + New를 선택합니다. 서비스 계정이 있으면 표에서 해당 계정을 선택합니다.
  4. 서비스 계정 페이지에서 Keys 섹션으로 이동합니다.
  5. + Add key를 선택해 새 키를 생성합니다.
  6. Secret key 뒤에 있는 복사 버튼을 선택하여 ID를 복사합니다.

캠페인은 하나 이상의 인앱 구매 포스트백을 수신해야 합니다.

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 Purchase 이벤트를 올바르게 매핑해야 합니다. Purchase 이벤트 포스트백을 매핑하려면 다음 단계를 따르십시오.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. 다음과 같이 구매 이벤트 행을 매핑합니다.

AppsFlyer event

mapped to partner event

for users from

포함

af_purchase
purchase
All media sources, including organic값 및 매출
AppsFlyer 연동 설정의 이벤트 매핑 표

Purchase event mapping for In-app Purchase campaigns

권장 통합 규칙을 충족하려면 다음 섹션을 참고하십시오.

모든 소스에서 사용자에 대한 인스톨 이벤트 포스트백 전송

이 권장 통합 규칙을 충족하려면 Organic을 포함한 모든 미디어 소스의 사용자에게 인스톨 이벤트 포스트백을 전송해야 합니다. 이렇게 하려면 다음 단계를 따릅니다.
  1. AppsFlyer 통합의 통합 탭의 기본 포스트백 섹션으로 이동합니다.
  2. for users from 드롭다운 섹션에서 All media sources, including organic을 Install 이벤트로 선택합니다.
AppsFlyer 통합 탭의 Default postbacks 섹션

Share all install postbacks for users from all media sources, including organic

모든 소스에서 사용자에게 이벤트 포스트백 포스트백 전송

이벤트 포스트백의 모든 권장 통합 규칙을 충족하려면 이벤트를 매핑할 때 Organic을 포함하여 모든 미디어 소스의 사용자에 대한 이벤트 포스트백을 공유해야 합니다. 이렇게 하려면 다음 단계를 따릅니다.
  1. Integration 탭의 In-app event postbacks 섹션으로 이동합니다.
  2. In-app event postbacks 토글을 활성화합니다.
  3. 다음 이벤트 유형 각각에 대해 for users from 열에서 Organic을 포함한 모든 미디어 소스를 선택합니다. 
    • purchase
    • ad_revenue
    • level_complete
    • session
    AppsFlyer 이벤트 매핑 표의 유기 선택 항목을 포함한 모든 미디어 소스

    Share post-install event postbacks for users from all media sources, including organic