기술 자료

연동 문제 해결

일반적인 모바일 측정 파트너 (MMP) 통합 오류를 문제 해결합니다.
읽는 시간 4분최근 업데이트: 23일 전

MMP(모바일 측정 파트너)를 사용자 확보 캠페인에 통합하면 캠페인이 데이터를 성공적으로 수신하고 있는지 대시보드에서 확인합니다. 대시보드는 다음 데이터 공유 표시기를 확인합니다.
  • 캠페인 실행 후 2일 이내에 설치 데이터를 수신합니다.
  • 캠페인 실행 후 7일 이내에 이벤트 포스트백 데이터를 수신합니다.
캠페인이 이러한 확인 검사 중 하나에 실패하면 대시보드에 통합 오류 메시지 표시됩니다. 이러한 오류를 결정 방법은 다음 섹션을 참고하십시오.
중요
이 문제 해결 가이드는 다음 MMP의 연동 문제를 다룹니다.
  • Adjust
  • Airbridge
  • AppsFlyer
  • 바이트브루
  • Singular
  • Tenjin AppsFlyer와의 통합에 대한 추가 문제는 AppsFlyer 통합 확인 문서를 참조하십시오.

2일 이내에 설치 데이터 없음

캠페인이 실행 후 2일 이내에 설치 데이터를 수신하지 않으면 성과와 어트리뷰션에 부정적인 영향을 미칠 수 있습니다. 대시보드는 이 문제에 다음과 같은 오류 메시지 표시합니다.
하나 이상의 캠페인에 대해 감지된 통합 차단 문제입니다. 이러한 문제는 성능에 심각한 영향을 미칠 수 있습니다. 이 문제를 결정 정확한 트래킹 전달을 보장합니다. 실행 후 2일 이내에 캠페인은 최소 하나의 인스톨 포스트백을 수신해야 합니다.

원인

MMP 연동을 잘못 설정하면 캠페인이 인스톨 데이터를 누적하지 못할 수 있습니다. 단계별 통합 지침은 MMP 관련 통합 가이드를 참고하십시오.

해결

다음 두 가지 결정을 모두 고려하여 캠페인이 인스톨 데이터를 수신하십시오.

모든 소스의 설치 데이터 공유

Unity에 설치 데이터를 공유할 때 기여됨, 미기여, Unity 유입 설치 등 전체 사용자 기반의 데이터를 모두 포함해야 합니다. 각 어트리뷰션 유형의 정의는 어트리뷰션 소개를 참고하십시오.
MMP마다 이 설정에 사용하는 용어가 다를 수 있습니다. 지원되는 MMP 대시보드에서 모든 소스의 설치 데이터를 공유하는 방법에 대한 예시는 다음과 같습니다.
모든 사용자 지지대 인스톨 데이터를 공유하려면 Adjust 대시보드에서 다음 단계를 따르십시오.
  1. Campaign Lab 탭 > Partners 페이지로 이동합니다.
  2. What sources of data do you want to share 옵션에서 Data from all attribution sources를 선택합니다.

연동 설정 검토

선호하는 MMP의 연동 가이드를 검토하여 올바르게 구성되었는지 확인합니다. 파트너의 통합 가이드에서 통합 활성화, 광고주 자격 증명 및 데이터 공유 설정을 검토하십시오.
다음 단계를 완료하여 Adjust를 사용자 확보 캠페인과 올바르게 통합하고 데이터를 공유합니다.
1

Activate Unity Ads in the Adjust dashboard

Unity Ads 연동을 활성화하려면 다음 단계를 따릅니다.
  1. Adjust 대시보드에서 Campaign Lab > Partners로 이동합니다.
  2. + New partner를 선택한 후 Unity Ads를 검색합니다.
  3. 앱을 선택한 후 Next를 선택합니다.
  4. GAME ID 필드에 게임 ID를 입력합니다.
참고
UA 대시보드에 표시된 게임 ID를 정확하게 입력합니다. 게임 ID가 일치하지 않으면 Unity에서 이벤트를 올바르게 수신할 수 없습니다.
2

