GetLoyal 모듈 설정 가이드
GetLoyal은(는) Adjust와 연동된 광고 네트워크입니다. Adjust와의 연동을 통해 GetLoyal은(는) 어트리뷰션과 인앱 이벤트 데이터를 콜백으로 수신합니다.
이 페이지에서는 GetLoyal와(과)의 설정 방법을 확인하실 수 있습니다. GetLoyal 활성화, 캠페인 링크 생성, Adjust가 공유할 수 있는 데이터 선택 방법을 아래에서 확인하시기 바랍니다.
시작에 앞서
요구 사항
- Adjust의 관리자, 편집자 또는 사용자 지정 편집자 권한 .
- Adjust SDK v4.0.0 이상 버전에서 SDK 파라미터를 GetLoyal 파라미터에 매핑하시기 바랍니다. 자세한 내용은 아래 링크된 가이드를 통해 확인하실 수 있습니다.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Campaign Lab에서 GetLoyal과 앱 선택
- Campaign Labs 에서 파트너 를 선택합니다.
- 새 파트너 > GetLoyal 을 선택합니다. 다음 을 선택하여 다음 화면으로 이동합니다.
- 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택하고, GetLoyal를(을) 활성화하여 파트너와 데이터를 공유합니다.
- 다음 을 선택합니다.
데이터 공유 활성화
GetLoyal와(과)의 연동을 활성화하려면 다음의 단계를 수행하시기 바랍니다.
- 활성화 켜기
GetLoyal와(과)의 데이터 공유가 활성화되면, Adjust는 기본 설정에 따라 다음의 데이터를 자동으로 GetLoyal에 전송합니다.
- 설치
- 이벤트
데이터 공유 옵션 설정
멀티 플랫폼에 대해 데이터 공유가 활성화된 멀티 플랫폼 앱인 경우, 다음이 가능합니다:
- 플랫폼별 설정 사용 을 선택하여 플랫폼 수준에서 데이터 공유 옵션을 구분.
- 글로벌 설정 사용 을 선택하여 여러 플랫폼에 대해 동일한 데이터 공유 설정을 적용.
기본 설정으로 공유되는 데이터 에서 Adjust가 GetLoyal과 디폴트로 공유하는 활동을 확인하시기 바랍니다.
- 설치
- 이벤트
추가 데이터 전송
콜백을 통해 GetLoyal과(와) 공유하고자 하는 데이터의 양과 유형을 선택합니다. GetLoyal은(는) 퍼포먼스 최적화를 위해 이 정보를 사용할 수 있습니다.
- 공유하고자 하는 데이터 소스 에서 GetLoyal과(와) 공유하는 데이터의 어트리뷰션 소스를 선택합니다.
- 모든 어트리뷰션 소스의 데이터
- GetLoyal에게 어트리뷰션된 데이터
인앱 매출 (인앱 구매로부터의 매출)
인앱 매출 공유가 활성화되면 GetLoyal에 매출 금액과 매출 이벤트 데이터를 전송할 수 있습니다. 이 데이터를 공유하려면 매출을 창출하는 이벤트를 매핑 해야 합니다.
이벤트 매핑
공유하고자 하는 이벤트를 GetLoyal이(가) 수신할 수 있는 값에 매핑합니다. 매핑되지 않은 이벤트는 GetLoyal 에 공유되지 않습니다.
개별 이벤트 매핑
멀티 플랫폼 앱의 경우, GetLoyal과(와) 플랫폼별로 다른 이벤트를 공유할 수 있습니다. 이를 통해서,
- 개별 이벤트를 설정하여 각 플랫폼에 대한 캠페인 전략을 관리할 수 있습니다.
- 플랫폼별로 데이터 공유를 맞춤화할 수 있습니다.
이벤트 매핑 에서 다음의 단계를 수행하여 GetLoyal에 직접 전송하고자 하는 인앱 이벤트를 선택합니다.
이벤트 매핑 을 선택합니다.
Adjust 이벤트 목록에서 GetLoyal과(와) 공유하고자 하는 Adjust 이벤트를 선택합니다.
파트너 이벤트 에서 Adjust 이벤트에 상응하는 GetLoyal 이벤트를 선택해야 합니다.
단일 플랫폼 앱 및 단일 플랫폼에 대해서만 데이터 공유가 활성화된 멀티 플랫폼 앱의 경우, 해당 플랫폼에 대해서만 데이터 공유 옵션을 설정합니다. 멀티 플랫폼에 대한 데이터 공유가 활성화되어 있는 멀티 플랫폼 앱의 경우 다음을 설정할 수 있습니다.
- 플랫폼별 매핑 사용 을 선택하여 플랫폼 수준에서 개별 이벤트를 매핑하거나 특정 플랫폼에 대한 이벤트를 매핑하지 않을 수 있습니다.
- 모든 플랫폼에 대해 동일한 이벤트를 매핑하려면 글로벌 매핑 사용 을 선택합니다.
파트너 이벤트 목록에서 Adjust 이벤트를 매핑하고자 하는 커스텀 이벤트 이름을 선택하거나 입력합니다.
적용 을 선택합니다.
이제 연결된 이벤트 데이터가 GetLoyal에게 전송됩니다.
모든 이벤트 매핑
GetLoyal이(가) 모든 이벤트 자동 매핑을 지원하는 경우 이벤트 매핑 에서 모든 이벤트 매핑 을 선택 합니다. 이를 통해 개별 이벤트를 매핑하는 시간을 절약할 수 있습니다.
이제 연결된 인앱 이벤트 데이터가 GetLoyal에게 전송됩니다.
파라미터 매핑
GetLoyal에 커스텀 데이터를 공유하려면 일반적으로 파라미터 매핑이 필요합니다.
파트너 파라미터(Adjust SDK 버전 4.0+에서 이용 가능)를 통해 Adjust는 앱에서 커스텀 데이터 포인트를 수집하여 GetLoyal에 전송할 수 있습니다. 이를 통해 GetLoyal은(는) 연결된 개별 이벤트에 대한 커스텀 이벤트 상세 정보를 수신할 수 있습니다.
Adjust SDK에 새로운 파트너 파라미터를 추가하기 전, 요구 사항을 충족하는 파트너 파라미터가 이미 존재하는지 확인하시기 바랍니다.
파트너 파라미터를 GetLoyal에 공유하려면 다음의 단계를 수행하시기 바랍니다.
Adjust SDK 내에서 파트너 파라미터를 설정합니다.
- 시작하기 전에 모든 SDK 개발 플랫폼 링크를 확인하시기 바랍니다.
데이터 공유 옵션 설정 에서 파라미터 를 선택합니다.
파라미터 매핑 에서는 SDK에서 정의된 파트너 파라미터를 네트워크에 어떠한 방식으로 보낼지 지정할 수 있습니다.
- 파라미터 매핑 을 선택합니다.
- SDK 파라미터 필드에 네트워크와 공유하고자 하는 SDK 파라미터 이름을 입력합니다.
- 네트워크 파라미터 영역에 SDK 파라미터에 상응하는 네트워크 파라미터를 입력합니다.
대시보드에서 파라미터 공유를 설정하지 않고 Adjust SDK 내에서 파트너 파라미터를 설정한 경우, Adjust는 Adjust SDK에 설정된 파라미터명을 그대로 전송합니다.
링크 및 설정 구성
다음을 설정할 수 있습니다.
링크 생성 및 GetLoyal에게 공유
설정 검토 화면에서는 선택 사항을 검토할 수 있습니다. 이전 페이지로 돌아가서 다음을 변경할 수도 있습니다.
- 선택한 앱
- 데이터 공유 옵션
- 링크 구조 파라미터
- 사용자 이동 위치
- 어트리뷰션 설정
링크 생성 을 선택하여 클릭 URL, 노출 URL, QR 코드 및 링크 토큰을 생성합니다. 링크를 생성하면 GetLoyal과(와)의 데이터 공유 및 연동이 활성화 됩니다.
링크가 생성되면 GetLoyal에 공유하여 캠페인에 배치할 수 있습니다.
파트너별 설정 가이드
GetLoyal를 통해 사전 정의된 파라미터 세트를 전송할 수 있습니다. Adjust SDK의 이벤트에 아래의 파라미터를 추가하면 이는 GetLoyal로 전송됩니다. SDK readme에서 파트너 파라미터의 추가에 대한 자세한 내용을 확인하시기 바랍니다. 다음은 GetLoyal가 수신할 수 있는 사전 정의 파라미터의 목록입니다.
파라미터 키 > 값
- item_id>사용자가 방문한 제품의 ID. "구매" 이벤트에 필요하며, 전자상거래 앱에서 추적하는 "장바구니에 넣기" 및 "아이템 보기" 이벤트에 사용을 추천합니다.
- restaurant_id>사용자가 방문한 제품의 ID. "구매" 이벤트에 필요하며, 음식 배달 앱에서 추적하는 "장바구니에 넣기" 및 "아이템 보기" 이벤트에 사용을 추천합니다.
- food_id>사용자가 방문한 제품의 ID. "구매" 이벤트에 필요하며, 음식 배달 앱에서 추적하는 "장바구니에 넣기" 및 "아이템 보기" 이벤트에 사용을 추천합니다.
- hotel_id> 사용자가 방문한 호텔의 ID. "구매" 이벤트에 필요하며, 호텔 예약 앱에서 추적하는 "장바구니에 넣기" 및 "아이템 보기" 이벤트에 사용을 추천합니다.
- room_id> 사용자가 방문한 호텔의 ID. "구매" 이벤트에 필요하며, 호텔 예약 앱에서 추적하는 "장바구니에 넣기" 및 "아이템 보기" 이벤트에 사용을 추천합니다.
- board_type> 사용자가 방문한 호텔 숙박 유형. 호텔 예약 앱에서 추적하는 이벤트 전체의 선택 사항입니다. 호텔 예약 앱에서 추적하는 이벤트 전체의 선택 사항입니다.
- destination>사용자가 방문한 여행지. "구매" 이벤트에 필요하며, 여행 앱에서 추적하는 "장바구니에 넣기" 및 "아이템 보기" 이벤트에 사용을 추천합니다.
- origin> 사용자가 방문한 여행 출발지. "구매" 이벤트에 필요하며, 여행 앱에서 추적하는 "장바구니에 넣기" 및 "아이템 보기" 이벤트에 사용을 추천합니다.
GetLoyal에 전송되는 모든 파라미터 목록
Adjust는 GetLoyal의 콜백에 다음의 파라미터(데이터 포인트)를 전송합니다.
| 플레이스홀더 | 정보 |
{adid} | Adjust 기기 ID(모든 플랫폼) |
{city} | 기기 도시 |
{country_subdivision} | 기기의 국가 세분화, 예: 주 |
{country} | 기기 국가 코드(두 자릿수) |
{currency} | Adjust SDK에서 전송된 ISO 4217 고유 통화 코드 |
{device_type} | 기기 유형 |
{gps_adid} | Google Play Store 광고 ID |
{idfa} | 광고주 ID (iOS 만 해당) |
{language} | 기기 언어 코드(두 자릿수) |
{os_name} | 기기 운영 체제 |
{os_version} | 운영 체제 버전 번호 |
{partner_parameters} | Adjust SDK나 S2S 요청에 의해 수집되고, 포스트백을 통해 서드파티 제공자에게 전송된 맞춤 파트너 파라미터 |
{revenue_float} | Adjust SDK에서 전송된 매출(전체 통화 단위) |
{revenue_usd} | 수익 미국 달러 표기 |
{sdk_version} | Adjust SDK 버전(앱 당) |
{user_agent} | 수신되는 미가공 유저 에이전트 |
{adgroup_name} | 트래커에서 가져온 광고그룹 이름 |
{app_id} | Store App ID 또는 Google Play Store |
{campaign_name} | 트래커에서 가져온 캠페인 이름 |
{created_at} | 활동 타임스탬프 |
{creative_name} | 트래커에서 가져온 크리에이티브 이름 |
{installed_at} | 설치(첫 앱 실행) 타임스탬프 |