Ultra 모듈 설정 가이드
Ultra은(는) Adjust와 연동된 광고 네트워크입니다. Adjust와의 연동을 통해 Ultra은(는) 어트리뷰션과 인앱 이벤트 데이터를 콜백으로 수신합니다.
이 페이지에서는 Ultra와(과)의 설정 방법을 확인하실 수 있습니다. Ultra 활성화, 캠페인 링크 생성, Adjust가 공유할 수 있는 데이터 선택 방법을 아래에서 확인하시기 바랍니다.
시작에 앞서
요구 사항
- Adjust의 관리자, 편집자 또는 사용자 지정 편집자 권한 .
- Adjust SDK v4.0.0 이상 버전에서 SDK 파라미터를 Ultra 파라미터에 매핑하시기 바랍니다. 자세한 내용은 아래 링크된 가이드를 통해 확인하실 수 있습니다.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
인증 정보
INSTALL_EVENT_NAME
- 인증 정보를 찾는 데 도움이 필요한 경우에는 Ultra 담당자에게 문의하시기 바랍니다.
Campaign Lab에서 Ultra과 앱 선택
- Campaign Labs 에서 파트너 를 선택합니다.
- 새 파트너 > Ultra 을 선택합니다. 다음 을 선택하여 다음 화면으로 이동합니다.
- 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택하고, Ultra를(을) 활성화하여 파트너와 데이터를 공유합니다.
- 다음 을 선택합니다.
데이터 공유 활성화
Ultra와(과)의 연동을 활성화하려면 다음의 단계를 수행하시기 바랍니다.
- INSTALL_EVENT_NAME를 입력합니다.
Ultra와(과)의 데이터 공유가 활성화되면, Adjust는 기본 설정에 따라 다음의 데이터를 자동으로 Ultra에 전송합니다.
- 설치
- 이벤트
- 거부된 설치
데이터 공유 옵션 설정
멀티 플랫폼에 대해 데이터 공유가 활성화된 멀티 플랫폼 앱인 경우, 다음이 가능합니다:
- 플랫폼별 설정 사용 을 선택하여 플랫폼 수준에서 데이터 공유 옵션을 구분.
- 글로벌 설정 사용 을 선택하여 여러 플랫폼에 대해 동일한 데이터 공유 설정을 적용.
기본 설정으로 공유되는 데이터 에서 Adjust가 Ultra과 디폴트로 공유하는 활동을 확인하시기 바랍니다.
- 설치
- 이벤트
- 거부된 설치
추가 데이터 전송
콜백을 통해 Ultra과(와) 공유하고자 하는 데이터의 양과 유형을 선택합니다. Ultra은(는) 퍼포먼스 최적화를 위해 이 정보를 사용할 수 있습니다.
- 공유하고자 하는 데이터 소스 에서 Ultra과(와) 공유하는 데이터의 어트리뷰션 소스를 선택합니다.
- 모든 어트리뷰션 소스의 데이터
- Ultra에게 어트리뷰션된 데이터
인앱 매출 (인앱 구매로부터의 매출)
인앱 매출 공유가 활성화되면 Ultra에 매출 금액과 매출 이벤트 데이터를 전송할 수 있습니다. 이 데이터를 공유하려면 매출을 창출하는 이벤트를 매핑 해야 합니다.
이벤트 매핑
공유하고자 하는 이벤트를 Ultra이(가) 수신할 수 있는 값에 매핑합니다. 매핑되지 않은 이벤트는 Ultra 에 공유되지 않습니다.
개별 이벤트 매핑
멀티 플랫폼 앱의 경우, Ultra과(와) 플랫폼별로 다른 이벤트를 공유할 수 있습니다. 이를 통해서,
- 개별 이벤트를 설정하여 각 플랫폼에 대한 캠페인 전략을 관리할 수 있습니다.
- 플랫폼별로 데이터 공유를 맞춤화할 수 있습니다.
이벤트 매핑 에서 다음의 단계를 수행하여 Ultra에 직접 전송하고자 하는 인앱 이벤트를 선택합니다.
이벤트 매핑 을 선택합니다.
Adjust 이벤트 목록에서 Ultra과(와) 공유하고자 하는 Adjust 이벤트를 선택합니다.
파트너 이벤트 에서 Adjust 이벤트에 상응하는 Ultra 이벤트를 선택해야 합니다.
단일 플랫폼 앱 및 단일 플랫폼에 대해서만 데이터 공유가 활성화된 멀티 플랫폼 앱의 경우, 해당 플랫폼에 대해서만 데이터 공유 옵션을 설정합니다. 멀티 플랫폼에 대한 데이터 공유가 활성화되어 있는 멀티 플랫폼 앱의 경우 다음을 설정할 수 있습니다.
- 플랫폼별 매핑 사용 을 선택하여 플랫폼 수준에서 개별 이벤트를 매핑하거나 특정 플랫폼에 대한 이벤트를 매핑하지 않을 수 있습니다.
- 모든 플랫폼에 대해 동일한 이벤트를 매핑하려면 글로벌 매핑 사용 을 선택합니다.
파트너 이벤트 목록에서 Adjust 이벤트를 매핑하고자 하는 커스텀 이벤트 이름을 선택하거나 입력합니다.
적용 을 선택합니다.
이제 연결된 이벤트 데이터가 Ultra에게 전송됩니다.
모든 이벤트 매핑
Ultra이(가) 모든 이벤트 자동 매핑을 지원하는 경우 이벤트 매핑 에서 모든 이벤트 매핑 을 선택 합니다. 이를 통해 개별 이벤트를 매핑하는 시간을 절약할 수 있습니다.
이제 연결된 인앱 이벤트 데이터가 Ultra에게 전송됩니다.
링크 및 설정 구성
다음을 설정할 수 있습니다.
링크 생성 및 Ultra에게 공유
설정 검토 화면에서는 선택 사항을 검토할 수 있습니다. 이전 페이지로 돌아가서 다음을 변경할 수도 있습니다.
- 선택한 앱
- 데이터 공유 옵션
- 링크 구조 파라미터
- 사용자 이동 위치
- 어트리뷰션 설정
링크 생성 을 선택하여 클릭 URL, 노출 URL, QR 코드 및 링크 토큰을 생성합니다. 링크를 생성하면 Ultra과(와)의 데이터 공유 및 연동이 활성화 됩니다.
링크가 생성되면 Ultra에 공유하여 캠페인에 배치할 수 있습니다.
Ultra에 전송되는 모든 파라미터 목록
Adjust는 Ultra의 콜백에 다음의 파라미터(데이터 포인트)를 전송합니다.
| 플레이스홀더 | 정보 |
{android_id} | Android ID (Android만 해당) |
{city} | 기기 도시 |
{device_name} | 기기 모델 번호 |
{idfa||gps_adid||fire_adid} | IDFA. IDFA가 공백인 경우는 GPS ADID. IDFA와 GPS ADID가 공백인 경우 ADID. |
{ip_address} | 기기 IP 주소 |
{is_reattributed} | 유저가 이전의 소스로부터 최소 1회 리어트리뷰션 된 경우 1. 유저가 리어트리뷰션 된 이력이 없으면 0. |
{isp} | 기기 인터넷 서비스 공급자 |
{language} | 기기 언어 코드(두 자릿수) |
{os_name} | 기기 운영 체제 |
{os_version} | 운영 체제 버전 번호 |
{revenue_usd} | 수익(미국 달러로 표기) |
{sdk_version} | Adjust SDK 버전(앱 당) |
{tracking_limited} | 트래킹이 제한되어 있으면 1, 제한되지 않은 경우 0 |
{user_agent} | 수신되는 미가공 유저 에이전트 |
{app_id} | Store App ID 또는 Google Play Store |
{app_version} | 앱 버전 번호(Android), 번들용 빌드 버전 번호(iOS) |
{campaign_name} | 트래커에서 가져온 캠페인 이름 |
{click_time} | 어트리뷰션된 클릭 타임스탬프 |
{connection_type} | 인터넷 연결 유형 |
{created_at} | 활동 타임스탬프 |
{creative_name} | 트래커에서 가져온 크리에이티브 이름 |
{device_manufacturer} | 기기 제조업자명 |
{impression_based} | 노출 기반 인게이지먼트면 1, 그 외는 0 |
{install_begin_time} | 앱 다운로드가 시작된 시점의 타임스탬프(안드로이드와 구글 플레이 스토어만 해당) |
{install_finish_time} | 앱 다운로드 완료 타임스탬프 |
{installed_at} | 설치(첫 앱 실행) 타임스탬프 |
{network_name} | 트래커에서 가져온 네트워크 이름 |
{rejection_reason} | 거부된 설치의 이유 |
{is_s2s} | 서버간 인게이지먼트인 경우 1, 그렇지 않은 경우 0. |