Configure data-sharing settings

데이터 공유 설정을 구성하려면 다음 단계를 따릅니다.
  1. What sources of data do you want to share 옵션에서 Data from all attribution sources를 선택합니다.
  2. What other data do you want to share? 옵션에서 Sessions와 In-app revenue (from in app purchases) 모두 선택합니다.
중요
ROAS와 이벤트 캠페인을 활성화하려면 이 데이터 공유 설정을 사용해야 합니다.
3

Map events and parameters

인앱 이벤트를 UA 캠페인과 공유하려면 Data sharing > Mapp your events에서 다음 단계를 따릅니다.
  1. + 맵 이벤트를 선택합니다.
  2. Adjust event 목록에서 Adjust가 Unity와 공유할 이벤트를 선택합니다.
    Adjust 연동 설정에서 Unity와 공유할 이벤트 맵 다이얼로그

    Map Adjust events

  3. 아래 표와 같이, 해당 Adjust 이벤트와 일치하는 Unity Ads 이벤트를 선택하거나 입력합니다.
중요
Adjust 계정에서 광고 수익 데이터 공유를 지원하는 경우, 이 데이터를 전용
ad_revenue
이벤트로 전송합니다. 그렇지 않은 경우, 광고 수익 이벤트를 전송하지 않습니다. 광고 수익 이벤트를
purchase
와 같은 다른 이벤트 유형으로 매핑하면 캠페인 최적화가 중단될 수 있습니다.

Adjust 앱 이벤트

Unity Ads 파트너 이벤트

purchase
purchase
ad_revenue
ad_revenue
{milestone_event}
level_complete
  • session
  • launch
session
  1. 모든 플랫폼에 동일한 이벤트를 매핑하려면 Use global mapping을 선택합니다.

7일 이내에 이벤트 포스트백 데이터 없음

캠페인이 실행 후 7일 이내에 이벤트 포스트백 데이터를 수신하지 않으면 성과와 최적화에 부정적인 영향을 미칠 수 있습니다. 대시보드는 이 문제에 다음과 같은 오류 메시지 표시합니다.
하나 이상의 캠페인에 대해 감지된 통합 차단 문제입니다. 이러한 문제는 성능에 심각한 영향을 미칠 수 있습니다. 이 문제를 결정 정확한 트래킹 전달을 보장합니다. 실행 후 7일 이내에 캠페인은 최소 하나의 이벤트 포스트백을 수신해야 합니다.

원인

다음과 같은 여러 연동 설정으로 인해 MMP가 캠페인에 이벤트 포스트백 데이터를 전송하는 작업을 중단할 수 있습니다.

어트리뷰션이 잘못 구성됨

어트리뷰션 링크를 잘못 설정 MMP가 이벤트 포스트백 데이터를 Unity 공유할 수 없습니다.

광고 매출 보고 비활성화

MMP가 Purchase 이벤트와 Ad 매출 이벤트의 값과 매출 모두 전송하도록 활성화하다, 사용 가능하다 않으면 다음 최적화된 캠페인 목표에 필요한 데이터가 대시보드에 없습니다.
  • IAP(인앱 구매) 광고 지출 대비 수익 ROAS
  • Ad Revenue ROAS
  • Hybrid ROAS
  • 결제 이벤트 최적화
이 문제를 결정하는 방법에 대한 자세한 내용은 설정 데이터 공유 올바르게 섹션을 참조하십시오.

해결

캠페인이 이벤트 포스트백 데이터를 수신하려면 다음 사항을 고려하십시오.

설치 후 이벤트를 올바르게 매핑

