Entertainment : 엔터테인먼트

엔터테인먼트 앱에서 측정을 권장하는 인앱 이벤트 API와 적용 예시를 안내합니다.

☑️속성 중 Key 이름은 가이드에 나와있는 Key 이름을 그대로 사용 해 주세요. (임의로 변경시 대시보드에서 데이터 확인이 어렵습니다. > product_id , product_name 등)

트라이얼 완료

정식 구독이 아닌 트라이얼 구독이 완료되는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

trial_method

SKT 제휴

string

제휴 수단

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_trial_complete");
eventMap.put("trial_method", "SKT 제휴");
DOT.logEvent(eventMap);

구독 완료

구독이 완료되는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

transaction_id

SC87483

string

주문번호

currency

KRW

string

통화코드

subscription_method

신용카드

string

결제 수단 정보

product_id

FL828

string

상품코드

product_name

모바일 무제한 듣기 정기결제

string

상품명칭

quantity

1

integer

구독한 상품 개수

revenue

6900

double

유저가 결제한 금액

Map<String, Object> purchaseMap = new HashMap<>();
purchaseMap.put("transaction_id", "SC87483");
purchaseMap.put("currency", "KRW");
purchaseMap.put("subscription_method", "신용카드");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "FL828");
productMap.put("product_name", "모바일 무제한 듣기 정기결제");
productMap.put("quantity", 1);
productMap.put("revenue", 6900);
purchaseMap.put("product", productMap);
DOT.logPurchase(purchaseMap);

미디어 재생 시작 - 음악

음악이 재생되는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

artist_id

80049126

string

아티스트 고유번호

artist_name

아이유 (IU)

string

아티스트 명칭

media_id

30598121

string

음악 고유번호

media_name

밤편지

string

음악 명칭

album_id

20089092

string

앨범 고유번호

album_name

밤편지

string

앨범 명칭

genre_id

3772

string

장르 고유번호

genre

팝, 발라드

string

장르 명칭

duration

4.16

float

음악의 전체 길이를 분 단위로 입력

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_media_played");
eventMap.put("artist_id", "80049126");
eventMap.put("artist_name", "아이유 (IU)");
eventMap.put("media_id", "30598121");
eventMap.put("media_name", "밤편지");
eventMap.put("album_id", "20089092");
eventMap.put("album_name", "밤편지");
eventMap.put("genre_id", "3772");
eventMap.put("genre", "팝, 발라드");
eventMap.put("duration", 4.16);
DOT.logEvent(eventMap);

미디어 정지 - 영화

영화가 재생 중 일시정지된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

media_id

tt0120737

string

영화 고유번호

media_name

The Lord of the Rings: The Fellowship of the Ring

string

영화 명칭

actor_id

nm0000704

string

배우 고유번호

actor_name

Elijah Wood

string

배우 이름

director_id

nm0001392

string

감독 고유번호

director_name

Peter Jackson

string

감독 이름

genre_id

237

string

장르 고유번호

genre

adventure

string

장르 명칭

language

English

string

영화 언어 정보

duration

178

float

영화의 전체 길이를 분 단위로 입력

time_played

62.4

float

일시정지가 발생한 시점까지의 실제 시청시간

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_media_stopped");
eventMap.put("media_id", "tt0120737");
eventMap.put("media_name", "The Lord of the Rings: The Fellowship of the Ring");
eventMap.put("actor_id", "nm0000704");
eventMap.put("actor_name", "Elijah Wood");
eventMap.put("director_id", "nm0001392");
eventMap.put("director_name", "Peter Jackson");
eventMap.put("genre_id", "237");
eventMap.put("genre", "adventure");
eventMap.put("language", "English");
eventMap.put("duration", 178);
eventMap.put("time_played", 62.4);
DOT.logEvent(eventMap);

미디어 재생 완료 - TV시리즈

유저가 에피소드를 끝까지 시청한 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

serise_id

SR3829

string

시리즈 고유번호

serise_name

Game of Thrones: Season 2

string

시리즈 명칭

media_id

EP19823

string

에피소드 고유번호

media_name

