디파이너리(애드브릭스) 연동 가이드

English
한국어

개요

소개

크리테오는 구매 가능성이 높은 모바일 앱 사용자에게 개인화 된 광고를 제공합니다. 크리테오 기술은 실시간 제품 추천 최적화 및 예측 엔진을 기반으로 합니다.

크리테오의 기술을 사용하려면 다음과 같은 사항이 필요합니다:

  • App events - 앱 이벤트 및 관련 데이터를 올바르게 전송할 수 있도록 모바일 앱을 구현합니다.
  • Deep Link Capability - 앱은 사용자가 선택한 상품 페이지로 이동하는 딥 링크 기능을 지원합니다.
  • Catalog Feed - 모바일 앱 이벤트와 관련된 모든 상품 정보를 CSV 또는 XML 파일 형태로 제공합니다. (카탈로그 피드라고 함).

이 페이지는 IGAWorks: 디파이너리(애드브릭스) SDK로 Criteo Commerce Growth의 App Conversion, App Install, App Re-Engagement 캠페인을 설정하는 방법을 안내합니다.

가이드에 대하여

이 문서는 다음 사항들에 대한 정보를 제공합니다:

  • 업종별 권장 이벤트
  • 앱컨버전 캠페인을 위한 이벤트 구현
  • 앱인스톨 캠페인을 위한 이벤트 구현
  • 포스트백 설정
  • 트래킹 생성
  • 기여 설정
  • 매체 권한 설정
  • 딥 링크
  • 카탈로그 피드
  • 크로스 디바이스 타겟팅을 위한 이메일 해시
  • 테스트 프로세스

업종별 권장 이벤트

“user-flow”를 설명하는 모든 이벤트를 전송하는 것을 권장합니다. 업종별 권장 이벤트는 다음과 같습니다:

Event Name Description Retail Travel Classified Gaming Streaming Entertainment Finance Dating Social RideHailing
app open/app launch 사용자가 앱을 설치할 때 Y Y Y Y Y Y Y Y
home page / App open 사용자가 앱을 열거나 홈페이지에 도착할 때 Y Y Y Y Y Y Y Y
view item list / listing 사용자가 품목/상품/제공 목록을 볼 때 Y Y Y Y Y
view item 사용자가 하나의 특정 품목/상품 / 제공을 볼 때 Y Y Y Y Y Y
add to cart 사용자가 장바구니에 품목/제품을 추가 할 때 Y Y
basket 사용자가 장바구니에 품목/제품을 추가 할 때 Y Y
purchase 사용자가 구매할 때 Y Y Y Y Y Y
add to wish list 사용자가 위시리스트에 품목 / 제품을 추가 할 때 Y Y
complete registration / create an account / sign up 사용자가 계정을 만들거나 등록하거나 등록을 완료하면 Y Y Y Y Y Y Y Y
login 사용자가 로그인 할 때 Y Y Y Y Y Y Y Y
add payment info 사용자가 결제 정보를 추가 할 때 Y Y Y Y
begin checkout 사용자가 구매 절차를 시작할 때 Y Y Y
purchase cancelled / purchase refund 사용자가 구매를 취소하거나 환불을 요청할 때 Y Y Y
generate lead 사용자가 리드를 생성하는 경우 : 연락처 세부 정보 요청 / 메시지 전송 (분류/작업 앱, 교육, 지역 거래, 부동산) Y
start trial 사용자가 모바일 앱의 평가판을 시작할 때 Y Y Y Y
subscribe 사용자가 구독 할 때 (반복 결제) Y (예. 프라임 회원 프로그램 가입) Y Y Y
select item / a user has selected an item 사용자가 모바일 앱에서 콘텐츠를 선택한 경우 Y Y
earn virtual currency 사용자가 가상 화폐를받을 때 (Gamin Apps) Y
level up 사용자가 레벨을 통과 할 때 (Gaming apps) Y
spend virtual currency/credit 사용자가 가상 화폐를 사용할 때 (Gamin Apps) Y
tutorial begin 사용자가 튜토리얼을 시작할 때(Gaming app) Y
tutorial complete 사용자가 튜토리얼을 완료하면(Gaming app) Y
unlock achievement 사용자가 목표를 달성할 때 (Gaming app) Y
search Y
video/audio start or media play 사용자가 모바일 앱에서 미디어를 재생하기 시작하면 (예 : 음악 스트리밍 앱, 비디오 스트리밍 앱 …) Y

