본문으로 건너뛰기

Moloco 데이터 연동 솔루션

최근 업데이트 2026. 10. 05.

최종 업데이트 날짜: 2022-05-18

1. 통합 계획 소개​

팁

서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다

개요​

이 문서에서는 Moloco 데이터를 Agentic Engine(이하 AE 시스템)으로 콜백하는 방법을 소개합니다. 이 계획은 다음을 지원합니다:

  • Moloco Report API로 집계 지표 데이터를 콜백하며, 노출, 클릭, 설치, 수익, 비용 지표를 포함합니다
  • Moloco Log API로 유저 단위의 원본 데이터를 콜백하며, 노출, 클릭, 전환 데이터를 포함합니다

Moloco 데이터 연동을 시작하기 전에 AE 시스템의 데이터 규칙을 읽고 AE의 데이터 구조를 이해했는지 확인하십시오. 또한 데이터 수집에 필요한 정보를 저희 고객 성공 매니저에게 전달하는 것을 권장합니다. 형식은 데이터 연동 설정 정보 템플릿을 참고하십시오.

절차​

Moloco 데이터 연동 절차는 다음과 같습니다:

  1. Moloco 계정에 로그인하여 Workplace ID를 가져옵니다

  2. API 호출에 사용할 Moloco 계정, 비밀번호 및 Workplace ID를 ThinkingAI 담당자에게 제공합니다

  3. 데이터 수집 방식을 확정합니다:

    1. Moloco Report API로 집계 지표 데이터 콜백
    2. Moloco Log API로 유저 단위의 원본 데이터 콜백

  4. 수집할 데이터 차원, 지표 타입, 수집 빈도 및 수집 기간을 확정합니다

  5. ThinkingAI 담당자가 데이터 수집 개발 작업을 완료합니다

  6. AE 백엔드에서 대시보드와 리포트를 구축하고 데이터 검증을 완료합니다

2. 통합 전 준비 작업​

2.1 Workplace ID 가져오기​

API를 호출하기 전에 먼저 Workplace ID를 가져와야 합니다. Moloco 계정에 로그인한 후 화면 왼쪽 사이드바에서 Settings 버튼을 클릭하여 설정 페이지로 이동합니다. 설정 페이지의 Information 탭에서 Workplace ID를 확인할 수 있으며, 자세한 내용은 아래 그림을 참고하십시오.

그림 1. Workplace ID 확인 방법

2.2 Moloco 계정, 비밀번호 및 Workplace ID 제공​

Moloco API를 호출하려면 Token이 필요하며, Token을 생성하려면 Moloco 계정과 비밀번호, 그리고 이전 단계에서 가져온 Workplace ID가 필요합니다.

Token의 유효 기간은 1시간뿐이므로 Moloco 계정, 비밀번호 및 Workplace ID를 ThinkingAI 담당자에게 제공해야 하며, 시스템이 데이터를 수집할 때 새 Token을 함께 생성합니다. 저희는 기밀 유지 원칙을 엄격히 준수하여 이러한 정보가 유출되지 않도록 합니다. Token 생성의 자세한 메커니즘은 Moloco 공식 문서를 참고하십시오.

API 호출 전용으로 새 Moloco 계정을 생성할 수도 있습니다. 새 계정을 생성하는 방법은 아래 그림을 참고하십시오. 또한 이 문서에서 새 계정 생성에 관한 자세한 정보를 확인할 수 있습니다.

그림 2. 새 사용자 생성 예시

3. 데이터 수집​

Moloco는 두 가지 데이터 수집 방식을 제공합니다. 하나는 집계 지표 데이터를 콜백하는 Report API이고, 다른 하나는 유저 단위의 원본 데이터를 콜백하는 Log API입니다.

3.1 Report API​

인터페이스 기본 정보

인터페이스명API 타입제품화데이터 세분화어트리뷰션 데이터비용 데이터수익 데이터노출 데이터클릭 데이터전환 데이터
Report API풀 방식아니요집계 데이터예예예예예

Report API는 집계 데이터 인터페이스로, 일정 기간의 지표 데이터를 반환합니다. 자세한 내용은 Report API 공식 문서를 참고하십시오

3.1.1 포함 지표​

Report API의 데이터에는 다음 다섯 가지 지표 필드가 포함됩니다:

  • impressions: 노출 수
  • clicks: 클릭 수
  • installs: 설치 수
  • spend: UA 비용
  • revenue: 수익화 수익