04 Garden of Bones

string

에피소드 명칭

director_id

D392892

string

감독 고유번호

director_name

David Petrarca

string

감독 이름

genre_id

182

string

장르 고유번호

genre

action

string

장르 명칭

language

English

string

미디어 언어 정보

duration

51

float

미디어의 전체 길이를 분 단위로 입력

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_media_finished");
eventMap.put("serise_id", "SR3829");
eventMap.put("serise_name", "Game of Thrones: Season 2");
eventMap.put("media_id", "EP19823");
eventMap.put("media_name", "04 Garden of Bones");
eventMap.put("director_id", "D392892");
eventMap.put("director_name", "David Petrarca");
eventMap.put("genre_id", "182");
eventMap.put("genre", "action");
eventMap.put("language", "English");
eventMap.put("duration", 51);
DOT.logEvent(eventMap);

미디어 다운로드 - 음악

미디어 다운로드가 시작되는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

artist_id

80049126

string

아티스트 고유번호

artist_name

아이유 (IU)

string

아티스트 명칭

media_id

30598121

string

음악 고유번호

media_name

밤편지

string

음악 명칭

album_id

20089092

string

앨범 고유번호

album_name

밤편지

string

앨범 명칭

genre_id

3772

string

장르 고유번호

genre

팝, 발라드

string

장르 명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_media_downloaded");
eventMap.put("artist_id", "80049126");
eventMap.put("artist_name", "아이유 (IU)");
eventMap.put("media_id", "30598121");
eventMap.put("media_name", "밤편지");
eventMap.put("album_id", "20089092");
eventMap.put("album_name", "밤편지");
eventMap.put("genre_id", "3772");
eventMap.put("genre", "팝, 발라드");
DOT.logEvent(eventMap);

미디어 저장 - 영화

영화가 보관함 등에 저장되는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

media_id

tt0120737

string

영화 고유번호

media_name

The Lord of the Rings: The Fellowship of the Ring

string

영화 명칭

actor_id

nm0000704

string

배우 고유번호

actor_name

Elijah Wood

string

배우 이름

director_id

nm0001392

string

감독 고유번호

director_name

Peter Jackson

string

감독 이름

genre_id

237

string

장르 고유번호

genre

adventure

string

장르 명칭

language

English

string

영화 언어 정보

duration

178

float

영화의 전체 길이를 분 단위로 입력

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_media_saved");
eventMap.put("media_id", "tt0120737");
eventMap.put("media_name", "The Lord of the Rings: The Fellowship of the Ring");
eventMap.put("actor_id", "nm0000704");
eventMap.put("actor_name", "Elijah Wood");
eventMap.put("director_id", "nm0001392");
eventMap.put("director_name", "Peter Jackson");
eventMap.put("genre_id", "237");
eventMap.put("genre", "adventure");
eventMap.put("language", "English");
eventMap.put("duration", 178);
DOT.logEvent(eventMap);

좋아요 표시 - TV시리즈

유저가 에피소드에 대해서 '좋아요' 또는 호감을 표시한 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

serise_id

SR3829

string

시리즈 고유번호

serise_name

Game of Thrones: Season 2

string

시리즈 명칭

media_id

EP19823

string

에피소드 고유번호

media_name

04 Garden of Bones

string

에피소드 명칭

director_id

D392892

string

감독 고유번호

director_name

David Petrarca

string

감독 이름

genre_id

182

string

장르 고유번호

genre

action

string

장르 명칭

language

English

string

미디어 언어 정보

duration

51

float

미디어의 전체 길이를 분 단위로 입력

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_likes");
eventMap.put("serise_id", "SR3829");
eventMap.put("serise_name", "Game of Thrones: Season 2");
eventMap.put("media_id", "EP19823");
eventMap.put("media_name", "04 Garden of Bones");
eventMap.put("director_id", "D392892");
eventMap.put("director_name", "David Petrarca");
eventMap.put("genre_id", "182");
eventMap.put("genre", "action");
eventMap.put("language", "English");
eventMap.put("duration", 51);
DOT.logEvent(eventMap);

Last updated