이벤트 구현

SDK initialization

자세한 앱초기화 설정 방법은 디파이너리(애드브릭스) 연동가이드를 참조하세요. 앱키와 시크릿키는 디파이너리(애드브릭스)가 앱을 구분하기 위한 식별값입니다. SDK 연동을 위해서 반드시 필요한 값으로, 디파이너리(애드브릭스) 콘솔에서 앱 등록 후 확인할 수 있습니다.

앱 키 & 시크릿 키 확인. 앱 키와 시크릿 키는 디파이너리(애드브릭스)가 앱을 구분하기 위한 식별 값입니다. SDK 연동을 위해서 반드시 필요한 값으로, 디파이너리(애드브릭스) 콘솔에서 앱 등록 후 확인할 수 있습니다. - 앱_앱키, 시크릿키 확인 방법 , - 디파이너리(애드브릭스) 콘솔 바로가기

앱컨버전 캠페인, 앱인게이지먼트 캠페인을 위한 이벤트

크리테오는 다음 이벤트를 구현해야 합니다인

Event Name Description Option
viewHome and appLaunch App open / app brought to the foreground. 필수
viewListing View of a list of products. 권장
viewProduct View of a specific product. 필수
viewBasket View of shopping cart. 권장
trackTransaction Purchase of one or more products. 필수

viewHome

viewHome 이벤트는 새로운 사용자 세션이 열릴 때 전송됩니다. 디파이너리(애드브릭스) 대시보드에서 abx:view_home 이벤트가 크리테오의 viewHome 포스트백에 연결 및 Postback Scope을 All로 설정합니다.

viewListing

viewListing 이벤트는 카테고리 페이지 또는 검색 결과 페이지와 같은 상품 목록을 표시하는 페이지에서 실행되어야 합니다. 페이지에 표시된 처음 3개의 제품 ID를 포함해야 합니다. 이 ID는 고유해야하며 카탈로그 피드에 사용 된 것과 일치해야 합니다. 디파이너리(애드브릭스) 대시보드에서 abx:list_view 이벤트가 크리테오의 viewListing 포스트백에 연결 및 Postback Scope을 All로 설정합니다.

viewProduct

모든 상품 세부 정보 페이지에서 viewProduct 이벤트를 전송합니다. 페이지에 설명 된 제품의 ID를 사용해야합니다. 이 ID는 카탈로그 피드로 전달한 상품의 ID와 일치하는 고유한 ID입니다. 디파이너리(애드브릭스) 대시보드에서 abx:product_view 이벤트가 크리테오의 viewProduct 포스트백에 연결 및 Postback Scope을 All로 설정합니다.

viewBasket

장바구니 세부 정보 페이지에서 viewBasket 이벤트를 전송합니다. 장바구니에 담겨있는 모든 상품의 ID, 단일 가격(상품 1개 가격) 및 수량 정보를 반드시 전송합니다. 이 ID는 카탈로그 피드로 전달한 상품의 ID와 일치하는 고유한 ID입니다. 디파이너리(애드브릭스) 대시보드에서 abx:cart_view 이벤트가 크리테오의 viewBasket 포스트백에 연결 및 Postback Scope을 All로 설정합니다.

trackTransaction

