Awin 모듈 설정 가이드
Awin은(는) Adjust와 연동된 광고 네트워크입니다. Adjust와의 연동을 통해 Awin은(는) 어트리뷰션과 인앱 이벤트 데이터를 콜백으로 수신합니다.
이 페이지에서는 Awin와(과)의 설정 방법을 확인하실 수 있습니다. Awin 활성화, 캠페인 링크 생성, Adjust가 공유할 수 있는 데이터 선택 방법을 아래에서 확인하시기 바랍니다.
시작에 앞서
요구 사항
- Adjust의 관리자, 편집자 또는 사용자 지정 편집자 권한 .
- Adjust SDK v4.0.0 이상 버전에서 SDK 파라미터를 Awin 파라미터에 매핑하시기 바랍니다. 자세한 내용은 아래 링크된 가이드를 통해 확인하실 수 있습니다.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
인증 정보
INSTALL COMMISSION GROUP
- 인증 정보를 찾는 데 도움이 필요한 경우에는 Awin 담당자에게 문의하시기 바랍니다.
Campaign Lab에서 Awin과 앱 선택
- Campaign Labs 에서 파트너 를 선택합니다.
- 새 파트너 > Awin 을 선택합니다. 다음 을 선택하여 다음 화면으로 이동합니다.
- 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택하고, Awin를(을) 활성화하여 파트너와 데이터를 공유합니다.
- 다음 을 선택합니다.
데이터 공유 활성화
Awin와(과)의 연동을 활성화하려면 다음의 단계를 수행하시기 바랍니다.
- INSTALL COMMISSION GROUP를 입력합니다.
Awin와(과)의 데이터 공유가 활성화되면, Adjust는 기본 설정에 따라 다음의 데이터를 자동으로 Awin에 전송합니다.
- 설치(어트리뷰션된 것만)
- 이벤트(어트리뷰션된 것만)
데이터 공유 옵션 설정
멀티 플랫폼에 대해 데이터 공유가 활성화된 멀티 플랫폼 앱인 경우, 다음이 가능합니다:
- 플랫폼별 설정 사용 을 선택하여 플랫폼 수준에서 데이터 공유 옵션을 구분.
- 글로벌 설정 사용 을 선택하여 여러 플랫폼에 대해 동일한 데이터 공유 설정을 적용.
기본 설정으로 공유되는 데이터 에서 Adjust가 Awin과 디폴트로 공유하는 활동을 확인하시기 바랍니다.
- 설치(어트리뷰션된 것만)
- 이벤트(어트리뷰션된 것만)
추가 데이터 전송
콜백을 통해 Awin과(와) 공유하고자 하는 데이터의 양과 유형을 선택합니다. Awin은(는) 퍼포먼스 최적화를 위해 이 정보를 사용할 수 있습니다.
- 공유하고자 하는 데이터 소스 에서 Awin과(와) 공유하는 데이터의 어트리뷰션 소스를 선택합니다.
- 모든 어트리뷰션 소스의 데이터
- Awin에게 어트리뷰션된 데이터
인앱 매출 (인앱 구매로부터의 매출)
인앱 매출 공유가 활성화되면 Awin에 매출 금액과 매출 이벤트 데이터를 전송할 수 있습니다. 이 데이터를 공유하려면 매출을 창출하는 이벤트를 매핑 해야 합니다.
이벤트 매핑
공유하고자 하는 이벤트를 Awin이(가) 수신할 수 있는 값에 매핑합니다. 매핑되지 않은 이벤트는 Awin에 공유되지 않습니다.
개별 이벤트 매핑
멀티 플랫폼 앱의 경우, Awin과(와) 플랫폼별로 다른 이벤트를 공유할 수 있습니다. 이를 통해서,
- 개별 이벤트를 설정하여 각 플랫폼에 대한 캠페인 전략을 관리할 수 있습니다.
- 플랫폼별로 데이터 공유를 맞춤화할 수 있습니다.
이벤트 매핑 에서 다음의 단계를 수행하여 Awin에 직접 전송하고자 하는 인앱 이벤트를 선택합니다.
이벤트 매핑 을 선택합니다.
Adjust 이벤트 목록에서 Awin과(와) 공유하고자 하는 Adjust 이벤트를 선택합니다.
파트너 이벤트 에서 Adjust 이벤트에 상응하는 Awin 이벤트를 선택해야 합니다.
단일 플랫폼 앱 및 단일 플랫폼에 대해서만 데이터 공유가 활성화된 멀티 플랫폼 앱의 경우, 해당 플랫폼에 대해서만 데이터 공유 옵션을 설정합니다. 멀티 플랫폼에 대한 데이터 공유가 활성화되어 있는 멀티 플랫폼 앱의 경우 다음을 설정할 수 있습니다.
- 플랫폼별 매핑 사용 을 선택하여 플랫폼 수준에서 개별 이벤트를 매핑하거나 특정 플랫폼에 대한 이벤트를 매핑하지 않을 수 있습니다.
- 모든 플랫폼에 대해 동일한 이벤트를 매핑하려면 글로벌 매핑 사용 을 선택합니다.
파트너 이벤트 목록에서 Adjust 이벤트를 매핑하고자 하는 커스텀 이벤트 이름을 선택하거나 입력합니다.
적용 을 선택합니다.
이제 연결된 이벤트 데이터가 Awin에게 전송됩니다.
모든 이벤트 매핑
Awin이(가) 모든 이벤트 자동 매핑을 지원하는 경우 이벤트 매핑 에서 모든 이벤트 매핑 을 선택 합니다. 이를 통해 개별 이벤트를 매핑하는 시간을 절약할 수 있습니다.
이제 연결된 인앱 이벤트 데이터가 Awin에게 전송됩니다.
파라미터 매핑
Awin에 커스텀 데이터를 공유하려면 일반적으로 파라미터 매핑이 필요합니다.
파트너 파라미터(Adjust SDK 버전 4.0+에서 이용 가능)를 통해 Adjust는 앱에서 커스텀 데이터 포인트를 수집하여 Awin에 전송할 수 있습니다. 이를 통해 Awin은(는) 연결된 개별 이벤트에 대한 커스텀 이벤트 상세 정보를 수신할 수 있습니다.
Adjust SDK에 새로운 파트너 파라미터를 추가하기 전, 요구 사항을 충족하는 파트너 파라미터가 이미 존재하는지 확인하시기 바랍니다.
파트너 파라미터를 Awin에 공유하려면 다음의 단계를 수행하시기 바랍니다.
Adjust SDK 내에서 파트너 파라미터를 설정합니다.
- 시작하기 전에 모든 SDK 개발 플랫폼 링크를 확인하시기 바랍니다.
데이터 공유 옵션 설정 에서 파라미터 를 선택합니다.
파라미터 매핑 에서는 SDK에서 정의된 파트너 파라미터를 네트워크에 어떠한 방식으로 보낼지 지정할 수 있습니다.
- 파라미터 매핑 을 선택합니다.
- SDK 파라미터 필드에 네트워크와 공유하고자 하는 SDK 파라미터 이름을 입력합니다.
- 네트워크 파라미터 영역에 SDK 파라미터에 상응하는 네트워크 파라미터를 입력합니다.
대시보드에서 파라미터 공유를 설정하지 않고 Adjust SDK 내에서 파트너 파라미터를 설정한 경우, Adjust는 Adjust SDK에 설정된 파라미터명을 그대로 전송합니다.
링크 및 설정 구성
다음을 설정할 수 있습니다.
링크 생성 및 Awin에게 공유
설정 검토 화면에서는 선택 사항을 검토할 수 있습니다. 이전 페이지로 돌아가서 다음을 변경할 수도 있습니다.
- 선택한 앱
- 데이터 공유 옵션
- 링크 구조 파라미터
- 사용자 이동 위치
- 어트리뷰션 설정
링크 생성 을 선택하여 클릭 URL, 노출 URL, QR 코드 및 링크 토큰을 생성합니다. 링크를 생성하면 Awin과(와)의 데이터 공유 및 연동이 활성화 됩니다.
링크가 생성되면 Awin에 공유하여 캠페인에 배치할 수 있습니다.
파트너별 설정 가이드
Awin의 연동을 통해 미리 정의된 파라미터 세트를 전송할 수 있습니다. Adjust SDK의 이벤트에 아래의 파라미터를 추가하면 이는 Awin으로 전송됩니다. SDK readme에서 사용 중인 SDK와 관련된 파트너 파라미터 추가에 대한 자세한 내용을 확인하시기 바랍니다. 다음은 Awin이 수신할 수 있는 사전 정의 파라미터의 목록입니다.
파라미터 키 > 값
- orderId> order reference (매출 이벤트에 필수)
- commission_group> commission group (매출 이벤트에 필수)
- vc> 바우처 코드
- custom[3,29]> 맞춤 파라미터 [3,29]
- custom[31,50]> custom parameter [31,50]
- commission_group> commission group (매출 이벤트에 필수)
- awin_revenue
Awin 플랫폼에서 이벤트를 올바르게 측정하려면 Adjust SDK의 매출 이벤트에 필수 파라미터를 첨부하십시오.
예시 (Android SDK 사용)
Adjust SDK 연동에서 다음의 파트너 파라미터 설정 시:
AdjustEvent adjustEvent = new AdjustEvent("abc123");
adjustEvent.addPartnerParameter("cg","AABBCC");
adjustEvent.addPartnerParameter("commission_group","DDEEFF");
Adjust.trackEvent(adjustEvent);
이후 Adjust가 Awin Aff ID를 사용하여 인게이지먼트에 활동을 어트리뷰션 한 경우, Adjust는 파트너 파라미터 설정을 "cg"로 Awin에 전달합니다. (예시: cg=AABBCC )
Awin Aff ID를 찾을 수 없는 경우, Adjust는 "commission_group"으로 설정된 파트너 파라미터를 검색하거나 이 값이 존재하지 않을 시, "cg"로 폴백 후 파트너 파라미터를 전송합니다. (예시: commission_group=DDEEFF; fallback to cg=AABBCC )
Awin에 전송되는 모든 파라미터 목록
Adjust는 Awin의 콜백에 다음의 파라미터(데이터 포인트)를 전송합니다.
플레이스홀더 | 정보 |
{adid} | Adjust 기기 ID(모든 플랫폼) |
{currency} | Adjust SDK에서 전송된 ISO 4217 고유 통화 코드 |
{event_name} | 대시보드에서 설정한 이벤트 이름 |
{os_name} | 기기 운영 체제 |
{partner_parameters} | Adjust SDK나 S2S 요청에 의해 수집되고, 포스트백을 통해 서드파티 제공자에게 전송된 맞춤 파트너 파라미터 |
{revenue_float} | Adjust SDK에서 전송된 매출(전체 통화 단위) |
{click_time} | 어트리뷰션된 클릭 타임스탬프 |