Moloco Log API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
Moloco Log API는 지원이 중단되었습니다(AE 백엔드 표시 이름: Log API(지원 중단)). Moloco Report API로 전환할 것을 권장합니다.
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Log API | API | 유저 데이터 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Log API는 유저 단위의 원본 데이터로, 매우 풍부한 유저 데이터를 제공합니다.
통합 절차
- Moloco 계정에 로그인하여 Workplace ID를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Moloco Log API 계획을 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 인증 정보 가져오기
1.1 Workplace ID 가져오기
API를 호출하기 전에 먼저 Workplace ID를 가져와야 합니다. Moloco 계정에 로그인한 후 화면 왼쪽 사이드바에서 Settings 버튼을 클릭하여 설정 페이지로 이동합니다. 설정 페이지의 Information 탭에서 Workplace ID를 확인할 수 있으며, 자세한 내용은 아래 그림을 참고하십시오.
1.2 Moloco 계정 및 비밀번호 제공
Moloco API를 호출하려면 Token이 필요하며, Token을 생성하려면 Moloco 계정과 비밀번호가 필요합니다. 평소에 사용하는 계정을 그대로 사용하고 싶지 않다면 API 호출 전용 Moloco 계정을 새로 만들 수도 있습니다. 새 계정을 만드는 방법은 아래 그림을 참고하십시오
1.3 광고 계정 ID 가져오기
마지막으로 데이터를 수집할 모든 광고 계정의 ID도 가져와야 합니다. 아래 그림을 참고하여 광고 계정 ID를 확인할 수 있습니다. 여러 광고 계정을 설정할 수 있으므로 데이터를 수집할 모든 광고 계정의 ID를 가져오는 것을 권장합니다
1.4 요약
Moloco 백엔드에서 다음 정보를 가져와야 합니다:
- Workplace ID
- Moloco 계정 이름, 즉 Email
- Moloco 계정 비밀번호
- 데이터를 수집할 모든 광고 계정의 ID
2. 계획 설정
Moloco 인증 정보를 가져온 후 AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 Moloco Log API를 설정할 수 있습니다. 다음은 Moloco의 설정 화면입니다:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 인증 작업에서 가져온 정보를 입력합니다
다음 항목을 차례로 입력합니다
- Workplace ID: 앞서 가져온 Workplace ID
- Email: Moloco 계정 이름
- Password: Moloco 계정의 비밀번호
- Ad Account ID: 데이터를 수집할 광고 계정의 ID. 여러 개인 경우 ","로 구분하십시오
2.2 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.
2.3 통합 설정
통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 예를 들어 저장 후 이벤트 이름, 데이터 수집 차원 등입니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_mapping | 저장 후 이벤트 이름. 커스텀 가능하며 리포트마다 다른 이름을 지정할 수 있음. Key 값은 source.report_types에 대응 |
| source | report_types | 수집할 리포트 타입 |
| transfer | double_columns | 저장할 지표 필드. 수정하지 마십시오 |
Log API는 다음 세 가지 상세 데이터를 제공합니다:
- IMP: 노출 데이터(impression)로, 노출 데이터와 노출 비용 데이터가 포함됩니다
- CLICK: 클릭 데이터로, 클릭 데이터와 해당 유저의 이전 노출 데이터 및 노출 비용 데이터가 포함됩니다
- CONVERSION: 전환 데이터로, MMP에서 가져온 전환 데이터, 어트리뷰션 데이터, 비용 데이터, 수익 데이터 및 해당 유저의 이전 노출, 클릭 데이터가 포함됩니다
- 세 가지 상세 데이터의 구체적인 반환 필드와 의미는 Moloco 공식 문서를 참고하십시오
Log API의 상세 데이터는 ADID(즉 GAID)와 IDFA로 개별 유저를 식별하며, 커스텀 유저 식별 필드를 설정할 수 없습니다. 따라서 AE 시스템은 현재 유저 식별 필드 및 유저 속성 저장 기능을 제공하지 않으며, Log API로 저장되는 데이터는 이벤트 테이블에만 기록되고 하나의 가상 유저에 귀속됩니다.
기본적으로 세 가지 데이터를 모두 연동합니다. 조정이 필요하면 필요한 리포트 이름을 source.report_types에 입력하십시오
2.3.1 공통 필드
- 다음은 세 가지 상세 데이터에 공통으로 포함된 필드입니다:
| 저장 필드명 | 설명 |
|---|---|
| req_exchange | 입찰이 이루어진 광고 익스체인지 |
| req_timestamp | 입찰 요청 시간 |
| req_app_bundle | 앱 패키지 이름 |
| req_app_publisher_id | 퍼블리셔 ID |
| req_device_ifa | 디바이스 ID(예: ADID, IDFA) |
| req_device_os | 디바이스 플랫폼(예: ios, android) |
| req_device_osv | 디바이스 플랫폼 버전 |
| req_device_carrier | 디바이스 통신사 |
| req_device_connectiontype | 디바이스 네트워크 상태 |
| req_device_hwv | 디바이스 하드웨어 버전 |
| req_device_make | 디바이스 제조사 |
| req_device_model | 디바이스 모델 |
| req_device_devicetype | 디바이스 타입 |
| req_device_language | 디바이스 언어 |
| req_device_ip | 디바이스 IP 주소 |
| req_device_lmt | LAT 활성화 여부 |
| req_device_geo_country | 국가/지역 코드 |
| req_device_geo_utcoffset | 시간대 오프셋(분) |
| req_device_geo_region | 미국 지역 코드 |
| req_device_geo_metro | Google metro code |
| req_device_geo_city | 도시 |
| req_device_geo_zip | 우편번호 |
| req_imp_bidfloor | 최저 입찰가 |
| req_imp_tagid | 광고 Placement 또는 태그 ID |
| req_imp_banner_w | Banner 너비 |
| req_imp_banner_h | Banner 높이 |
| req_imp_video_maxduration | 동영상 최대 길이 |
| req_imp_video_minduration | 동영상 최소 길이 |
| req_imp_video_w | 동영상 너비 |
| req_imp_video_h | 동영상 높이 |
| req_imp_video_skip | 동영상 건너뛰기 허용 여부 |
| req_imp_video_ext_is_rewarded | 보상형 동영상 여부 |
| req_imp_native_ext_has_image | Banner 광고 허용 여부 |
| req_imp_native_ext_has_video | 동영상 광고 허용 여부 |
| req_imp_instl | 전면 광고 허용 여부 |
| bid_mtid | Moloco의 입찰 고유 ID |
| bid_advertiser_id | 광고주 ID |
| bid_advertiser_title | 광고주 이름 |
| bid_campaign_id | Campaign ID |
| bid_campaign_title | Campaign 이름 |
| bid_adgroup_id | 광고 그룹 ID |
| bid_adgroup_title | 광고 그룹 이름 |
| bid_creativegroup_id | 소재 그룹 ID |
| bid_creativegroup_title | 소재 그룹 이름 |
| bid_creative_id | 소재 ID |
| bid_creative_title | 소재 이름 |
| bid_creative_type | 소재 유형 |
| bid_creative_w | 소재 너비 |
| bid_creative_h | 소재 높이 |
| bid_creative_size_in_bytes | 소재 크기 |
| bid_creative_video_duration | 동영상 길이. 동영상이 아니면 0 |
| bid_user_bucket | 유저의 트래픽 그룹 |
| bid_adslot_type | 광고 슬롯 유형 |
| bid_adslot_w | 광고 슬롯 너비 |
| bid_adslot_h | 광고 슬롯 높이 |
2.3.2 IMP 데이터(Impression)
다음은 IMP 데이터에만 있는 필드입니다:
| 저장 필드명 | 설명 |
|---|---|
| imp_timestamp | 노출 시간 |
| imp_cost_moloco_micro | 노출 원본 비용. 미국 달러 기준, 100만 배 확대 값 |
| imp_cost_currency | 노출 통화 |
| imp_cost_fee_percent | 노출 서비스 수수료. 미국 달러 기준, 100만 배 확대 값 |
| imp_cost_total_micro | 노출 총비용. 미국 달러 기준, 100만 배 확대 값 |
| imp_ip | IP 주소 |
- 그중 imp_timestamp, 즉 노출이 발생한 시간이 해당 데이터의 #event_time으로 설정됩니다
- IMP 데이터의 기본 이벤트 이름은 -- moloco_log_imp입니다
2.3.3 CLICK 데이터
다음은 CLICK 데이터에만 있는 필드입니다:
| 저장 필드명 | 설명 |
|---|---|
| click_timestamp | 클릭 시간 |
| click_type | 클릭 유형 |
| click_ip | IP 주소 |
- 그중 click_timestamp, 즉 클릭이 발생한 시간이 해당 데이터의 #event_time으로 설정됩니다
- CLICK 데이터의 이벤트 이름은 -- moloco_log_click입니다
2.3.4 CONVERSION 데이터
다음은 CONVERSION 데이터에만 있는 필드입니다:
| 저장 필드명 | 설명 |
|---|---|
| conversion_mmp | 파트너 |
| conversion_event | 파트너로부터 받은 이벤트 콜백 이름 |
| conversion_timestamp | 파트너로부터 데이터를 받은 시간 |
| conversion_attribution_timestamp | 전환 데이터 시간 |
| conversion_attribution_is_view_through | 조회 전환 여부 |
| conversion_attribution_is_engaged_view_through | 참여 조회 전환 여부 |
| conversion_revenue_amount | 콜백된 수익 |
| conversion_revenue_currency | 콜백된 수익의 통화 |
| conversion_revenue_amount_usd | 콜백된 미국 달러 수익 |
| conversion_postback | 원본 콜백 데이터 |
- 그중 conversion_attribution_timestamp, 즉 어트리뷰션이 발생한 시간이 해당 데이터의 #event_time으로 설정됩니다
- CONVERSION 데이터의 이벤트 이름은 -- moloco_log_conversion입니다
2.4 표준화 필드
다음 이벤트 속성은 표준화 처리됩니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| bid_advertiser_id | te_ads_object.ad_account_id | 광고 계정 ID |
| bid_campaign_title | te_ads_object.campaign_name | 캠페인 이름 |
| bid_campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| bid_adgroup_title | te_ads_object.ad_group_name | 광고 그룹 이름, 수익화 광고의 Unit 이름 |
| bid_adgroup_id | te_ads_object.ad_group_id | 광고 그룹 ID, 수익화 광고의 Unit ID |
| bid_creativegroup_title | te_ads_object.ad_name | 광고 이름 |
| bid_creativegroup_id | te_ads_object.ad_id | 광고 ID |
| req_device_os | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| req_device_geo_country | te_ads_object.country | 국가/지역 코드 |
| USD(고정값) | te_ads_object.currency | 비용 또는 수익의 통화 |
| imp_cost_total_micro | te_ads_object.cost | UA 비용 |
| conversion_revenue_amount_usd | te_ads_object.revenue | 수익화 수익 |