구매 완료 페이지에서 trackTransaction 이벤트를 전송합니다. 구매한 상품의 ID, 단일 가격(상품 1개 가격) 및 수량과 함께 고유한 거래 ID를 반드시 전송합니다. 디파이너리(애드브릭스) 대시보드에서 abx:purchase 이벤트가 크리테오의 trackTransaction 포스트백에 연결 및 Postback Scope을 All로 설정합니다.

앱 설치 캠페인을 위한 이벤트

크리테오는 앱 설치 캠페인을 위해 다음 이벤트를 구현해야 합니다.

Event Name Description Option
install install 필수
viewHome and appLaunch App open / app brought to the foreground. 필수
trackTransaction Purchase of one or more products. 필수

Install

Install 이벤트는 새로운 사용자 앱을 설치했을 때 전송됩니다. 디파이너리(애드브릭스) 대시보드 App Open Postbacks 대시보드에서 New install, Re-install, Depplink Open 이벤트를 활성화 포스트백에 연결 및 Postback Scope을 All로 설정합니다.

viewHome

viewHome 이벤트는 새로운 사용자 세션이 열릴 때 전송됩니다. 디파이너리(애드브릭스) 대시보드에서 abx:view_home 이벤트가 크리테오의 viewHome 포스트백에 연결 및 Postback Scope을 All로 설정합니다.

trackTransaction

구매 완료 페이지에서 trackTransaction 이벤트를 전송합니다. 구매한 상품의 ID, 단일 가격(상품 1개 가격) 및 수량과 함께 고유한 거래 ID를 반드시 전송합니다. 디파이너리(애드브릭스) 대시보드에서 abx:purchase 이벤트가 크리테오의 trackTransaction 포스트백에 연결 및 Postback Scope을 All로 설정합니다.

교차 기기 타겟팅을 위한 해시된 이메일

클라이언트는 가능한 경우 앱 사용자의 해시 이메일 주소를 크리테오에 보내 기기 간 타겟팅을 활성화해야 합니다. 다음은 이메일 주소의 해시를 생성하는 단계입니다.

  • 모든 문자를 소문자로 변환
  • 모든 공백 제거
  • UTF-8로 은폐
  • SHA256 알고리즘을 사용한 해시
디파이너리 정책상 사용자의 개인정보는 포스트백 이벤트로 전달이 불가합니다. 따라서 사용자의 해시-이메일 주소를 구성할 경우 아래 가이드를 참고하여 커스텀 이벤트로 구성 해야합니다. 커스텀 이벤트를 통한 해시드 메일 전송 구현 방법은 디파이너리 고객센터에 문의 바랍니다.

[참조] 디파이너리(애드브릭스) Android SDK 개발 문서

그 밖에 다른 이벤트 및 기능 설정이 필요할 경우 디파이너리(애드브릭스) Android SDK 개발 문서를 참조하세요. 디파이너리(애드브릭스) 연동하기[Android] Guide

대시보드 구성

앱찾기

  • IGAWorks : 디파이너리(애드브릭스)계정에 로그인하고 탐색 메뉴의 왼쪽 상단으로 이동한 다음 앱 이름 오른쪽에 있는 화살표를 클릭하여 앱을 선택합니다.

  • 검색 필드로 이동하여 앱 이름을 입력하고 아래 표시된 대로 해당 상자를 클릭 하십시오. 완료되면 페이지 하단에있는 저장 버튼을 클릭합니다.

Criteo 찾기 및 활성화

  • 탐색 메뉴의 왼쪽 상단에있는 Attributions > AD Partner Settings으로 이동합니다.

  • 통합 파트너 (네트워크) 목록이 AD Partner Settings 섹션 아래에 표시됩니다. 아래와 같이 검색 필드에 이름을 입력하여 Criteo 를 찾습니다: Legacy 연동시 Criteo를 선택하고, Formatting Layer 연동시 Criteo-New의 Actions 기어 이미지를 클릭하여 수정을 합니다.

  • 페이지 하단에 있는 활성 버튼을 클릭합니다.

  • 활성상태가 Criteo 로고 오른쪽에 나타납니다.

  • Is Enabled 필드에 Criteo-New ad partner가 활성 상태로 업데이트 된 것을 확인할 수 있습니다.

