본문으로 건너뛰기

Pangle Gromore 통합 계획

최근 업데이트 2026. 10. 03.
팁

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

개요​

인터페이스 소개​

인터페이스명타입세분화어트리뷰션비용수익노출클릭전환
집계 데이터 APIAPI집계 지표✅✅✅

Pangle Gromore는 집계 데이터 리포트 API를 제공하며, 이 인터페이스로 수익화 광고의 노출, 클릭, 수익 집계 데이터를 가져올 수 있습니다

통합 절차​

  1. Pangle 백엔드에서 집계 데이터 리포트 API 문서의 Security key, RoleId와 유저의 UserId를 가져옵니다
  2. AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Pangle Gromore 통합을 추가하여 통합 계획을 생성합니다
  3. AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다

1. 인증 정보 가져오기​

Pangle Gromore 데이터 연동의 첫 단계로 Pangle 백엔드에 로그인하여 왼쪽 사이드바에서 연동 - API 연동 문서를 선택하고, 아래 그림에 표시된 부분을 클릭하여 유저의 Security key와 RoleId를 가져옵니다

또한 유저의 UserId도 가져와야 합니다. 페이지 오른쪽 상단의 사용자 이름 아래에 있는 ID 필드가 UserId입니다

2. 계획 설정​

Pangle Gromore 플랫폼의 인증 정보를 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 아래 그림은 Pangle Gromore 집계 데이터 API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:

2.1 인증 정보 설정​

인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 Pangle Gromore 플랫폼에서 가져온 정보를 입력합니다

2.2 동기화​

동기화 모듈에서 AE 시스템이 Pangle Gromore 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다

2.3 데이터 수집 시간대​

수집할 데이터의 시간대도 설정할 수 있으며, 기본값은 UTC+8입니다

2.4 이벤트 테이블 저장 설정​

이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.

2.5 통합 설정​

마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.

통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:

모듈이름의미
sink_eventevent_name저장 후 이벤트 이름, 커스텀 가능, 문자열 타입.
source

report_types

데이터를 수집할 리포트 타입. 주로 일 단위 리포트와 시간 단위 리포트 중에서 선택하며, 다음 값을 선택할 수 있습니다:

  • 일 단위 리포트: day
  • 시간 단위 리포트: hour
metrics해당 인터페이스의 지표 필드, 리스트 타입, 커스텀 가능
group_by해당 인터페이스의 차원 필드, 리스트 타입, 커스텀 가능

일 단위 리포트와 시간 단위 리포트는 차이가 크므로 해당 리포트의 설정 템플릿을 그대로 사용하거나 템플릿을 조금 수정하여 사용할 것을 권장합니다

2.5.1 시간 단위 데이터 리포트 템플릿​

시간 단위 데이터 리포트는 기본으로 수집하는 데이터 리포트이기도 하며, 다음 템플릿을 그대로 사용할 수 있습니다:

{
  "sink_event": {
    "event_name": "csj_gromore_report"
  },
  "source": {
    "group_by": [
      "site_id",
      "adunittype",
      "adunit_id",
      "network",
      "code_id",
      "os",
      "sdk_version",
      "segment",
      "site_version",
      "channel"
    ],
    "report_types": [
      "hour"
    ],
    "metrics": [
      "req_cnt",
      "ret_cnt",
      "fill_rate",
      "clk_cnt",
      "clk_rate",
      "imp_cnt",
      "ssr",
      "ecpm",
      "revenue"
    ]
  }
}
  • 포함 지표

다음은 시간 단위 데이터 리포트가 지원하는 지표입니다. 조정이 필요하면 지표명을 source.metrics에 추가하십시오:

필드설명비고기본 여부
api_ecpmReporting API로 가져온 예상 eCPM

code_id로 그룹화할 때만 사용할 수 있습니다

api_imp_cntReporting API로 가져온 예상 노출 수
api_revenueReporting API로 가져온 예상 수익
waterfall_req_cnt트래픽 요청량

network와 code_id로 그룹화할 때는 반환되지 않습니다

waterfall_send_cnt트래픽 응답량
waterfall_sr트래픽 채움률
req_cnt광고 요청량예
ret_cnt광고 응답량예
fill_rate광고 채움률예
clk_cnt클릭 수예
clk_rate클릭률예
imp_cnt노출량예
ssr노출률예
ecpm예상 eCPM예
revenue예상 수익예
  • 분석 차원

시간 단위 데이터 리포트는 다음 집계 차원을 제공합니다. 조정이 필요하면 차원명을 source.group_by에 추가하십시오:

차원필드설명기본값
site_idsite_idgromore 미디에이션 관리의 앱 ID예
adunittypeadunittype미디에이션 관리의 광고 유닛 타입예

adunit_id

ad_unit_name광고 위치 이름예
adunit_id광고 유닛 ID예
networknetwork코드 슬롯이 속한 광고 네트워크예
code_idcode_name코드 슬롯 이름예
code_id코드 슬롯 ID예
ososOS 타입예
sdk_versionsdk_versionSDK 버전
segmentsegemt_id트래픽 그룹 ID
site_versionsite_version앱 버전
channelchannel채널 정보
필수 필드user_id미디어 계정 ID예
role_id하위 계정 ID예
currency통화예
  • 저장 규칙

