Precog for App 모듈 설정 가이드

Precog for App은(는) Adjust와 연동된 애널리틱스 파트너입니다. Adjust 연동을 통해 Precog for App은(는) 자동화 콜백으로 Adjust에서 측정된 데이터를 수신합니다. 이러한 데이터를 파트너의 툴과 함께 분석 및 인사이트에 활용할 수 있습니다.

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

시작에 앞서

요구 사항

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

인증 정보

API KEY, DATABASE NAME, TABLE NAME

  • 인증 정보를 찾는 데 도움이 필요한 경우에는 Precog for App 담당자에게 문의하시기 바랍니다.

Campaign Lab에서 Precog for App 및 앱 선택

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

데이터 공유 활성화

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

  1. API KEY, DATABASE NAME, TABLE NAME을 입력합니다.

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

  • 클릭
  • 노출
  • 설치
  • 세션
  • 앱삭제
  • 재설치
  • 리어트리뷰션 재설치
  • 리어트리뷰션

데이터 공유 옵션 설정

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

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

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

  • 클릭
  • 노출
  • 설치
  • 세션
  • 앱삭제
  • 재설치
  • 리어트리뷰션 재설치
  • 리어트리뷰션

추가 데이터 전송

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

추가 데이터 전송을 위해 다음 항목을 검토하고 설정할 수 있습니다.

세션

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

삭제 또는 재설치

삭제 또는 재설치 데이터를 공유하면 Precog for App이(가) 해당 앱에 대해 Adjust가 측정하는 삭제 및/또는 재설치 데이터를 수신합니다.

참고:

iOS 앱의 경우, 삭제 및/또는 재설치 수가 낮을 수 있습니다. 자세한 정보는 삭제 및 재설치 측정 페이지를 참조하시기 바랍니다.

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

인앱 매출 공유가 활성화되면 Precog for App에 매출 금액과 매출 이벤트 데이터를 전송할 수 있습니다. 이 데이터를 공유하려면 매출을 창출하는 이벤트를 매핑 해야 합니다.

이벤트 매핑

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

개별 이벤트 매핑

멀티 플랫폼 앱의 경우, Precog for App과(와) 플랫폼별로 다른 이벤트를 공유할 수 있습니다. 이를 통해 다음이 가능합니다.

  • 개별 이벤트를 설정하여 각 플랫폼에 대한 캠페인 전략 관리.
  • 플랫폼별로 데이터 공유를 맞춤화할 수 있습니다.

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

  1. 이벤트 매핑 을 선택합니다.

  2. Adjust 이벤트 목록에서 Precog for App과(와) 공유하고자 하는 Adjust 이벤트를 선택합니다.

  3. 파트너 이벤트 에서 Adjust 이벤트에 상응하는 Precog for App 이벤트를 선택해야 합니다.

    1. 단일 플랫폼 앱 및 단일 플랫폼에 대해서만 데이터 공유가 활성화된 멀티 플랫폼 앱의 경우, 해당 플랫폼에 대해서만 데이터 공유 옵션을 설정합니다. 멀티 플랫폼에 대한 데이터 공유가 활성화되어 있는 멀티 플랫폼 앱의 경우 다음을 설정할 수 있습니다.

      • 플랫폼별 매핑 사용 을 선택하여 플랫폼 수준에서 개별 이벤트를 매핑하거나 특정 플랫폼에 대한 이벤트를 매핑하지 않을 수 있습니다.
      • 모든 플랫폼에 대해 동일한 이벤트를 매핑하려면 글로벌 매핑 사용 을 선택합니다.

    2. 파트너 이벤트 목록에서 Adjust 이벤트를 매핑하고자 하는 커스텀 이벤트 이름을 선택하거나 입력합니다.

  4. 적용 을 선택합니다.

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

전체 이벤트 매핑

Precog for App이(가) 모든 이벤트 자동 매핑을 지원하는 경우 이벤트 매핑 에서 전체 이벤트 매핑 을 선택 합니다. 이를 통해 개별 이벤트를 매핑하는 시간을 절약할 수 있습니다.

이제 연결된 인앱 이벤트 데이터가 Precog for App에게 전송됩니다.

파라미터 매핑

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

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

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

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

  1. Adjust SDK 내에서 파트너 파라미터를 설정합니다.

  2. 데이터 공유 옵션 설정 에서 파라미터 를 선택합니다.

  3. 파라미터 매핑 에서는 SDK에서 정의된 파트너 파라미터를 네트워크에 어떠한 방식으로 보낼지 지정할 수 있습니다.

    1. 파라미터 매핑 을 선택합니다.
    2. SDK 파라미터 필드에 네트워크와 공유하고자 하는 SDK 파라미터 이름을 입력합니다.
    3. 네트워크 파라미터 영역에 SDK 파라미터에 상응하는 네트워크 파라미터를 입력합니다.
