보고 하위 API를 사용하여 YouTube 제휴 프로그램에 참여하는 제품의 주요 실적 측정항목을 가져올 수 있습니다. 이 가이드에서는 다양한 크리에이터, 동영상 콘텐츠, 개별 제품, 타겟팅된 캠페인에 기여한 판매, 수수료, 주문, 조회수, 클릭수와 같은 YouTube 관련 제휴 데이터를 쿼리하는 방법을 설명합니다.
YouTube 제휴 프로그램 API 및 관련 데이터의 사용은 YouTube Shopping 개발자 정책을 준수해야 합니다.
판매자 센터 쿼리 언어(MCQL)를 사용하여 전용 YouTube 제휴사 보기에서 측정항목과 측정기준을 선택할 수 있습니다. 이러한 보기는 쿼리에서 테이블처럼 작동합니다.
기본 요건
이 가이드를 사용하기 전에 다음 사항을 확인하세요.
- API 호출을 인증하는 데 사용되는 계정에 실적 측정항목에 대한 액세스 권한을 부여하는 실적 및 통계 역할이 있습니다.
- Google 판매자 센터 계정이 YouTube 제휴 프로그램에 참여하고 있습니다.
알파 엔드포인트 쿼리
이 기능은 공개 알파 버전이므로 엔드포인트가 다릅니다. YouTube 제휴사 실적 데이터를 가져오려면 v1alpha 엔드포인트로 POST 요청을 보내야 합니다. 보고서 가져오기에 관한 자세한 내용은 accounts.reports.search을 참고하세요.
다음은 샘플 요청입니다.
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3"
}
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' \
--header 'Content-Type: application/json' \
--data '{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '\''2025-05-01'\'' AND date < '\''2025-05-02'\'' ORDER BY gross_sales DESC LIMIT 3"
}' \
--compressed
크리에이터별 실적 보기
참여도와 판매를 가장 많이 유도하는 YouTube 크리에이터를 파악하려면 youtube_creator_performance_view를 쿼리하면 됩니다.
이 보기는 개별 YouTube 크리에이터별로 측정항목을 집계하며 크리에이터 제목과 채널 ID를 포함합니다.
다음은 2025년 5월 1일과 5월 2일 사이에 판매 실적이 가장 우수한 크리에이터 3명을 가져오는 데 사용할 수 있는 MCQL SELECT 문 예시입니다.
SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3
이 쿼리는 지정된 기간 내 총매출 측정항목을 기준으로 순위가 매겨진 상위 3명의 크리에이터의 크리에이터 제목, 채널 ID, 주요 실적 측정항목을 가져옵니다.
콘텐츠별 실적 보기
실적이 가장 좋은 특정 YouTube 동영상을 확인하려면 youtube_content_performance_view를 쿼리하면 됩니다.
이 뷰는 개별 YouTube 동영상별로 측정항목을 집계하며 동영상 제목과 ID를 포함합니다.
2025년 5월 1일과 5월 2일 사이에 조회수가 가장 많은 동영상 3개를 가져오려면 다음 MCQL 문을 accounts.reports.search 메서드에 전달합니다.
SELECT title, video_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_content_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY views DESC LIMIT 3
이 쿼리는 지정된 기간에 총 views 수로 순위가 매겨진 상위 3개 동영상의 동영상 제목, 동영상 ID, 주요 측정항목을 가져옵니다.
참여도가 가장 높은 태그된 제품 보기
태그된 제품 중 참여도와 판매가 가장 높은 제품을 파악하려면 youtube_product_tagged_stats_view를 쿼리하면 됩니다.
이 뷰는 태그가 지정된 개별 제품별로 측정항목을 집계하며, 여기에는 제품명과 혜택 ID가 포함됩니다.
2026년 1월 20일과 21일 사이에 조회수가 가장 많은 상위 10개 제품을 가져오는 데 사용할 수 있는 MCQL SELECT 문 예시는 다음과 같습니다.
SELECT title, offer_id, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_tagged_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY views DESC LIMIT 10
이 쿼리는 지정된 기간의 총 views 수로 순위가 매겨진 상위 10개 제품의 제목, 태그된 동영상 수, 주요 측정항목을 가져옵니다.
가장 많이 판매된 제품 보기
판매량이 가장 많은 제품을 파악하려면 youtube_product_sold_stats_view를 쿼리하면 됩니다.
다음은 2026년 1월 20일과 21일 사이의 총매출을 기준으로 상위 10개 제품을 가져오는 데 사용할 수 있는 MCQL SELECT 문 예시입니다.
SELECT title, offer_id, gross_sales, net_sales, commissions, orders FROM youtube_product_sold_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY gross_sales DESC LIMIT 10
이 쿼리는 지정된 기간 동안 총매출을 기준으로 주문된 상위 10개 제품의 판매 데이터, 수수료, 주요 측정항목을 가져옵니다.
모든 캠페인의 실적 보기
전체적으로 제휴 캠페인의 실적을 파악하려면 youtube_campaigns_stats_view를 쿼리하세요.
이 뷰는 캠페인 이름, 시작일 및 종료일, 활성 크리에이터 수, 판매 및 참여 측정항목을 비롯한 모든 캠페인의 측정항목을 집계합니다.
다음 MCQL SELECT 문을 사용하여 2026년 4월 23일의 주문을 기준으로 상위 10개 캠페인을 가져옵니다.
SELECT campaign_id, campaign_name, start_date, end_date, active_creators, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaigns_stats_view WHERE date = '2026-04-23' ORDER BY orders DESC LIMIT 10
이 쿼리는 지정된 날짜에 총 orders 수로 순위가 매겨진 상위 10개 캠페인의 캠페인 ID, 캠페인 이름, 기간, 활성 크리에이터 수, 주요 실적 측정항목을 가져옵니다.
크리에이터별 캠페인 실적 보기
특정 캠페인에 참여하는 개별 크리에이터의 실적을 분석하려면 youtube_individual_campaign_stats_view를 쿼리합니다.
이 보기는 채널 제목, 동영상 수, 태그된 제품 제목 등 캠페인 내 크리에이터별 측정항목을 집계합니다.
다음 MCQL SELECT 문을 사용하여 2026년 4월 23일 특정 캠페인의 조회수 상위 10개 크리에이터를 가져옵니다.
SELECT channel_title, video_count, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_individual_campaign_stats_view WHERE date = '2026-04-23' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
이 쿼리는 지정된 캠페인 및 날짜 내에서 총 조회수를 기준으로 순위가 매겨진 상위 10명의 크리에이터의 크리에이터 채널 제목, 동영상 수, 제품 제목, 주요 실적 측정항목을 가져옵니다.
동영상별 캠페인 실적 보기
캠페인 내에서 특정 크리에이터 동영상의 실적을 확인하려면 youtube_campaign_videos_stats_view를 쿼리합니다.
이 보기는 동영상 제목, 동영상 형식, 태그된 제품 등 캠페인에 참여하는 크리에이터의 동영상 수준 실적 측정항목을 제공합니다.
다음 MCQL SELECT 문을 사용하여 2026년 5월 20일의 특정 크리에이터 및 캠페인에 대한 조회수 상위 10개 동영상을 가져옵니다.
SELECT video_title, content_type, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_videos_stats_view WHERE date = '2026-05-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' AND channel_id = 'YOUR_CHANNEL_ID' ORDER BY views DESC LIMIT 10
이 쿼리는 지정된 크리에이터 채널, 캠페인, 날짜의 총 views 수로 순위가 매겨진 상위 10개 동영상의 동영상 제목, 동영상 형식 (content_type), 태그된 제품 제목, 주요 실적 측정항목을 가져옵니다.
제품별 캠페인 실적 보기
캠페인 내에서 개별 제품의 실적을 파악하려면 youtube_campaign_products_stats_view를 쿼리하세요.
이 보기는 제품명, 연결된 동영상 세부정보, 판매 측정항목 등 캠페인 내 제품 수준 실적 측정항목을 제공합니다.
다음 MCQL SELECT 문을 사용하여 2026년 6월 20일 특정 캠페인의 조회수 상위 10개 제품을 가져옵니다.
SELECT channel_title, product_title, video_title, video_url, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_products_stats_view WHERE date = '2026-06-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
이 쿼리는 지정된 캠페인 및 날짜 내에서 총 views 수로 순위가 매겨진 상위 10개 제품의 크리에이터 채널 제목, 제품 제목, 동영상 제목, 동영상 URL, 주요 실적 측정항목을 가져옵니다.
중요 고려사항
- 날짜: 항상
WHERE절을 사용하여date별로 쿼리를 필터링하여 보고 기간을 지정합니다. 날짜는YYYY-MM-DD형식입니다. - 필수 필터: 일부 캠페인 보기에는
WHERE절에 추가 필터가 필요합니다.youtube_individual_campaign_stats_view:campaign_id및dateyoutube_campaign_videos_stats_view:campaign_id,channel_id,dateyoutube_campaign_products_stats_view:campaign_id및date
- 지연 시간: 쿼리의 지연 시간은 요청된 데이터 양에 따라 달라집니다. 대규모 데이터 세트를 포함하는 쿼리는 시간이 오래 걸리고 시간 초과가 발생할 수 있습니다.