MOLOCO 모듈 설정 가이드

MOLOCO은(는) Adjust와 연동된 광고 네트워크입니다. Adjust와의 연동을 통해 MOLOCO은(는) 어트리뷰션과 인앱 이벤트 데이터를 콜백으로 수신합니다.

이 페이지에서는 MOLOCO와(과)의 설정 방법을 확인하실 수 있습니다. MOLOCO 활성화, 캠페인 링크 생성, Adjust가 공유할 수 있는 데이터 선택 방법을 아래에서 확인하시기 바랍니다.

시작에 앞서

요구 사항

iOS / Android / Windows / Unity / React Native / Flutter / Adobe Air / Cordova / Marmalade / Xamarin / Cocos2d-x / Titanium / Corona

Campaign Lab에서 MOLOCO과 앱 선택

  1. Campaign Labs에서 파트너를 선택합니다.
  2. 새 파트너 > MOLOCO 을 선택합니다. 다음을 선택하여 다음 화면으로 이동합니다.
  3. 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택하고, MOLOCO를(을) 활성화하여 파트너와 데이터를 공유합니다.
  4. 다음을 선택합니다.

데이터 공유 활성화

MOLOCO와(과)의 연동을 활성화하려면 다음의 단계를 수행하시기 바랍니다.

  1. 활성화를 켭니다.

MOLOCO와(과)의 데이터 공유가 활성화되면, Adjust는 기본 설정에 따라 다음의 데이터를 자동으로 MOLOCO에 전송합니다.

  • 클릭
  • 설치
  • 세션
  • 앱삭제
  • 리어트리뷰션
  • 이벤트
  • 거부된 설치
  • 광고 수익

데이터 공유 옵션 설정

멀티 플랫폼에 대해 데이터 공유가 활성화된 멀티 플랫폼 앱인 경우, 다음이 가능합니다:

  1. 플랫폼별 설정 사용을 선택하여 플랫폼 수준에서 데이터 공유 옵션을 구분.
  2. 글로벌 설정 사용을 선택하여 여러 플랫폼에 대해 동일한 데이터 공유 설정을 적용.

기본 설정으로 공유되는 데이터에서 Adjust가MOLOCO과 디폴트로 공유하는 활동을 확인하시기 바랍니다.

  • 클릭
  • 설치
  • 세션
  • 앱삭제
  • 리어트리뷰션
  • 이벤트
  • 거부된 설치
  • 광고 수익

추가 데이터 전송

콜백을 통해 MOLOCO과(와) 공유하고자 하는 데이터의 양과 유형을 선택합니다. MOLOCO은(는) 퍼포먼스 최적화를 위해 이 정보를 사용할 수 있습니다.

  1. 공유하고자 하는 데이터 소스에서 MOLOCO과(와) 공유하는 데이터의 어트리뷰션 소스를 선택합니다.
  • 모든 어트리뷰션 소스의 데이터
  • MOLOCO에게 어트리뷰션된 데이터

인앱 매출 (인앱 구매로부터의 매출)

인앱 매출 공유가 활성화되면 MOLOCO에 매출 금액과 매출 이벤트 데이터를 전송할 수 있습니다. 이 데이터를 공유하려면 매출이 발생하는 이벤트가 매핑되어야 합니다.

광고 매출 (광고 뷰로부터의 매출)

광고 매출 공유 활성화를 통해 MOLOCO에 사용자 광고 매출 데이터를 전송할 수 있습니다. 이를 통해 MOLOCO은(는) 광고 매출 데이터를 사용하여 사용자 타겟팅하고 캠페인을 최적화할 수 있습니다.

성장 솔루션:

이 기능은 Adjust의 RevWorks 패키지에서만 이용 가능합니다. Adjust의 RevWorks 패키지를 구매하려면 세일즈 담당자에게 문의하시기 바랍니다.

광고 매출을 MOLOCO과 공유하려면 하나 이상의 광고 매출 소스 를 선택해야 합니다.

  • 해당 필드를 비워두었을 경우 Adjust는 연결된 모든 미디에이션 소스의 광고 매출 데이터를 전송합니다.

세션

세션은 데이터 양이 많기 때문에 Adjust는 세션 콜백을 자동으로 전송하지 않습니다. MOLOCO에게 앱의 세션 활동 데이터가 전송되기 위해서는 세션 공유가 활성화 되어야 합니다.

파라미터 매핑

MOLOCO에 커스텀 데이터를 공유하려면 일반적으로 파라미터 매핑이 필요합니다.

이벤트 매핑

공유하고자 하는 이벤트를 MOLOCO이(가) 수신할 수 있는 값에 매핑합니다. 매핑되지 않은 이벤트는 MOLOCO에 공유되지 않습니다.

이벤트 매핑에서 다음의 단계를 수행하여 MOLOCO에 직접 전송하고자 하는 인앱 이벤트를 선택합니다.

  1. 이벤트 매핑을 선택합니다.
  2. Adjust 이벤트 목록에서 MOLOCO과(와) 공유하고자 하는 Adjust 이벤트를 선택합니다.
  3. 파트너 이벤트 목록에서 Adjust 이벤트를 매핑하고자 하는 커스텀 이벤트 이름을 선택 또는 입력합니다. 이 떄, 하나의 이벤트를 복수의 값과 매핑해야 할 수 있습니다.
  4. 적용을 선택합니다.

이제 연결된 이벤트 데이터가 MOLOCO에게 전송됩니다.

파라미터 매핑