3.1.2 인터페이스 파라미터​

  • 광고 계정:

    • Report API로 데이터를 수집할 때는 데이터를 수집할 광고 계정을 지정해야 합니다. 기본적으로 모든 광고 계정의 데이터 수집을 시도하며, 수집할 광고 계정 목록을 지정하려면 데이터 연동 설정 정보 템플릿에 명시하십시오

  • 시간:

    • 일 단위, UTC 시간의 데이터를 수집할 수 있습니다

  • 선택 가능한 차원:

    • Moloco Report API는 다음 분석 차원을 제공합니다. 기본적으로 모든 차원을 선택하여 가장 세분화된 차원의 데이터를 가져옵니다:

      • DATE
      • APP_OR_SITE
      • CAMPAIGN
      • CREATIVE_GROUP
      • CREATIVE
      • EXCHANGE
      • SUB_PUBLISHER
      • TRAFFIC

3.1.3 저장 데이터 구조​

  • Report API는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
  • 데이터의 date 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
  • Report API의 데이터 이벤트 이름 -- moloco_report
  • 다음은 Report API의 저장 필드입니다:
------------------------차원 필드------------------------
ad_account_currency
ad_account_id
ad_account_title
ad_group_id
ad_group_title
app_id
app_os
app_store_id
app_title
campaign_country
campaign_id
campaign_title
creative_id
creative_main_asset_location
creative_title
creative_type
creative_group_id
creative_group_title
exchange_id
site_domain
site_id
site_title
skan_conversion_value
skan_metric_conversion_count
sub_publisher_id
sub_publisher_title
traffic_is_lat
traffic_mmp_effective
traffic_skan_bid
------------------------지표 필드(숫자 타입)------------------------
clicks
impressions
installs
revenue
spend

3.2 Log API​

인터페이스명API 타입제품화데이터 세분화어트리뷰션 데이터비용 데이터수익 데이터노출 데이터클릭 데이터전환 데이터
Log API풀 방식아니요유저 수준예예예예예예

Log API는 유저 단위의 원본 데이터로, 매우 풍부한 유저 데이터를 제공합니다. 주로 다음 세 가지 상세 데이터를 제공합니다:

  • IMP: 노출 데이터(impression)로, 노출 데이터와 노출 비용 데이터가 포함됩니다
  • CLICK: 클릭 데이터로, 클릭 데이터와 해당 유저의 이전 노출 데이터 및 노출 비용 데이터가 포함됩니다
  • CONVERSION: 전환 데이터로, MMP에서 가져온 전환 데이터, 어트리뷰션 데이터, 비용 데이터, 수익 데이터 및 해당 유저의 이전 노출, 클릭 데이터가 포함됩니다
경고

Log API의 상세 데이터는 ADID(즉 GAID)와 IDFA로 개별 유저를 식별하므로, Moloco의 상세 데이터를 AE 유저와 연결하려면 ADID와 IDFA를 AE의 유저 속성에 기록하거나 ADID와 IDFA를 AE 유저의 #distinct_id로 설정해야 합니다. 그렇지 않으면 상세 데이터를 다른 AE 유저 데이터와 연결할 수 없습니다.

3.2.1 인터페이스 파라미터​

  • 광고 계정:
    • Log API로 데이터를 수집할 때는 데이터를 수집할 광고 계정을 지정해야 합니다. 기본적으로 모든 광고 계정의 데이터 수집을 시도하며, 수집할 광고 계정 목록을 지정하려면 데이터 연동 설정 정보 템플릿에 명시하십시오
  • 시간:
    • 매일 3AM - 4AM (UTC)에 전날(UTC)의 데이터를 수집할 수 있습니다

3.2.2 저장 데이터 구조​

  • 세 가지 상세 데이터의 구체적인 반환 필드와 의미는 Moloco 공식 문서를 참고하십시오: https://help.moloco.com/hc/en-us/articles/360047856254-Log-data-field-specification
  • 반환 데이터의 req_device_ifa를 유저를 식별하는 ID로 사용합니다. ADID와 IDFA를 AE 유저의 #distinct_id로 설정하거나 AE의 유저 속성에 설정하십시오
  • 다음은 세 가지 상세 데이터에 공통으로 포함된 필드입니다:
req_exchange
req_timestamp
req_app_bundle
req_app_publisher_id
req_device_ifa
req_device_os
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
req_device_lmt
req_device_geo_country
req_device_geo_utcoffset
req_device_geo_region
req_device_geo_metro
req_device_geo_city
req_device_geo_zip
req_imp_bidfloor
req_imp_tagid
req_imp_banner_w
req_imp_banner_h
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
req_imp_native_ext_has_video
req_imp_instl
bid_mtid
bid_adaccount_id
bid_adaccount_title
bid_app_id
bid_app_title
bid_app_store_id
bid_campaign_id
bid_campaign_title
bid_adgroup_id
bid_adgroup_title
bid_creativegroup_id
bid_creativegroup_title
bid_creative_id
bid_creative_title
bid_creative_type
bid_creative_w
bid_creative_h
bid_creative_size_in_bytes
bid_creative_video_duration
bid_user_bucket
bid_adslot_type
bid_adslot_w
bid_adslot_h
bid_traffic_skan
IMP 데이터(Impression)​

다음은 IMP 데이터에만 있는 필드입니다:

  • 그중 imp_timestamp, 즉 노출이 발생한 시간이 해당 데이터의 #event_time으로 설정됩니다
  • IMP 데이터의 이벤트 이름 -- moloco_log_imp
  • 고유 필드는 다음과 같습니다:
imp_timestamp
imp_cost_moloco_micro
imp_cost_currency
imp_cost_fee_percent
imp_cost_total_micro
imp_ip
CLICK 데이터​

다음은 CLICK 데이터에만 있는 필드입니다:

  • 그중 click_timestamp, 즉 클릭이 발생한 시간이 해당 데이터의 #event_time으로 설정됩니다
  • CLICK 데이터의 이벤트 이름은 -- moloco_log_click입니다
  • 고유 필드는 다음과 같습니다:
click_timestamp
click_type
click_ip
CONVERSION 데이터​

다음은 CONVERSION 데이터에만 있는 필드입니다:

  • 그중 cv_attribution_timestamp, 즉 어트리뷰션이 발생한 시간이 해당 데이터의 #event_time으로 설정됩니다
  • CONVERSION 데이터의 이벤트 이름은 -- moloco_log_conversion입니다
  • 고유 필드는 다음과 같습니다:
cv_mmp
cv_event
cv_timestamp
cv_attribution_timestamp
cv_attribution_is_view_through
cv_revenue_amount
cv_revenue_currency
cv_revenue_amount_usd
cv_postback

3.2.3 유저 속성 처리​

현재 Moloco Log API 상세 데이터의 필드를 유저 속성으로 아직 설정하지 않았습니다. 일부 필드를 유저 속성에 기록하려면 데이터 연동 설정 정보 템플릿에 명시하십시오.

4. 데이터 연동 설정 정보 템플릿​

위 문서를 읽은 후 다음 정보 템플릿을 작성하여 ThinkingAI의 고객 성공 매니저에게 보내는 것을 권장합니다. 저희는 이 정보 템플릿에 따라 Moloco의 데이터 수집을 완료합니다:

데이터 인터페이스: Moloco API
---------
회사 이름: XXX
AE 프로젝트 환경: (SAAS/프라이빗 배포)
AE 프로젝트 이름: XXX
AE 프로젝트 APP ID: XXX
데이터 수신 주소 push_url: XXX
---------
Moloco 계정명: XXX
Moloco 계정 비밀번호: XXX
Moloco Workplace ID：XXX
광고주 ID(ad_account_id) 목록: XXX, XXX
---------
Report API 설정
기간: yyyy/mm/dd - yyyy/mm/dd
그룹 차원: DATE, APP_OR_SITE, CAMPAIGN, CREATIVE_GROUP, CREATIVE, EXCHANGE, SUB_PUBLISHER, TRAFFIC
---------
Log API 설정
과거 데이터 수집 기간: yyyy/mm/dd - yyyy/mm/dd
이벤트 타입: IMP, CLICK, CONVERSION
유저 속성으로 설정할 필드: XXX

5. 연동 테스트 및 데이터 활용​

연동 테스트​

AE 시스템 백엔드의 데이터 관리 - 이벤트 관리 페이지 또는 SQL IDE 페이지에서 다음 이벤트가 저장되었는지 검색할 수 있습니다:

  • Report API 대응 이벤트:

    • moloco_report

  • Log API 대응 이벤트:

    • moloco_log_imp
    • moloco_log_click
    • moloco_log_conversion
이 문서가 도움이 되었나요?
이 페이지의 내용