크리테오 포스트백 설정

IGAWorks : 디파이너리(애드브릭스)에서 이벤트 전달(포스트 백)을 성공적으로 활성화 : 디파이너리(애드브릭스)에서 Criteo로 다음 두 단계를 완료하면 완료됩니다.

  • Ad Partner Level에서 포스트 백 사용.
  • Ad Campaign Level에서 포스트 백 사용.

AD Partner Level

  • Ad Partner 구성 창은 AD Partner Informs, Postbacks 및 Ad Touch-Open Attribution의 세 가지 탭으로 구성됩니다. Postbacks 탭을 클릭합니다.

  • Postbacks탭은 App Open Postbacks 및 In App Event Postbacks 섹션으로 나뉩니다.

App Open Postbacks

  • Status 열로 이동하여 New Install, Re-Install 및 Deeplink Open 옵션을 ON으로 전환해야합니다.
  • Postback Scope 열로 이동하여 모든 속성 유형에 대해 All 를 선택합니다.

In-App Event Postbacks

  • Status 열로 이동하여 아래 표시된 것처럼 디파이너리(애드브릭스)가 Criteo로 보내길 원하는 모든 이벤트를 켜십시오. 참고 : abx : daily_first_open 및 Deeplink Open은 필수 이벤트이므로 둘 다 ON으로 전환해야 합니다.
  • Postback Scoped 열로 이동하여 선택한 모든 이벤트에 대해 All 를 선택합니다. 완료되면 페이지 하단에있는 저장 버튼을 클릭합니다.

AD Campaign Level

캠페인 만들기

  • 탐색 메뉴의 왼쪽 상단에있는 Attribution> AD Campaign으로 이동합니다.

  • 페이지 중앙에 있는 Create New Campaign 버튼을 클릭합니다.

  • 아래 그림과 같이 해당 필드에 캠페인 이름을 입력하십시오. 완료되면 페이지 하단에있는 확인 버튼을 클릭합니다.

Criteo에 캠페인 연결

  • AD Campaign 구성 창은 Dashbaord, TrackingLink, KPI Rule Setting, Postback Final Setting 및 Fraud Kill-Chain의 5 개 탭으로 구성됩니다. Tracking Link 탭을 클릭하고 아래로 스크롤하십시오.

  • 통합 파트너 (네트워크) 목록이 연결된 파트너 섹션 아래에 표시됩니다. 아래와 같이 검색 필드에 이름을 입력하여 Criteo를 찾습니다.

  • Criteo 로고를 클릭하여 구성 창을 엽니다.

  • Criteo 구성 창의 색인 섹션으로 이동하여 페이지 하단에있는 AD 캠페인과 연결 버튼을 클릭합니다.

크리테오 포스트백 활성화

  • 다음과 같이 동일한 페이지에 Postback Final Setting 탭을 클릭합니다.

  • 상태 열로 이동하여 아래 표시된 것처럼 디파이너리(애드브릭스)가 Criteo에 보내길 원하는 모든 이벤트를 켜십시오. 참고 : abx : daily_first_open 및 Deeplink Open은 필수 이벤트이므로 둘 다 ON으로 전환해야합니다. 완료되면 페이지 하단에있는 업데이트 버튼을 클릭 합니다.

  • App Open Postbacks

  • in-App Event Postbacks

  • 완료되면 탐색 메뉴의 왼쪽 상단에있는 Attributions > AD Campaign 으로 돌아갑니다.

  • 아래 예에 따라 새로 구성된 포스트 백 옆에 ON 상태가 있어야합니다.

