Unity CTV 모듈 설정 가이드
Unity CTV은(는) Adjust와 연동된 광고 네트워크입니다. Adjust와의 연동을 통해 Unity CTV은(는) 어트리뷰션과 인앱 이벤트 데이터를 콜백으로 수신합니다.
이 페이지에서는 Unity CTV와(과)의 설정 방법을 확인하실 수 있습니다. Unity CTV 활성화, 캠페인 링크 생성, Adjust가 공유할 수 있는 데이터 선택 방법을 아래에서 확인하시기 바랍니다.
시작에 앞서
요구 사항
- Adjust의 관리자, 편집자 또는 사용자 지정 편집자 권한 .
- Adjust SDK v4.0.0 이상 버전에서 SDK 파라미터를 Unity CTV 파라미터에 매핑하시기 바랍니다. 자세한 내용은 아래 링크된 가이드를 통해 확인하실 수 있습니다.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Campaign Lab에서 Unity CTV과 앱 선택
- Campaign Labs 에서 파트너 를 선택합니다.
- 새 파트너 > Unity CTV 을 선택합니다. 다음 을 선택하여 다음 화면으로 이동합니다.
- 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택하고, Unity CTV를(을) 활성화하여 파트너와 데이터를 공유합니다.
- 다음 을 선택합니다.
데이터 공유 활성화
Unity CTV와(과)의 연동을 활성화하려면 다음의 단계를 수행하시기 바랍니다.
- 활성화 켜기
Unity CTV와(과)의 데이터 공유가 활성화되면, Adjust는 기본 설정에 따라 다음의 데이터를 자동으로 Unity CTV에 전송합니다.
- install
- reattribution
- event
- rejectedInstall
- rejectedReattribution
데이터 공유 옵션 설정
멀티 플랫폼에 대해 데이터 공유가 활성화된 멀티 플랫폼 앱인 경우, 다음이 가능합니다:
- 플랫폼별 설정 사용 을 선택하여 플랫폼 수준에서 데이터 공유 옵션을 구분.
- 글로벌 설정 사용 을 선택하여 여러 플랫폼에 대해 동일한 데이터 공유 설정을 적용.
기본 설정으로 공유되는 데이터 에서 Adjust가 Unity CTV과 디폴트로 공유하는 활동을 확인하시기 바랍니다.
- install
- reattribution
- event
- rejectedInstall
- rejectedReattribution
추가 데이터 전송
콜백을 통해 Unity CTV과(와) 공유하고자 하는 데이터의 양과 유형을 선택합니다. Unity CTV은(는) 퍼포먼스 최적화를 위해 이 정보를 사용할 수 있습니다.
- 공유하고자 하는 데이터 소스 에서 Unity CTV과(와) 공유하는 데이터의 어트리뷰션 소스를 선택합니다.
- 모든 어트리뷰션 소스의 데이터
- Unity CTV에게 어트리뷰션된 데이터
이벤트 매핑
공유하고자 하는 이벤트를 Unity CTV이(가) 수신할 수 있는 값에 매핑합니다. 매핑되지 않은 이벤트는 Unity CTV 에 공유되지 않습니다.
개별 이벤트 매핑
멀티 플랫폼 앱의 경우, Unity CTV과(와) 플랫폼별로 다른 이벤트를 공유할 수 있습니다. 이를 통해서,
- 개별 이벤트를 설정하여 각 플랫폼에 대한 캠페인 전략을 관리할 수 있습니다.
- 플랫폼별로 데이터 공유를 맞춤화할 수 있습니다.
이벤트 매핑 에서 다음의 단계를 수행하여 Unity CTV에 직접 전송하고자 하는 인앱 이벤트를 선택합니다.
이벤트 매핑 을 선택합니다.
Adjust 이벤트 목록에서 Unity CTV과(와) 공유하고자 하는 Adjust 이벤트를 선택합니다.
파트너 이벤트 에서 Adjust 이벤트에 상응하는 Unity CTV 이벤트를 선택해야 합니다.
단일 플랫폼 앱 및 단일 플랫폼에 대해서만 데이터 공유가 활성화된 멀티 플랫폼 앱의 경우, 해당 플랫폼에 대해서만 데이터 공유 옵션을 설정합니다. 멀티 플랫폼에 대한 데이터 공유가 활성화되어 있는 멀티 플랫폼 앱의 경우 다음을 설정할 수 있습니다.
- 플랫폼별 매핑 사용 을 선택하여 플랫폼 수준에서 개별 이벤트를 매핑하거나 특정 플랫폼에 대한 이벤트를 매핑하지 않을 수 있습니다.
- 모든 플랫폼에 대해 동일한 이벤트를 매핑하려면 글로벌 매핑 사용 을 선택합니다.
파트너 이벤트 목록에서 Adjust 이벤트를 매핑하고자 하는 커스텀 이벤트 이름을 선택하거나 입력합니다.
적용 을 선택합니다.
이제 연결된 이벤트 데이터가 Unity CTV에게 전송됩니다.
모든 이벤트 매핑
Unity CTV이(가) 모든 이벤트 자동 매핑을 지원하는 경우 이벤트 매핑 에서 모든 이벤트 매핑 을 선택 합니다. 이를 통해 개별 이벤트를 매핑하는 시간을 절약할 수 있습니다.
이제 연결된 인앱 이벤트 데이터가 Unity CTV에게 전송됩니다.
링크 및 설정 구성
다음을 설정할 수 있습니다.
링크 생성 및 Unity CTV에게 공유
설정 검토 화면에서는 선택 사항을 검토할 수 있습니다. 이전 페이지로 돌아가서 다음을 변경할 수도 있습니다.
- 선택한 앱
- 데이터 공유 옵션
- 링크 구조 파라미터
- 사용자 이동 위치
- 어트리뷰션 설정
링크 생성 을 선택하여 클릭 URL, 노출 URL, QR 코드 및 링크 토큰을 생성합니다. 링크를 생성하면 Unity CTV과(와)의 데이터 공유 및 연동이 활성화 됩니다.
링크가 생성되면 Unity CTV에 공유하여 캠페인에 배치할 수 있습니다.
Unity CTV에 전송되는 모든 파라미터 목록
Adjust는 Unity CTV의 콜백에 다음의 파라미터(데이터 포인트)를 전송합니다.
| Placeholder | Information |
{adid} | Adjust device ID (all platforms) |
{android_id_md5} | Lowercase Android ID hex MD5 hash |
{android_id} | Android ID (Android only) |
{city} | Device city |
{gps_adid_md5} | Lowercase hex MD5 hash of Google Play Store advertising ID |
{gps_adid} | Google Play Store advertising ID |
{iad_conversion_type} | Download status: first or subsequent app download |
{idfa_md5_hex} | IDFA hex MD5 hash |
{idfa_md5} | IDFA base64 MD5 hash |
{idfa} | ID for advertisers (iOS only) |
{ip_address} | Device IP address |
{is_reattributed} | 1 if user was reattributed at least once from an earlier source. 0 if user has never been reattributed |
{isp} | Device internet service provider |
{match_type} | Attribution method |
{os_name} | Device operating system |
{os_version} | Operating system version number |
{postal_code} | Device postal code of IP address |
{revenue_usd_cents} | Revenue, in US cents |
{revenue_usd} | Revenue, in US dollars |
{user_agent} | Incoming raw user agent |
{activity_kind} | Type of user activity |
{app_id} | Store App ID or Google Play Store |
{app_name} | Name of the app |
{app_version} | App version number (Android), build-version-number for the bundle (iOS) |
{click_time} | Attributed click timestamp |
{connection_type} | Internet connection type |
{created_at} | Activity timestamp |
{device_manufacturer} | Device manufacturer name |
{hardware_name} | Hardware name |
{impression_time} | Attributed impression timestamp |
{installed_at} | Install (i.e., first app open) timestamp |
{is_organic} | 1 if organic traffic, 0 if non-organic |
{reattributed_at} | Reattribution timestamp |
{reinstalled_at} | Reinstall timestamp |
{rejection_reason} | Reason for a rejected attribution |
{store} | Target store of click |
{proxy_ip_address} | IP address of user's proxy |