Ocean Engine 데이터 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
이 문서에서는 Ocean Engine 데이터를 Agentic Engine(이하 AE 시스템)으로 콜백하는 방법을 소개합니다. 이 계획은 다음을 지원합니다:
- 올인원 데이터 리포트의 집계 지표 데이터를 가져옵니다. 여기에는 지출, 클릭, 노출 등 기본 리포트 지표가 포함되며, 광고 계정, 광고 그룹, 광고 캠페인, 소재 차원별로 그룹화됩니다
- 광고 크리에이티브 데이터의 집계 지표 데이터를 가져옵니다. 여기에는 지출, 클릭, 노출 등 기본 리포트 지표가 포함되며, 광고 계정, 광고 그룹, 광고 캠페인, 소재 차원별로 그룹화됩니다
- 광고 업그레이드 버전 데이터 리포트의 집계 지표 데이터, 즉 신버전 Ocean Engine Ads의 데이터 리포트를 가져옵니다. 여기에는 지출, 클릭, 노출 등 기본 리포트 지표가 포함되며, 광고 계정, 광고 그룹, 광고 캠페인, 소재 차원별로 그룹화됩니다
이 문서에서는 주로 하위 API를 통해 데이터를 AE 시스템에 연동하는 방법을 소개합니다. 제품 백엔드에서 설정하는 방법을 알아보려면 이 제품 문서를 참고하십시오.
Ocean Engine 데이터 연동을 시작하기 전에 AE 시스템의 데이터 규칙을 읽고 AE의 데이터 구조를 이해했는지 확인하십시오. 또한 데이터 수집에 필요한 정보를 저희 고객 성공 매니저에게 전달하는 것을 권장합니다. 형식은 데이터 연동 설정 정보 템플릿을 참고하십시오.
절차
Ocean Engine 데이터의 연동 절차는 다음과 같습니다:
- Ocean Engine 오픈 플랫폼에 로그인하여 개발자 계정과 앱을 생성하고, 앱의 APP_ID와 Secret, 로그인 사용자 ID를 ThinkingAI 담당자에게 전달합니다
- 앱 관리 페이지의 콜백 주소에 ThinkingAI 담당자가 제공한 주소를 입력합니다
- 인증 링크를 열고, 데이터를 수집할 광고 계정이 속한 Ocean Engine 계정으로 로그인하여 인증을 완료합니다
- 수집할 데이터 차원, 지표 타입, 수집 빈도 및 수집 기간을 확정합니다
- ThinkingAI 담당자가 데이터 수집 개발 작업을 완료합니다
- AE 백엔드에서 대시보드와 리포트를 구축하고 데이터 검증을 완료합니다
2. 통합 전 준비 작업
2.1 개발자 계정 및 앱 생성
Ocean Engine 데이터를 연동하기 전에 Ocean Engine 개발자 계정을 신청하고 앱을 하나 생성해야 합니다
- 먼저 Ocean Engine 계정에 로그인하거나 가입해야 합니다. 이 링크를 클릭하여 로그인/가입 페이지로 이동한 후, Ocean Engine 계정이 있다면 왼쪽 하단에서 로그인을 선택하여 해당 계정으로 로그인합니다. 계정이 없다면 이메일 또는 휴대폰 번호로 Ocean Engine 계정을 가입합니다
- 로그인을 마치면 Ocean Engine 오픈 플랫폼으로 이동합니다. 페이지 오른쪽 상단의 개발자 관리 백엔드 버튼을 클릭하여 개발자 백엔드로 들어갑니다
-
개발자 계정을 생성하지 않았다면 이때 개발자 정보 입력과 자격 심사를 완료해야 합니다. 하나의 회사 정보로는 개발자 계정을 하나만 등록·인증할 수 있으므로 반드시 회사 이메일로 신청하고 해당 계정을 안전하게 보관하십시오. 구체적인 신청 절차는 공식 문서를 참고하십시오.
- 개발자 유형은 광고주/대행사 중에서 실제 상황에 맞게 하나를 선택해야 합니다. 두 유형의 차이는 다음과 같습니다:
- 광고주: 개발자 계정과 동일한 회사 주체의 종횡 조직 계정 인증만 신청할 수 있습니다
- 대행사: 개발자 계정과 동일한 회사 주체의 대행사 계정 인증만 신청할 수 있습니다
- 개발자 계정 인증을 통과하면 개발자 공식 사이트의 APPID 관리 페이지로 이동하여 광고 관리 유형의 앱을 생성합니다
- 생성할 때 권한 범위에서 반드시 데이터 리포트 권한을 선택해야 합니다
- 신청을 제출하면 Ocean Engine이 영업일 기준 1일 이내에 앱 생성(APPID) 신청 심사를 완료합니다
2.2 App ID, App Secret 가져오기
앱 신청을 마친 후 개발자 백엔드로 이동하여 왼쪽 사이드바에서 앱 관리 - 기본 앱을 찾고, 생성한 앱을 선택한 후 편집을 클릭하여 기본 정보 페이지로 들어가 APP_ID와 Secret을 찾아 ThinkingAI 담당자에게 전달합니다.
2.3 로그인 사용자 ID 가져오기 및 인증 완료
다음으로 Ocean Engine 오픈 플랫폼에 접속하여 오른쪽 상단의 육각형 아이콘을 클릭하고, Ocean Engine Zongheng을 클릭하여 백엔드로 이동한 후 오른쪽 상단의 계정 정보 및 보안을 클릭하여 로그인 사용자 ID를 찾아 ThinkingAI 담당자에게 제공하십시오.
로그인 사용자 ID를 제공하면 ThinkingAI 담당자가 콜백 주소를 알려 드립니다. 앱 편집 페이지의 콜백 주소에 해당 주소를 입력하십시오.
입력을 마치면 페이지 하단에서 인증 URL을 확인할 수 있습니다. 이 URL을 복사하여 브라우저에서 엽니다.
인증 화면이 표시되면 현재 사용자의 전체 계정을 선택하고, 현재 로그인 사용자가 데이터를 수집할 광고 계정을 보유하고 있는지 확인합니다. 빨간색 상자 안의 로그인 사용자 ID가 앞서 ThinkingAI 담당자에게 제공한 로그인 사용자 ID인지 확인하십시오. 확인을 마치면 인증 동의를 클릭하여 인증 작업을 완료합니다.
3. 데이터 수집
Ocean Engine은 다양한 광고 데이터 리포트를 제공하며, 현재 AE는 올인원 데이터 리포트, 광고 크리에이티브 데이터 및 광고 업그레이드 버전 데이터 리포트 수집을 지원합니다.
3.1 올인원 데이터 리포트
인터페이스 기본 정보
| 인터페이스명 | API 타입 | 제품화 | 데이터 세분화 | 어트리뷰션 데이터 | 비용 데이터 | 수익 데이터 | 노출 데이터 | 클릭 데이터 | 전환 데이터 |
|---|---|---|---|---|---|---|---|---|---|
| 올인원 데이터 리포트 인터페이스 | 풀 방식 | 예 | 집계 데이터 | 예 | 예 | 예 | 예 |
올인원 데이터 리포트는 각 광고 세분화 수준, 소재, 키워드 계층의 데이터를 수집할 수 있어 분석 차원이 가장 풍부하지만, 지원하는 지표는 일반 데이터 리포트보다 적습니다. 전반적으로 가장 많이 사용하는 데이터 리포트입니다.
3.1.1 분석 차원
아래 표는 올인원 데이터 리포트에서 지원하는 분석 차원이며, 기본 그룹 조건은 다음과 같습니다:
- STAT_GROUP_BY_TIME_HOUR
- STAT_GROUP_BY_CREATIVE_ID
조정이 필요한 경우 먼저 그룹 조합 규칙을 확인한 후 조정할 내용을 데이터 연동 설정 정보 템플릿에 기록하십시오:
| 필드 이름 | 의미 | 그룹 조건 | 기본 여부 |
|---|---|---|---|
| stat_datetime | 시간 | STAT_GROUP_BY_TIME_MONTH STAT_GROUP_BY_TIME_WEEK STAT_GROUP_BY_TIME_DAY STAT_GROUP_BY_TIME_HOUR | 예 |
advertiser_id | 광고주 ID | STAT_GROUP_BY_ADVERTISER_ID STAT_GROUP_BY_CAMPAIGN_ID STAT_GROUP_BY_AD_ID STAT_GROUP_BY_CREATIVE_ID | 예 |
| campaign_name | 광고 그룹 이름 | STAT_GROUP_BY_CAMPAIGN_ID STAT_GROUP_BY_AD_ID STAT_GROUP_BY_CREATIVE_ID | 예 |
| campaign_id | 광고 그룹 ID | 예 | |
| ad_name | 캠페인 이름 | STAT_GROUP_BY_AD_ID STAT_GROUP_BY_CREATIVE_ID | 예 |
| ad_id | 캠페인 ID | 예 | |
| creative_id | 크리에이티브 ID | STAT_GROUP_BY_CREATIVE_ID | 예 |
| bidword | 키워드 이름 | STAT_GROUP_BY_BIDWORD_ID | |
| bidword_id | 키워드 ID | ||
| query | 검색어 | STAT_GROUP_BY_QUERY | |
| pricing | 입찰 방식 | STAT_GROUP_BY_PRICING | |
| image_mode | 소재 유형 | STAT_GROUP_BY_IMAGE_MODE | |
| inventory | 광고 우선 게재 위치 | STAT_GROUP_BY_INVENTORY | |
| campaign_type | 광고 그룹 유형 | STAT_GROUP_BY_CAMPAIGN_TYPE | |
| creative_material_mode | 크리에이티브 유형 | STAT_GROUP_BY_CREATIVE_MATERIAL_MODE | |
| external_action | 전환 유형 | STAT_GROUP_BY_EXTERNAL_ACTION | |
| landing_type | 프로모션 유형 | STAT_GROUP_BY_LANDING_TYPE | |
| pricing_category | 광고 유형 | STAT_GROUP_BY_PRICING_CATEGORY | |
| province_name | 성(Province) | STAT_GROUP_BY_PROVINCE_NAME | |
| city_name | 도시 | STAT_GROUP_BY_CITY_NAME 및 STAT_GROUP_BY_PROVINCE_NAME 모두 포함 | |
| gender | 성별 | STAT_GROUP_BY_GENDER | |
| age | 나이 | STAT_GROUP_BY_AGE | |
| platform | 플랫폼 | STAT_GROUP_BY_PLATFORM | |
| ac | 네트워크 타입 | STAT_GROUP_BY_AC | |
| material_id | 소재 ID | STAT_GROUP_BY_MATERIAL_ID | |
| playable_id | 플레이어블 소재 ID | STAT_GROUP_BY_PLAYABLE_ID | |
| playable_name | 플레이어블 소재 이름 | ||
| playable_url | 플레이어블 소재 링크 | ||
| playable_orientation | 플레이어블 소재 표시 방향 | ||
| playable_preview_url | 플레이어블 소재 미리보기 링크 |
3.1.2 포함 지표
아래 표는 올인원 데이터 리포트에서 지원하는 자주 사용하는 일부 지표입니다. 전체 지표가 너무 많아 여기에 모두 표시할 수 없으며, 필요한 경우 공식 문서에서 전체 지표 설명을 확인할 수 있습니다:
| 지표명 | 한국어 이름 | 기본 여부 |
|---|---|---|
| active | 활성화 수 | 예 |
| active_cost | 활성화 비용 | 예 |
| active_pay_cost | 첫 결제 비용 | 예 |
| active_pay_rate | 첫 결제율 | 예 |
| active_rate | 활성화율 | 예 |
| active_register_cost | 가입 비용 | 예 |
| active_register_rate | 가입률 | 예 |
| attribution_active_pay_7d_per_count | 7일 인당 평균 결제 횟수 | 예 |
| attribution_convert | 전환 수(과금 시간 기준) | 예 |
| attribution_convert_cost | 전환 비용(과금 시간 기준) | 예 |
| attribution_deep_convert | 심층 전환 수(과금 시간 기준) | 예 |
| attribution_deep_convert_cost | 심층 전환 비용(과금 시간 기준) | 예 |
| attribution_game_pay_7d_cost | 7일 결제 비용 | |
| attribution_game_pay_7d_count | 7일 결제 횟수 | |
| attribution_next_day_open_cnt | 익일 리텐션 수 | |
| attribution_next_day_open_cost | 익일 리텐션 비용 | |
| attribution_next_day_open_rate | 익일 리텐션율 | |
| avg_click_cost | 평균 클릭 단가 | 예 |
| avg_show_cost | 1,000회 노출당 평균 비용 | 예 |
| click | 클릭 수 | 예 |
| click_install | 클릭 설치 수 | 예 |
| convert | 전환 수 | 예 |
| convert_cost | 전환 비용 | 예 |
| convert_rate | 전환 데이터-전환율 | 예 |
| cost | 총 지출 | 예 |
| ctr | 클릭률 | 예 |
| deep_convert | 심층 전환 수 | 예 |
| deep_convert_cost | 심층 전환 비용 | 예 |
| deep_convert_rate | 심층 전환율 | 예 |
| download | 다운로드 시작 | 예 |
| game_addiction | 핵심 행동 수 | 예 |
| game_addiction_cost | 핵심 행동 비용 | 예 |
| game_addiction_rate | 핵심 행동률 | 예 |
| game_pay_cost | 결제 비용 | 예 |
| game_pay_count | 결제 횟수 | 예 |
| next_day_open | 익일 리텐션 콜백 수(미매칭) | |
| next_day_open_cost | 익일 리텐션 비용(미매칭) | |
| next_day_open_rate | 익일 리텐션율(미매칭) | |
| pay_count | 첫 결제 횟수 | 예 |
| play_100_feed_break | 99% 진행 재생 수 | |
| play_25_feed_break | 25% 진행 재생 수 | |
| play_50_feed_break | 50% 진행 재생 수 | |
| play_75_feed_break | 75% 진행 재생 수 | |
| play_duration_sum | 재생 시간, 단위 ms | |
| total_play | 재생 수 | |
| valid_play | 유효 재생 수 | |
| valid_play_cost | 유효 재생 비용 | |
| valid_play_rate | 유효 재생률 | |
| play_over_rate | 재생 완료율 | |
| redirect | 페이지 이동 | |
| register | 가입 수 | |
| share | 공유 수 | |
| show | 노출 수 | 예 |
| wifi_play | WiFi 재생 수 | |
| wifi_play_rate | WiFi 재생 비율 |
3.1.3 인터페이스 파라미터
-
광고 계정:
- 데이터를 수집할 광고 계정을 지정해야 합니다
-
시간:
-
일 단위로 데이터를 수집합니다
- 검색어 리포트는 최근 30일의 데이터만 조회할 수 있습니다
- 키워드 리포트는 2019-05-19 이후의 데이터만 조회할 수 있습니다
- 모든 리포트에서 기간은 30일을 초과할 수 없습니다
-
데이터는 일별 또는 시간별로 집계할 수 있으며, 기본값은 시간별입니다
-
3.1.4 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
- 올인원 리포트가 반환하는 데이터는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
- 데이터의 stat_datetime 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
- 데이터 이벤트 이름은 oceanengine_show_click_convert_data입니다
- 나머지 필드는 모두 저장됩니다
3.2 광고 크리에이티브 데이터
광고 크리에이티브 데이터는 광고 데이터 세분화 수준이 가장 세밀한 일반 데이터 리포트로, 올인원 데이터 리포트에 비해 분석 차원은 적지만 지원하는 지표는 더 많습니다.
인터페이스 기본 정보
| 인터페이스명 | API 타입 | 제품화 | 데이터 세분화 | 어트리뷰션 데이터 | 비용 데이터 | 수익 데이터 | 노출 데이터 | 클릭 데이터 | 전환 데이터 |
|---|---|---|---|---|---|---|---|---|---|
| 광고 크리에이티브 데이터 | 풀 방식 | 아니요 | 집계 데이터 | 예 | 예 | 예 | 예 |
3.2.1 분석 차원
아래 표는 광고 크리에이티브 데이터 리포트에서 지원하는 분석 차원이며, 기본 그룹 조건은 다음과 같습니다:
- STAT_GROUP_BY_FIELD_STAT_TIME
- STAT_GROUP_BY_FIELD_ID
이 밖에도 다른 그룹 조건을 최대 1개 추가할 수 있으며(예: 아래 표의 STAT_GROUP_BY_INVENTORY), 추가하지 않고 기본 그룹 조건을 사용할 수도 있습니다
조정이 필요한 경우 조정할 내용을 데이터 연동 설정 정보 템플릿에 기록하십시오:
| 필드 이름 | 의미 | 그룹 조건 | 기본 여부 |
|---|---|---|---|
| stat_datetime | 데이터 시작 시간. 형식:
| STAT_GROUP_BY_FIELD_STAT_TIME | 예 |
| advertiser_id | 광고주 ID | STAT_GROUP_BY_FIELD_ID | 예 |
| campaign_name | 광고 그룹 이름 | 예 | |
| campaign_id | 광고 그룹 ID | 예 | |
| ad_name | 캠페인 이름 | 예 | |
| ad_id | 캠페인 ID | 예 | |
| creative_id | 크리에이티브 ID | 예 | |
| inventory | 집행 광고 위치 | STAT_GROUP_BY_INVENTORY | |
| creative_material_mode | 크리에이티브 유형. 값:
| STAT_GROUP_BY_CREATIVE_MATERIAL_MODE | |
| landing_type | 프로모션 목적 유형 | STAT_GROUP_BY_LANDING_TYPE | |
| pricing | 입찰 유형 | STAT_GROUP_BY_PRICING | |
| image_mode | 소재 유형 | STAT_GROUP_BY_IMAGE_MODE | |
| province_name | 성(Province) | STAT_GROUP_BY_PROVINCE_NAME | |
| city_name | 도시 | STAT_GROUP_BY_CITY_NAME | |
| gender | 성별 | STAT_GROUP_BY_GENDER | |
| age | 나이 | STAT_GROUP_BY_AGE | |
| platform | 플랫폼 | STAT_GROUP_BY_PLATFORM | |
| ac | 타입 | STAT_GROUP_BY_AC |
3.2.2 포함 지표
아래 표는 광고 크리에이티브 데이터 리포트에서 지원하는 자주 사용하는 일부 지표입니다. 전체 지표가 너무 많아 여기에 모두 표시할 수 없으며, 필요한 경우 공식 사이트 문서에서 전체 지표 설명을 확인할 수 있습니다:
| 지표명 | 한국어 이름 | 기본 여부 |
|---|---|---|
| active | 활성화 수 | 예 |
| active_cost | 활성화 비용 | 예 |
| active_pay_cost | 첫 결제 비용 | 예 |
| active_pay_rate | 첫 결제율 | 예 |
| active_rate | 활성화율 | 예 |
| active_register_cost | 가입 비용 | 예 |
| active_register_rate | 가입률 | 예 |
| attribution_active_pay_7d_per_count | 7일 인당 평균 결제 횟수 | 예 |
| attribution_convert | 전환 수(과금 시간 기준) | 예 |
| attribution_convert_cost | 전환 비용(과금 시간 기준) | 예 |
| attribution_deep_convert | 심층 전환 수(과금 시간 기준) | 예 |
| attribution_deep_convert_cost | 심층 전환 비용(과금 시간 기준) | 예 |
| attribution_game_pay_7d_cost | 7일 결제 비용 | |
| attribution_game_pay_7d_count | 7일 결제 횟수 | |
| attribution_next_day_open_cnt | 익일 리텐션 수 | |
| attribution_next_day_open_cost | 익일 리텐션 비용 | |
| attribution_next_day_open_rate | 익일 리텐션율 | |
| avg_click_cost | 평균 클릭 단가 | 예 |
| avg_show_cost | 1,000회 노출당 평균 비용 | 예 |
| click | 클릭 수 | 예 |
| click_install | 클릭 설치 수 | 예 |
| convert | 전환 수 | 예 |
| convert_cost | 전환 비용 | 예 |
| convert_rate | 전환 데이터-전환율 | 예 |
| cost | 총 지출 | 예 |
| ctr | 클릭률 | 예 |
| deep_convert | 심층 전환 수 | 예 |
| deep_convert_cost | 심층 전환 비용 | 예 |
| deep_convert_rate | 심층 전환율 | 예 |
| download | 다운로드 시작 | 예 |
| game_addiction | 핵심 행동 수 | 예 |
| game_addiction_cost | 핵심 행동 비용 | 예 |
| game_addiction_rate | 핵심 행동률 | 예 |
| game_pay_cost | 결제 비용 | 예 |
| game_pay_count | 결제 횟수 | 예 |
| next_day_open | 익일 리텐션 콜백 수(미매칭) | |
| next_day_open_cost | 익일 리텐션 비용(미매칭) | |
| next_day_open_rate | 익일 리텐션율(미매칭) | |
| pay_count | 첫 결제 횟수 | 예 |
| play_100_feed_break | 99% 진행 재생 수 | |
| play_25_feed_break | 25% 진행 재생 수 | |
| play_50_feed_break | 50% 진행 재생 수 | |
| play_75_feed_break | 75% 진행 재생 수 | |
| play_duration_sum | 재생 시간, 단위 ms | |
| total_play | 재생 수 | |
| valid_play | 유효 재생 수 | |
| valid_play_cost | 유효 재생 비용 | |
| valid_play_rate | 유효 재생률 | |
| play_over_rate | 재생 완료율 | |
| redirect | 페이지 이동 | |
| register | 가입 수 | |
| share | 공유 수 | |
| show | 노출 수 | 예 |
| wifi_play | WiFi 재생 수 | |
| wifi_play_rate | WiFi 재생 비율 |
3.2.3 인터페이스 파라미터
- 광고 계정:
- 데이터를 수집할 광고 계정을 지정해야 합니다
- 시간:
- 일 단위로 데이터를 수집합니다
- 기간은 30일을 초과할 수 없습니다
- 일 단위로 데이터를 수집합니다
3.2.4 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
- 광고 크리에이티브 리포트가 반환하는 데이터는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
- 데이터의 stat_datetime 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
- 데이터 이벤트 이름은 -- oceanengine_creative_data입니다
- 나머지 필드는 모두 저장됩니다
3.3 광고 업그레이드 버전 데이터 리포트
인터페이스 기본 정보
| 인터페이스명 | API 타입 | 제품화 | 데이터 세분화 | 어트리뷰션 데이터 | 비용 데이터 | 수익 데이터 | 노출 데이터 | 클릭 데이터 | 전환 데이터 |
|---|---|---|---|---|---|---|---|---|---|
| 광고 업그레이드 버전 데이터 리포트 | 풀 방식 | 아니요 | 집계 데이터 | 예 | 예 | 예 | 예 |
광고 업그레이드 버전 데이터 리포트는 Ocean Engine에 새로 추가된 광고 데이터 리포트로, Ocean Engine Ads 업그레이드 버전의 광고 집행 데이터를 수집할 수 있습니다.
3.3.1 분석 차원
아래는 광고 업그레이드 버전 데이터 리포트에서 지원하는 차원이며, 일 단위 리포트와 시간 단위 리포트 중에서 선택할 수 있습니다. 시간 단위 리포트는 일부 차원과 상호 배타적입니다
| 항목 | 필드 이름 | 일 단위 기본값 | 시간 단위 기본값 | 표준화 필드 | 비고 |
|---|---|---|---|---|---|
| 광고 계정 ID | - | 예 | 예 | ad_account_id | |
시간 | stat_time_day(일 단위) stat_time_hour(시간 단위) | 예 | 예 | 시간 단위 리포트에서는 다음 차원을 사용할 수 없음
| |
| 프로젝트 ID | cdp_project_id | 예 | 예 | ad_group_id | |
| 프로젝트 이름 | cdp_project_name | 예 | 예 | ad_group_name | |
| 광고 ID | cdp_promotion_id | 예 | 예 | ad_id | |
| 광고 이름 | cdp_promotion_name | 예 | 예 | ad_name | |
| 패키지 이름 | package_name | 예 | 예 | app_name | |
| 플랫폼 | platform | 예 | platform | 다음 차원과 상호 배타적
시간 단위 리포트에서 사용 불가 | |
| 성별 | gender | ||||
| 나이 | age | ||||
| 네트워크 | ac | ||||
| 성(Province) | province_name | 다음 차원과 상호 배타적
시간 단위 리포트에서 사용 불가 | |||
| 도시 | city_name | ||||
| 소재 유형 | image_mode | ||||
| 프로모션 목적 | landing_type | ||||
| 전환 목표 | external_action | ||||
| 과금 유형 | pricing | ||||
| 심층 전환 목표 | deep_external_action | ||||
| 다운로드 방식 | ad_platform_cdp_project_download_type | ||||
| 다운로드 링크 | ad_platform_cdp_project_download_url | ||||
| 전환 모니터링 주소 | ad_platform_cdp_project_action_track_url | ||||
| 광고 집행 모드 | delivery_mode | ||||
| 광고 입찰가 | ad_platform_cdp_promotion_bid | ||||
| 심층 전환 입찰가 | ad_platform_cdp_promotion_deep_cpa_bid | ||||
| ROI 계수 | ad_platform_cdp_promotion_roi_goal | ||||
| 우선 게재 위치 | app_code |
3.3.2 포함 지표
아래 표는 광고 업그레이드 버전 데이터 리포트에서 지원하는 자주 사용하는 일부 지표입니다. 전체 지표가 너무 많아 여기에 모두 표시할 수 없습니다
| 지표 | 지표명 | 설명 | 기본값 | 표준화 필드 | 비고 |
|---|---|---|---|---|---|
| 지출 | stat_cost | 광고 게재 기간 동안의 예상 지출 금액입니다. 당일 데이터는 변동될 수 있으며, 다음 날 안정됩니다 | 예 | cost | |
| 노출 수 | show_cnt | 광고가 유저에게 노출된 횟수입니다. 계산 방식: 플랫폼이 유효하다고 판정하여 과금한 노출 횟수. | 예 | impressions | |
| 1,000회 노출당 평균 비용 | cpm_platform | 광고 노출 1,000회당 평균 지출 비용입니다. 계산 공식: 총 지출/노출 수*1000. | 예 | ||
| 클릭 수 | click_cnt | 유저가 광고 소재를 클릭하면 클릭 이벤트가 트리거되며, 이 이벤트는 유효한 광고 클릭 1회로 간주됩니다. | 예 | clicks | |
| 클릭률 | ctr | 광고 클릭 수가 노출 수에서 차지하는 백분율입니다. 계산 방법: 클릭 수/노출 수*100% | 예 | ||
| 평균 클릭 단가 | cpc_platform | 광고주가 클릭 1회당 지불하는 비용입니다. 계산 공식: 총 지출/클릭 수. | 예 | ||
| 전환 수 | convert_cnt | 전환 이벤트 발생 시간 기준으로 집계한 전환 수입니다. 광고주가 비용을 평가할 때는 전환 데이터(과금 시간 기준) 지표를 참고하는 것을 권장합니다. 예를 들어 광고가 오전 8시에 노출 및 클릭되고 유저의 활성화가 저녁 19시에 발생했다면 Ocean Engine은 활성화 수를 저녁 19시에 집계합니다. | 예 | installs | |
| 평균 전환 비용 | conversion_cost | 광고주가 전환 1건당 지불하는 평균 비용입니다. 계산 방식: 총 지출/전환 수. 당일 데이터는 변동될 수 있습니다. | 예 | ||
| 전환율 | conversion_rate | 광고 전환 수가 클릭 수에서 차지하는 백분율입니다. 계산 방식: 전환 수/클릭 수*100% | 예 | ||
| 심층 전환 수 | deep_convert_cnt | 심층 전환 수를 전환 이벤트가 발생한 시간에 기록합니다. 광고주가 심층 전환 비용을 평가할 때는 심층 전환 수(과금 시간 기준) 지표를 참고하는 것을 권장합니다. 예를 들어 광고가 오전 8시에 노출 및 클릭되고 유저의 활성화가 저녁 19시에 발생했다면 Ocean Engine은 활성화 수를 저녁 19시에 집계합니다. | |||
| 심층 전환 비용 | deep_convert_cost | 광고주가 심층 전환 1건당 지불하는 평균 비용입니다. 계산 방법: 총 지출/심층 전환 수. 당일 데이터는 변동될 수 있으며, 다음 날 오전 8시 이후 안정됩니다. | |||
| 심층 전환율 | deep_convert_rate | 광고 심층 전환 수가 전환 수에서 차지하는 백분율입니다. 계산 방식: 심층 전환 수/전환 수*100% | |||
| 활성화 수 | active | API를 연동한 경우 활성화 수는 광고주가 인정하고 콜백에 성공한 활성화 수입니다. SDK를 연동한 경우 활성화 수는 유저가 앱을 다운로드한 후 실행한 횟수입니다. | 예 | ||
| 활성화 비용 | active_cost | 계산 방식: 총 지출/활성화 수. | 예 | ||
| 활성화율 | active_rate | 계산 방식: 활성화 수/클릭 수*100% | 예 | ||
| 가입 수 | active_register | API를 연동한 경우 가입 수는 광고주가 인정하고 콜백에 성공한 가입 수입니다. SDK를 연동한 경우 가입 수는 유저가 가입 행동을 한 횟수이며, 자세한 내용은 SDK 연동 문서를 참고하십시오 | 예 | ||
| 가입 비용 | active_register_cost | 광고주가 가입 1건당 지불하는 비용입니다. 계산 공식: 총 지출/가입 수. 당일 데이터는 변동될 수 있으며, 다음 날 오전 8시 이후 안정됩니다. | 예 | ||
| 가입률 | active_register_rate | 가입 유저가 활성화 유저에서 차지하는 비율 | 예 | ||
| 핵심 행동 수 | game_addiction | 앱 내 핵심 행동을 한 유저 수 | |||
| 핵심 행동 비용 | game_addiction_cost | 광고주가 앱 내 핵심 행동을 한 유저 1명당 지불하는 비용입니다. 계산 공식: 총 지출/핵심 행동 수. 당일 데이터는 변동될 수 있으며, 다음 날 오전 8시 이후 안정됩니다. | |||
| 핵심 행동률 | game_addiction_rate | 핵심 행동 유저가 활성화 유저에서 차지하는 비율 | |||
| 재생 수 | total_play | 재생 시간이 0S보다 긴 횟수입니다. 일부 셀룰러 네트워크 환경에서는 유저가 직접 시작을 클릭해야 재생되므로 재생 수가 노출 수보다 적을 수 있습니다. | 예 | ||
| 유효 재생 수 | valid_play | 입찰 광고는 재생 시간이 10초 이상인 횟수이며, 동영상 총 길이가 10초 미만이면 재생 완료 횟수를 기록합니다. 브랜드 광고는 일부 앱(Toutiao, Toutiao Lite, Douyin, Xigua, Douyin Huoshan, Pipixia)에서 재생 시간이 5초 이상인 횟수, 그 밖의 앱에서 3초 이상인 횟수이며, 동영상 총 길이가 5초/3초 미만이면 재생 완료 횟수를 기록합니다. | 예 | ||
| 유효 재생 비용 | valid_play_cost | 계산 공식: 총 지출/유효 재생 수. 당일 데이터는 변동될 수 있으며, 다음 날 오전 8시 이후 안정됩니다. | 예 | ||
| 유효 재생률 | valid_play_rate | 계산 공식: 유효 재생 수/노출 수. | 예 | ||
| 1,000회 유효 재생 수 | valid_play_of_mille | 유효 재생 수/1000. 여기서 유효 재생 수는 입찰 광고의 경우 재생 시간이 10초 이상인 횟수이며, 동영상 총 길이가 10초 미만이면 재생 완료 횟수를 기록합니다. 브랜드 광고의 경우 일부 앱(Toutiao, Toutiao Lite, Douyin, Xigua, Douyin Huoshan, Pipixia)에서 재생 시간이 5s 이상인 횟수, 그 밖의 앱에서 3s 이상인 횟수이며, 동영상 총 길이가 5s/3s 미만이면 재생 완료 횟수를 기록합니다. | 예 | ||
| 1,000회 유효 재생 비용 | valid_play_cost_of_mille | 총 지출/천 회 유효 재생 수. 당일 데이터는 변동될 수 있으며, 다음 날 오전 8시 이후 안정됩니다. | 예 | ||
| 25% 진행 재생 수 | play_25_feed_break | 유저가 동영상 길이의 25% 이상까지 재생한 횟수이며, 해당 지점으로 건너뛰어 재생한 횟수도 포함됩니다 | 호환되지 않는 차원:
| ||
| 50% 진행 재생 수 | play_50_feed_break | 유저가 동영상 길이의 50% 이상까지 재생한 횟수이며, 해당 지점으로 건너뛰어 재생한 횟수도 포함됩니다 | |||
| 75% 진행 재생 수 | play_75_feed_break | 유저가 동영상 길이의 75% 이상까지 재생한 횟수이며, 해당 지점으로 건너뛰어 재생한 횟수도 포함됩니다 | |||
| 99% 진행 재생 수 | play_99_feed_break | 유저가 동영상 길이의 99% 이상까지 재생한 횟수이며, 해당 지점으로 건너뛰어 재생한 횟수도 포함됩니다 | |||
| 평균 1회 재생 시간 | average_play_time_per_play | 계산 방법: 동영상 총 실제 재생 시간/총 재생 횟수(건너뛴 시간 제외) | |||
| 재생 완료율 | play_over_rate | 계산 공식: 재생 완료 수/재생 수. | |||
| WiFi 재생 비율 | wifi_play_rate | WiFi 환경에서의 동영상 재생 수/동영상 총 재생 수 | |||
| 3초 카드 노출 수 | card_show | 동영상 카드형 광고에서 동영상이 3초까지 재생되었을 때 카드가 노출된 횟수. | |||
| 3초 재생 수 | play_duration_3s | 광고 재생 시간이 3초 이상인 횟수이며, 동영상 총 길이가 3초 미만이면 재생 완료 횟수를 기록합니다. |
3.3.3 인터페이스 파라미터
- 광고 계정:
- 데이터를 수집할 광고 계정을 지정해야 합니다
- 시간:
- 일 단위 리포트 또는 시간 단위 리포트를 선택할 수 있습니다
3.3.4 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
- 광고 업그레이드 버전 데이터 리포트가 반환하는 데이터는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
- 데이터의 dimensions_stat_time_hour 또는 dimensions_stat_time_day 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
- 데이터 이벤트 이름은 oceanengine_custom_data입니다
- 나머지 필드는 모두 저장됩니다
4. 데이터 연동 설정 정보 템플릿
위 문서를 읽은 후 다음 정보 템플릿을 작성하여 ThinkingAI의 고객 성공 매니저에게 보내는 것을 권장합니다:
인터페이스: Ocean Engine 광고 데이터 리포트
---------
회사 이름: XXX
AE 프로젝트 환경: (SAAS/프라이빗 배포)
AE 프로젝트 이름: XXX
AE 프로젝트 APP ID: XXX
데이터 수신 주소 push_url: XXX
---------
Ocean Engine 앱 APP_ID: XXX
Ocean Engine 앱 Secret: XXX
광고주(광고 계정) ID 목록: XXX, XXX
로그인 사용자 ID: XXXXXXXXX
---------
수집할 데이터 타입: [올인원/광고 크리에이티브/업그레이드 버전 데이터 리포트]
분석 차원: XXX, XXX(입력하지 않으면 기본값)
수집할 필드: XXX, XXX(입력하지 않으면 기본값)
과거 데이터 수집 기간: yyyy/mm/dd - yyyy/mm/dd
수집 단위: 일 단위(업그레이드 버전 데이터 리포트만 시간 단위 지원)
정기 수집: 매일 X시에 지난 N일의 데이터 수집(매시간 N일의 데이터 수집)
5. 연동 테스트
AE 시스템 백엔드의 데이터 관리 -> 이벤트 관리 페이지 또는 SQL IDE 페이지에서 다음 이벤트를 검색합니다
- oceanengine_show_click_convert_data
또는
- oceanengine_creative_data
또는
- oceanengine_custom_data
그런 다음 해당 이벤트에 데이터가 저장되었는지 확인합니다
6. FAQ
같은 게임을 여러 Ocean Engine 주체에서 게재해도 데이터를 수집할 수 있나요?
가능합니다. 하나의 AE 프로젝트에 여러 Ocean Engine Token을 연결할 수 있어, 서로 다른 Ocean Engine 사용자의 광고 집행 데이터를 같은 AE 프로젝트로 모을 수 있습니다. 모든 Ocean Engine 주체의 데이터를 수집하려면 각 Ocean Engine 사용자에 대해 인증을 진행하고, AE 플랫폼의 Ocean Engine 서드파티 통합 설정에서 통합 계획을 여러 개 추가해야 합니다.
Ocean Engine 백엔드에서 앱을 새로 만들 때 앱 신청서의 콜백 주소에는 무엇을 입력하나요?
앱을 새로 만들 때 콜백 주소에는 우선 회사 도메인을 입력해도 됩니다. 앱을 추가한 후 콜백 주소를 AE 클러스터의 Ocean Engine 콜백 주소로 다시 변경할 수 있습니다.
Ocean Engine 백엔드에서 로그인 사용자 ID를 찾을 수 없나요?
다음 두 가지 방법으로 Ocean Engine 백엔드에서 로그인 사용자 ID를 확인할 수 있습니다.
- 방법 1: Ocean Engine 오픈 플랫폼 - 오른쪽 상단의 육각형 아이콘을 클릭하고 Ocean Engine Zongheng을 클릭한 후 - 오른쪽 상단의 계정 정보 및 보안을 클릭하여 로그인 사용자 ID를 찾습니다.
- 방법 2: Ocean Engine 오픈 플랫폼 - 개발자 관리 백엔드 - 앱 관리 - 앱 편집에서 AE 시스템 콜백 주소를 입력하고 데이터 리포트 권한 범위를 선택한 후 - 인증 URL을 클릭하고 - 현재 사용자의 전체 계정을 선택하면 로그인 사용자 ID를 확인할 수 있습니다.
로그인 사용자별 광고주 ID/광고 계정 ID는 어떻게 가져오나요?
Ocean Engine 오픈 플랫폼 - 오른쪽 상단의 육각형 아이콘을 클릭하고 Ocean Engine Ads 플랫폼을 클릭하면 해당 로그인 사용자의 광고 계정 ID가 표시됩니다. (계정 ID가 없으면 커스텀 열을 클릭하여 계정 ID를 추가할 수 있습니다)
advertiser_id를 입력했는데 왜 데이터가 수집되지 않나요?
입력한 ID가 종횡 조직의 광고 계정 ID일 수 있습니다. 종횡 조직 아래에서 광고를 집행하는 광고 계정 ID를 입력해야 하며, 다음 방법으로 가져올 수 있습니다:
curl --location --request GET 'https://ad.oceanengine.com/open_api/2/majordomo/advertiser/select/?advertiser_id={종횡 조직 광고 계정 ID}' \
--header 'Access-Token:{ACCESS_TOKEN}' \
--header 'Content-Type:application/x-www-form-urlencoded' \
--data-urlencode 'advertiser_id={종횡 조직 광고 계정 ID}'
같은 종횡 조직에서 로그인 사용자별 광고주 ID 목록은 어떻게 가져오나요?
- Ocean Engine Zongheng 페이지 오른쪽에서 종횡 조직 ID를 확인합니다
- 종횡 조직의 자산 계정 목록 가져오기 인터페이스를 사용하면 같은 종횡 조직에서 로그인 사용자별 광고주 ID 목록을 가져올 수 있습니다