위챗 미니 게임 광고 요약 데이터 통합 계획

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

팁

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

개요

인터페이스 소개

인터페이스명	타입	세분화	어트리뷰션	비용	수익	노출	클릭	전환
미니 게임 광고 요약 데이터	API	집계 지표			✅	✅	✅

위챗 광고 분석 데이터 API는 여러 데이터 리포트를 제공하며, AE 시스템은 미니 프로그램/미니 게임 광고 요약 데이터를 지원하여 각 광고 위치의 노출, 클릭 및 수익 데이터를 가져올 수 있습니다

통합 절차

1. 위챗 Access Token 조회 API를 개발합니다
2. AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 위챗 광고 분석 데이터 API 계획을 추가하고 관련 설정을 완료합니다
3. AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다

1. Access Token 조회 API 개발

위챗 플랫폼의 Access Token을 반복해서 발급받으면 이전에 발급받은 Access Token이 무효화됩니다. 데이터 수집으로 인해 Access Token이 갱신되는 것을 방지하려면 중앙 제어 서버에서 Access Token을 일괄 발급하고 갱신하도록 하고, ThinkingAI에 Access Token 조회 API를 제공해야 합니다.

API의 Response 파라미터는 위챗 공식 API와 동일합니다:

{
    'access_token': '**************', 
    'expires_in': 7200
}

파라미터의 의미는 다음과 같습니다:

파라미터	설명
access_token	발급받은 자격 증명
expires_in	자격 증명 유효 시간, 단위: 초

2. 계획 설정

다음으로 AE 백엔드에 로그인하여 위챗 미니 게임 광고 요약 데이터의 통합 계획을 생성하고 관련 설정을 완료하십시오

2.1 인증 정보 설정

먼저 인증 정보 영역의 인증 정보 설정 버튼을 클릭하고, 표시되는 인증 정보 팝업에 귀사에서 개발한 Access Token 조회 API를 입력합니다. 조회 API가 통신 가능한지, 반환되는 데이터 형식이 올바른지 확인하십시오

2.2 동기화

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

팁

1회 최대 수집 일수는 90일을 넘지 않도록 하는 것을 권장합니다. 이는 위챗 API의 1회 요청 최대 기간입니다. 설정 페이지에 표시되는 안내 문구 수집 가능한 기간은 최대 과거 365일입니다는 수집할 수 있는 과거 데이터의 범위를 뜻하며, 두 가지는 의미가 다릅니다.

2.3 저장 설정

데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.

2.4 통합 설정

마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 예를 들어 데이터 저장 후의 이벤트 이름 등입니다.

통합 설정은 JSON이며, 필요에 따라 내용을 조정할 수 있습니다

모듈	이름	의미
sink_event	event_name	저장 후 이벤트 이름, 커스텀 가능

2.5 저장 규칙

• 위챗 광고 수익화 데이터는 집계 데이터를 반환하므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
• 데이터의 date 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
• 데이터의 이벤트 이름은 weixin_publisher_adpos_general입니다
• 지표 필드는 숫자 타입으로 저장되고, 나머지 필드는 문자열로 저장됩니다

파라미터	설명
slot_id	광고 위치 타입 ID
ad_slot	광고 위치 타입 이름
date	데이터 날짜
req_succ_count	요청 성공 수
exposure_count	노출 수
exposure_rate	노출률
click_count	클릭 수
click_rate	총 클릭률
income	수익(펀)
ecpm	1000회 노출당 광고 수익(펀)

2.6 표준화 필드

다음 이벤트 속성은 표준화 처리됩니다:

원본 필드	표준화 필드	의미
ad_slot	te_ads_object.placement	광고 위치 타입 이름
exposure_count	te_ads_object.impressions	노출 수
click_count	te_ads_object.clicks	클릭 수
income(100으로 나눔)	te_ads_object.revenue	수익(위안)
고정값 CNY	te_ads_object.currency	수익의 통화