설정확인

  • Criteo 계정 관리자에게 연락하여 이벤트 수신을 확인하고 최종 설정의 스크린 샷을 제공하십시오.

기여설정

  • Attribution > 광고 파트너 설정 > Criteo_New > Ad Touch-Open Attribution으로 이동합니다.
  • 디파이너리(애드브릭스)의 App Install campaign의 경우 영향을 미치는 두가지 lookback Window 설정이 있습니다:
    • Click to 여nstall Window : 7 days (기본값)
    • Impression to Install Window : 1 day (기본값)

트랙킹 링크

  • 트래킹 링크 생성은 Attribution > AD Campaign > Tracking Link로 이동하여 활성화 된 파트너를 클릭하면 우측에 트래킹 링크 생성 버튼이 나타납니다.

  • 발급 된 추적 링크의 기본 형식은 다음과 같습니다:

  • 기본 트랙킹링크는 appkey, linktype, tracker ID and tracking parameters로 구성되어 있습니다.

    • Appkey: 디파이너리(애드브릭스)를 이용하기 위해서는 반드시 앱을 생성해야 합니다. 생성된 앱에 대해서는 고유의 ID가 발급되어지는데, 이것을 디파이너리(애드브릭스) 앱키라고 부릅니다. 디파이너리(애드브릭스)는 앱키를 기준으로 데이터를 쌓고 분석합니다.
    • Link type: 디파이너리(애드브릭스)는 여러 타입의 트래킹링크를 제공합니다(impression, click, video, etc). 각 타입의 링크를 적절한 포맷의 광고를 트래킹하는데 사용할 수 있습니다.
    • Tracker ID: 광고성과분석을 하기 위해서는 반드시 트래킹링크를 생성해야 합니다(구글과 같은 일부 매체 제외). 발급된 링크는 고유한 ID를 가지는데, 이것을 “트래커 아이디”라고 부릅니다. 디파이너리(애드브릭스)는 “트래커 아이디”를 기준으로 광고 유입을 추적하고 여러 리포트를 구성할 수 있습니다.
    • Tracking parameters: 디파이너리(애드브릭스)는 세밀한 분석을 제공하기 위해 트래킹 파라미터를 추가할 수 있도록 지원하고 있습니다.

카탈로그 피드

카탈로그 피드는 크리테오가 상품 추천 배너를 동적으로 생성 할 때 필요한 상품 정보 (이름, 가격, 딥 링크, 이미지 링크 등)가 있는 XML 또는 CSV 파일입니다. 따라서, 배너에 올바른 데이터를 표시하기 위해서 최신 상태의 카탈로그 피드 파일이 중요합니다.

다음 사항을 고려합니다:

  • 각 상품은 이벤트에서 전달되는 상품과 동일한 고유한 ID를 가집니다.
  • 카탈로그 피드는 상품 전부 또는 대부분의 상품을 포함합니다.
  • 권장 이미지 해상도는 300x300 픽셀 ~ 400x400 픽셀입니다.
일부 캠페인의 경우 크리테오는 카탈로그 피드를 이미 보유하고 있습니다. (예 : 모바일, 웹 또는 데스크톱의 라이브 캠페인)

특별한 사항의 경우 카탈로그 사양를 확인하거나 담당자에게 상세 가이드를 요청합니다.

연동 확인

모든 이벤트가 구현되면 Criteo 담당자에게 문의하여 테스트 단계를 시작해야합니다.

전송중인 데이터가 완전한지 확인하기 위해 앱 제출 ** 전에 ** 테스트를 위해 충분한 시간 (최소 1 주일 전)을 허용하세요.

Criteo에는 다음 요소가 필요합니다:

  • Criteo 측에서 이벤트 수집을 테스트하기위한 앱 빌드.
  • 원격으로 테스트하는 경우 테스트 장치의 GAID입니다.
  • 딥 링크 예시 (홈페이지 및 상품 상세).
Copyright © 2017 Criteo. All rights reserved.