참고:

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

앱에 대해 Precog for App 활성화

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

  • 선택한 앱
  • 데이터 공유 옵션

파트너 활성화 를 선택하여 앱에 대해 Precog for App을 활성화합니다. 애널리틱스 파트너는 캠페인 링크를 사용할 수 없습니다. 활성화가 완료되면 어트리뷰션과 인앱 이벤트 데이터가 자동으로 전송됩니다.

Precog for App에 전송되는 모든 파라미터 목록

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

플레이스홀더정보
{city}기기 도시
{click_attribution_window}기기 매칭에 대한 어트리뷰션 윈도우 설정(시간 단위)
{country_subdivision}기기의 국가 세분화, 예: 주
{country}기기 국가 코드(두 자릿수)
{currency}Adjust SDK에서 전송된 ISO 4217 고유 통화 코드
{deeplink}클릭 URL에 딥링크 URL 추가
{device_name}기기 모델 번호
{device_type}기기 유형
{environment}현재 Adjust SDK 환경 설정
{event_name}대시보드에서 설정한 이벤트 이름
{gclid}구글 클릭 ID
{idfa||android_id}IDFA. IDFA가 없는 경우 안드로이드 ID
{idfa||gps_adid}IDFA 또는 IDFA가 없는 경우 GPS ADID
{idfv}벤더용 대문자 iOS ID
{impression_attribution_window}노출 매칭에 대한 어트리뷰션 윈도우 설정(시간 단위)
{inactive_user_definition}리어트리뷰션에 필요한 비활성화 기간(시간 단위)
{ip_address}기기 IP 주소
{language}기기 언어 코드(두 자릿수)
{last_time_spent}사용자의 마지막 세션 길이(초 단위)
{match_type}어트리뷰션 방식
{mnc}모바일 네트워크 코드: 2 자릿수 코드. 기기의 이동통신사를 명시하기 위해 모바일 국가 코드와 함께 사용.
{nonce}무작위 소문자 영숫자 문자열(각 콜백에 고유함)
{os_name}기기 운영 체제
{os_version}운영 체제 버전 번호
{partner_parameters}Adjust SDK나 S2S 요청에 의해 수집되고, 포스트백을 통해 서드파티 제공자에게 전송된 맞춤 파트너 파라미터
{postal_code}IP 주소의 기기 우편 번호
{random_user_id}무작위 사용자 ID(기기당)
{random}무작위 숫자(각 콜백에 고유함)
{reattribution_attribution_window}리어트리뷰션에 대한 어트리뷰션 윈도우(시간 단위)
{reftag}임의 기기 참조 태그
{region}기기 지역 코드
{revenue_float}Adjust SDK에서 전송된 매출(전체 통화 단위)
{revenue_usd_cents}수익 미국 센트 표기
{revenue}Adjust SDK에서 전송된 매출(센트)
{search_term}Google 오가닉 검색 용어
{session_count}현재 Adjust SDK에서 기록한 세션 수
{time_spent}유저의 현 세션 길이(초 단위)
{timezone}기기 시간대
{tracking_enabled}트래킹이 활성화된 경우는 1, 비활성화된 경우는 0
{tracking_limited}트래킹이 제한되어 있으면 1, 제한되지 않은 경우 0
{user_agent}수신되는 미가공 유저 에이전트
{activity_kind}사용자 활동 유형
{adgroup_name}트래커에서 가져온 광고그룹 이름
{app_id}Store App ID 또는 Google Play Store
{app_name}앱 이름
{campaign_name}트래커에서 가져온 캠페인 이름
{click_referer}클릭으로부터의 리퍼러 헤더
{click_time}어트리뷰션된 클릭 타임스탬프
{connection_type}인터넷 연결 유형
{conversion_duration}클릭으로부터 설치 또는 리어트리뷰션까지 걸린 시간(초 단위)
{created_at}활동 타임스탬프
{creative_name}트래커에서 가져온 크리에이티브 이름
{engagement_time}인게이지먼트 타임스탬프
{installed_at}설치(첫 앱 실행) 타임스탬프
{is_organic}오가닉 트래픽 인 경우 1, 비오가닉인 경우 0
{last_tracker_name}리어트리뷰션된 유저의 이전 트래커 이름
{last_tracker}리어트리뷰션된 유저의 이전 트래커에 대한 Adjust의 6자리 트래커 토큰
{network_name}트래커에서 가져온 네트워크 이름
{reattributed_at}리어트리뷰션 타임스탬프
{store}클릭의 타겟 스토어
{tracker_name}현재 트래커 이름
{tracker}6자로 이루어진 Adjust 트래커 토큰