파트너 파라미터(Adjust SDK 버전 4.0+에서 이용 가능)를 통해 Adjust는 앱에서 커스텀 데이터 포인트를 수집하여 MOLOCO에 전송할 수 있습니다. 이를 통해 MOLOCO은(는) 연결된 개별 이벤트에 대한 커스텀 이벤트 상세 정보를 수신할 수 있습니다.

Adjust SDK에 새로운 파트너 파라미터를 추가하기 전, 요구 사항을 충족하는 파트너 파라미터가 이미 존재하는지 확인하시기 바랍니다.

파트너 파라미터를 MOLOCO에 공유하려면 다음의 단계를 수행하시기 바랍니다.

  1. Adjust SDK( iOS, Android ) 내에서 파트너 파라미터를 설정합니다.
  2. 파라미터 데이터 공유 체크박스를 선택합니다.
  3. 이벤트를 매핑합니다.
참고:

대시보드에서 파라미터 공유를 설정하지 않고 Adjust SDK 내에서 파트너 파라미터를 설정한 경우, Adjust는 Adjust SDK에 설정된 파라미터명을 그대로 전송합니다.

링크 및 설정 구성

다음을 설정할 수 있습니다.

링크 생성 및 MOLOCO에게 공유

설정 검토 화면에서는 선택 사항을 검토할 수 있습니다. 이전 페이지로 돌아가서 다음을 변경할 수도 있습니다.

  • 선택한 앱
  • 데이터 공유 옵션
  • 링크 구조 파라미터
  • 사용자 이동 위치
  • 어트리뷰션 설정

링크 생성 을 선택하여 클릭 URL, 노출 URL, QR 코드 및 링크 토큰을 생성합니다. 링크를 생성하면 MOLOCO과(와)의 데이터 공유 및 연동이 활성화 됩니다.

링크가 생성되면 MOLOCO에 공유하여 캠페인에 배치할 수 있습니다.

MOLOCO에 전송되는 모든 파라미터 목록

Adjust는 MOLOCO의 콜백에 다음의 파라미터(데이터 포인트)를 전송합니다.

플레이스홀더정보
{adid}Adjust 기기 ID(모든 플랫폼)
{android_id}Android ID (Android only)
{city}기기 도시
{country}기기 국가 코드(두 자릿수)
{device_name}기기 모델 번호
{gps_adid}Google Play Store 광고 ID
{idfa}광고주 ID (iOS 만 해당)
{idfv}벤더용 대문자 iOS ID
{ip_address}기기 IP 주소
{language}기기 언어 코드(두 자릿수)
{mac_md5}Uppercase MAC MD5 hash
{mac_sha1}Uppercase MAC SHA-1 hash
{match_type}어트리뷰션 방식
{os_name}기기 운영 체제
{os_version}운영 체제 버전 번호
{partner_parameters}Adjust SDK나 S2S 요청에 의해 수집되고, 포스트백을 통해 서드파티 제공자에게 전송된 맞춤 파트너 파라미터
{postal_code}IP 주소의 기기 우편 번호
{random}무작위 숫자(각 콜백에 고유함)
{referrer}구글 플레이 스토어 리퍼러(안드로이드만 해당)
{region}기기 지역 코드
{revenue_usd}수익 미국 달러 표기
{sdk_version}Adjust SDK 버전(앱 당)
{session_count}현재 Adjust SDK에서 기록한 세션 수
{time_spent}유저의 현 세션 길이(초 단위)
{timezone}기기 시간대
{tracking_enabled}트래킹이 활성화된 경우는 1, 비활성화된 경우는 0
{tracking_limited}트래킹이 제한되어 있으면 1, 제한되지 않은 경우 0
{user_agent}수신되는 미가공 유저 에이전트
{win_hwid}Windows 스토어 하드웨어 ID
{win_naid}Windows 스토어 네트워크 어댑터 ID
{win_udid}Windows Phone 고유의 기기 ID
{adgroup_name}트래커에서 가져온 광고그룹 이름
{app_id}Store App ID 또는 Google Play Store
{app_name}앱 이름
{app_version}앱 버전 번호(Android), 번들용 빌드 버전 번호(iOS)
{campaign_name}트래커에서 가져온 캠페인 이름
{click_time}어트리뷰션된 클릭 타임스탬프
{created_at}활동 타임스탬프
{creative_name}트래커에서 가져온 크리에이티브 이름
{impression_based}노출 기반 인게이지먼트면 1, 그 외는 0
{impression_time}어트리뷰션된 노출 타임스탬프
{install_begin_time}앱 다운로드가 시작된 시점의 타임스탬프(안드로이드와 구글 플레이 스토어만 해당)
{install_finish_time}앱 다운로드 완료 타임스탬프
{is_organic}오가닉 트래픽 인 경우 1, 비오가닉인 경우 0
{network_name}트래커에서 가져온 네트워크 이름
{referral_time}유저가 앱 플레이 스토어 페이지에 랜딩한 시점의 타임스탬프(안드로이드와 구글 플레이 스토어만 해당)
{rejection_reason}거부된 설치의 이유
{store}클릭의 타겟 스토어
{ad_impressions_count}최종 사용자에게 게재된 모바일 광고 수
{ad_revenue_network}광고를 표시한 광고 네트워크
{ad_revenue_unit}수익을 창출한 광고 단위
{ad_revenue_placement}플랫폼에 정의된 사용자 배치
{ad_mediation_platform}미디에이션 플랫폼 이름
{ad_revenue_payload}노출 수준 매출 데이터(ILRD) JSON 파일