캠페인에 포스트 인스톨 후 이벤트 데이터를 공유할 때 포스트 인스톨 후 이벤트를 올바르게 매핑해야 합니다. 올바른 매핑이란 Unity Ads 이벤트 이름과 MMP 이벤트 이름을 정확하게 일치시키는 것을 의미합니다.
경고
Singular 이외의 MMP를 사용하는 경우, 광고 수익 이벤트와 IAP(인앱 결제) 이벤트를 함께 사용하면 안 됩니다.
올바르게 매핑된 이벤트 이름의 예시를 참고하십시오.
Adjust 연동 설정의 Map events to share with Unity Ads 섹션에서 이벤트를 다음과 같이 매핑합니다.
중요
Adjust 계정에서 광고 수익 데이터 공유를 지원하는 경우, 이 데이터를 전용
ad_revenue
이벤트로 전송합니다. 그렇지 않은 경우, 광고 수익 이벤트를 전송하지 않습니다. 광고 수익 이벤트를
purchase
와 같은 다른 이벤트 유형으로 매핑하면 캠페인 최적화가 중단될 수 있습니다.

이벤트 유형

Unity Ads 이벤트 이름

이벤트 이름 조정

인앱 구매(IAP)
purchase
purchase
광고 매출
ad_revenue
ad_revenue
마일스톤 완료
level_complete
{milestone_event_name}
세션
session
session

데이터 공유 설정

캠페인과 포스트 인스톨 이벤트 데이터를 공유할 때 데이터 공유 설정을 올바르게 설정해야 합니다.
설치 및 이벤트 포스트백 데이터를 Unity로 전송하려면 다음 파트너별 지침의 설정 데이터 공유 설정 섹션을 참조하십시오.
다음 단계를 완료하여 Adjust를 사용자 확보 캠페인과 올바르게 통합하고 데이터를 공유합니다.
1

Activate Unity Ads in the Adjust dashboard

Unity Ads 연동을 활성화하려면 다음 단계를 따릅니다.
  1. Adjust 대시보드에서 Campaign Lab > Partners로 이동합니다.
  2. + New partner를 선택한 후 Unity Ads를 검색합니다.
  3. 앱을 선택한 후 Next를 선택합니다.
  4. GAME ID 필드에 게임 ID를 입력합니다.
참고
UA 대시보드에 표시된 게임 ID를 정확하게 입력합니다. 게임 ID가 일치하지 않으면 Unity에서 이벤트를 올바르게 수신할 수 없습니다.
2

Configure data-sharing settings

데이터 공유 설정을 구성하려면 다음 단계를 따릅니다.
  1. What sources of data do you want to share 옵션에서 Data from all attribution sources를 선택합니다.
  2. What other data do you want to share? 옵션에서 Sessions와 In-app revenue (from in app purchases) 모두 선택합니다.
중요
ROAS와 이벤트 캠페인을 활성화하려면 이 데이터 공유 설정을 사용해야 합니다.
3

Map events and parameters

인앱 이벤트를 UA 캠페인과 공유하려면 Data sharing > Mapp your events에서 다음 단계를 따릅니다.
  1. + 맵 이벤트를 선택합니다.
  2. Adjust event 목록에서 Adjust가 Unity와 공유할 이벤트를 선택합니다.
    Adjust 연동 설정에서 Unity와 공유할 이벤트 맵 다이얼로그

    Map Adjust events

  3. 아래 표와 같이, 해당 Adjust 이벤트와 일치하는 Unity Ads 이벤트를 선택하거나 입력합니다.
중요
Adjust 계정에서 광고 수익 데이터 공유를 지원하는 경우, 이 데이터를 전용
ad_revenue
이벤트로 전송합니다. 그렇지 않은 경우, 광고 수익 이벤트를 전송하지 않습니다. 광고 수익 이벤트를
purchase
와 같은 다른 이벤트 유형으로 매핑하면 캠페인 최적화가 중단될 수 있습니다.

Adjust 앱 이벤트

Unity Ads 파트너 이벤트

purchase
purchase
ad_revenue
ad_revenue
{milestone_event}
level_complete
  • session
  • launch
session
  1. 모든 플랫폼에 동일한 이벤트를 매핑하려면 Use global mapping을 선택합니다.