Reports API를 사용하여 YouTube 제휴 프로그램에 참여하는 제품의 주요 실적 측정항목을 가져올 수 있습니다. 이 가이드에서는 다양한 크리에이터, 동영상 콘텐츠, 개별 제품에 기여한 매출, 수수료, 주문, 조회수, 클릭수와 같은 YouTube 전용 제휴 데이터를 쿼리하는 방법을 설명합니다.
MCQL을 사용하여 전용 YouTube 제휴 프로그램 '조회수'에서 측정항목과 측정기준을 선택할 수 있습니다. 이는 쿼리에서 테이블과 같은 역할을 합니다.
기본 요건
이 가이드를 사용하기 전에 다음 사항을 확인하세요.
- API 호출을 인증하는 데 사용되는 계정에 성능 측정항목에 대한 액세스 권한을 부여하는 성능 및 유용한 정보 역할이 있습니다.
- Google 판매자 센터 계정이 YouTube 제휴 프로그램에 참여합니다.
알파 엔드포인트 쿼리
공개 알파이므로 엔드포인트가 다릅니다. YouTube 제휴사 실적 데이터를 가져오려면 v1alpha 엔드포인트에 POST 요청을 보내야 합니다.
다음은 샘플 요청입니다.
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed
크리에이터별 실적 보기
참여도와 판매를 가장 많이 유도하는 YouTube 크리에이터를 파악하려면 youtube_creator_performance_view를 쿼리하면 됩니다.
이 보기는 개별 YouTube 크리에이터별로 측정항목을 집계하며 크리에이터 제목과 채널 ID를 포함합니다.
다음은 2025년 5월 1일과 5월 2일 사이에 매출이 가장 높은 크리에이터 3명을 가져오는 데 사용할 수 있는 MCQL SELECT 문 예시입니다.
SELECT
title,
channel_id,
sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
이 쿼리는 지정된 기간 내에서 판매 측정항목을 기준으로 순위가 매겨진 상위 3명의 크리에이터의 크리에이터 제목, 채널 ID, 주요 실적 측정항목을 가져옵니다.
콘텐츠별 실적 보기
실적이 가장 좋은 특정 YouTube 동영상을 확인하려면 youtube_content_performance_view를 쿼리하면 됩니다.
이 뷰는 개별 YouTube 동영상별로 측정항목을 집계하며 동영상 제목과 ID를 포함합니다.
다음은 2025년 5월 1일과 5월 2일 사이에 조회수가 가장 많은 동영상 3개를 가져오는 데 사용할 수 있는 MCQL SELECT 문 예시입니다.
SELECT
title,
video_id,
views,
clicks,
sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3
이 쿼리는 지정된 기간에 총 views 수로 순위가 매겨진 상위 3개 동영상의 동영상 제목, 동영상 ID, 주요 측정항목을 가져옵니다.
제품별 실적 보기
YouTube 제휴 프로그램 내 개별 제품의 실적을 분석하려면 youtube_product_performance_view를 쿼리하면 됩니다.
이 보기는 제품별로 측정항목을 집계하며 제품 제목과 혜택 ID를 포함합니다.
다음은 2025년 5월 1일과 5월 2일 사이에 판매액이 가장 높은 제품 3개를 찾는 데 사용할 수 있는 MCQL SELECT 문 예시입니다.
SELECT
title,
offer_id,
sales,
commissions,
orders,
clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
이 쿼리는 지정된 기간 동안 sales 측정항목을 기준으로 정렬된 상위 3개 제품의 제품 제목, 혜택 ID, 실적 측정항목을 반환합니다.
중요 고려사항
- 날짜: 항상
WHERE절을 사용하여 보고 기간을 지정하여date별로 쿼리를 필터링합니다. 날짜는YYYY-MM-DD형식입니다. - 지연 시간: 쿼리의 지연 시간은 요청된 데이터의 양에 따라 달라집니다. 쿼리가 크면 시간이 오래 걸리고 시간 초과가 발생할 수 있습니다.