데이터의 start_date와 end_date 필드, 즉 데이터 집계의 시간 필드를 집계 데이터의 #event_time으로 설정합니다

기본 이벤트 이름 -- csj_gromore_report

2.5.2 일 단위 데이터 리포트 템플릿​

일 단위 데이터 리포트는 시간 단위 데이터 리포트와 몇 가지 차이가 있습니다. 다음 템플릿을 사용하거나 이 절의 내용에 따라 수집 필드를 커스텀할 수 있습니다:

{
    "sink_event":
    {
        "event_name": "csj_gromore_report"
    },
    "source":
    {
        "group_by":
        [
            "site_id",
            "ad_unit_type",
            "ad_unit_id",
            "network",
            "code_id"
        ],
        "report_types":
        [
            "day"
        ],
        "metrics":
        [
            "req_cnt",
            "ret_cnt",
            "fill_rate",
            "imp_cnt",
            "ssr",
            "clk_cnt",
            "clk_rate",
            "ecpm",
            "revenue",
            "api_ecpm",
            "api_revenue",
            "api_imp_cnt",
            "api_req_cnt",
            "api_ret_cnt",
            "api_clk_cnt",
            "api_ssr",
            "api_fill_rate",
            "api_show_gap_rate",
            "api_click_gap_rate"
        ]
    }
}
  • 포함 지표

다음은 일 단위 데이터 리포트가 지원하는 지표입니다. 조정이 필요하면 지표명을 source.metrics에 추가하십시오:

필드설명비고기본 여부
waterfall_req_cnt트래픽 요청량network와 code_id로 그룹화할 때는 반환되지 않습니다
waterfall_send_cnt트래픽 응답량
waterfall_sr트래픽 채움률
req_cnt광고 요청량예
ret_cnt광고 응답량예
fill_rate광고 채움률예
imp_cnt노출량예
ssr노출률예
clk_cnt클릭 수예
clk_rate클릭률예
ecpm예상 eCPM예
revenue예상 수익예
api_ecpmReporting API로 가져온 예상 eCPM

이 지표들을 조회하려면 Gromore 플랫폼에서 광고 네트워크를 설정해야 데이터가 반환됩니다.

예
api_revenueReporting API로 가져온 예상 수익예
api_imp_cntReporting API로 가져온 예상 노출 수예
api_req_cntReporting API로 가져온 광고 요청 수예
api_ret_cntReporting API로 가져온 광고 응답 수예
api_clk_cntReporting API로 가져온 광고 클릭 수예
api_ssrReporting API로 가져온 노출률예
api_fill_rateReporting API로 가져온 채움률예
api_show_gap_rateReporting API로 가져온 노출량과 광고 플랫폼에서 집계한 노출량의 차이. 공식: 노출 gap = (imp_cnt - api_imp_cnt) / api_imp_cnt예
api_click_gap_rateReporting API로 가져온 클릭량과 광고 플랫폼에서 집계한 클릭량의 차이. 공식: 클릭 gap = (clk_cnt - api_clk_cnt) / api_clk_cnt예
  • 분석 차원

일 단위 데이터 리포트는 다음 집계 차원을 제공합니다. 조정이 필요하면 차원명을 source.group_by에 추가하십시오:

차원필드설명기본값
site_idsite_idgromore 미디에이션 관리의 앱 ID예
ad_unit_typead_unit_type미디에이션 관리의 광고 유닛 타입예

ad_unit_id

ad_unit_name광고 위치 이름예
ad_unit_id광고 유닛 ID예
networknetwork코드 슬롯이 속한 광고 네트워크예
code_idcode_name코드 슬롯 이름예
code_id코드 슬롯 ID예
segmentsegemt_id트래픽 그룹
sdk_versionsdk_versionSDK 버전
site_versionsite_version앱 버전
channelchannel채널 정보
user_typeuser_type유저 타입
필수 필드osOS 타입예
user_id미디어 계정 ID예
role_id하위 계정 ID예
currency통화예
  • 저장 규칙

데이터의 date 필드, 즉 데이터 집계의 일 단위 필드를 집계 데이터의 #event_time으로 설정합니다

기본 이벤트 이름 -- csj_gromore_report

2.6 표준화 필드​

필드표준화 필드설명
currencyte_ads_object.currency통화
ad_unit_namete_ads_object.ad_group_name광고 위치 이름
ad_unit_idte_ads_object.ad_group_id광고 유닛 ID
adunit_idte_ads_object.ad_group_id광고 유닛 ID
networkte_ads_object.media_source코드 슬롯이 속한 광고 네트워크
code_namete_ads_object.ad_name코드 슬롯 이름
code_idte_ads_object.ad_id코드 슬롯 ID
oste_ads_object.platformOS 타입
user_idte_ads_object.ad_account_id미디어 계정 ID
imp_cntte_ads_object.impressions노출량
clk_cntte_ads_object.clicks클릭 수
revenuete_ads_object.revenue예상 수익
이 문서가 도움이 되었나요?
이 페이지의 내용