YouTube 제휴 실적 분석 (알파)

Reporting 하위 API를 사용하면 YouTube 제휴 프로그램 에 참여하는 제품의 주요 실적 측정항목을 가져올 수 있습니다. 이 가이드에서는 다양한 크리에이터, 동영상 콘텐츠, 개별 제품, 제품 카테고리, 타겟 캠페인에 기여한 판매, 수수료, 주문, 조회수, 클릭수와 같은 YouTube 전용 제휴 데이터를 쿼리하는 방법을 설명합니다.

YouTube 제휴 프로그램 API 및 관련 데이터의 사용은 다음 YouTube Shopping 개발자 정책을 준수해야 합니다.

판매자 센터 쿼리 언어 (MCQL) 을 사용하여 쿼리의 테이블과 같이 작동하는 전용 YouTube 제휴 뷰에서 측정항목과 측정기준을 선택할 수 있습니다.

기본 요건

이 가이드를 사용하기 전에 다음을 확인하세요.

• API 호출을 인증하는 데 사용되는 계정에 실적 측정항목에 대한 액세스 권한을 부여하는 실적 및 통계 역할이 있습니다.
• Google 판매자 센터 계정이 YouTube 제휴 프로그램에 참여합니다.

실험: 판매자 보고 하위 API의 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를 포함합니다. 마켓플레이스의 경우 account_id를 포함하여 개별 하위 판매자 계정별로 실적을 분류합니다. 하위 판매자와 마켓플레이스 플랫폼에서 지원하는 수수료 금액을 보려면 seller_commissions 및 platform_commissions를 포함합니다.

조회수가 가장 많은 동영상 3개를 가져오려면 2025년 5월 1일과 5월 2일 사이, 다음 MCQL 문을 accounts.reports.search 메서드에 전달합니다.

SELECT
  title,
  video_id,
  account_id,
  gross_sales,
  net_sales,
  commissions,
  seller_commissions,
  platform_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, 하위 판매자 계정 ID (account_id), 총 수수료 (commissions), 판매자 지원 수수료 (seller_commissions), 플랫폼 지원 수수료 (platform_commissions) 및 기타 주요 측정항목을 가져옵니다. 참고: MCQL WHERE 절에서 account_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_category_tagged_stats_view를 쿼리합니다. 이 뷰는 제품 분류의 제품 카테고리(product_type)별로 측정항목을 집계하며, 각 카테고리에서 제품을 태그한 고유한 크리에이터 및 동영상 수를 포함합니다.

다음 MCQL SELECT 문을 사용하여 총매출을 기준으로 순위가 매겨진 상위 10개 태그된 제품 카테고리를 2026년 9월 1일에 가져옵니다.

SELECT
  product_type,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_category_tagged_stats_view
WHERE date = '2026-09-01'
ORDER BY gross_sales DESC
LIMIT 10
    

이 쿼리는 지정된 날짜에 gross_sales을 기준으로 순위가 매겨진 상위 10개 제품 카테고리의 제품 카테고리 (product_type), 태그된 크리에이터 수, 태그된 동영상 수, 주요 실적 측정항목을 가져옵니다.

가장 많이 판매된 제품 보기

판매가 가장 많은 제품을 파악하려면 youtube_product_sold_stats_view를 쿼리하면 됩니다.

다음은 총매출을 기준으로 순위가 매겨진 상위 10개 제품을 가져오는 데 사용할 수 있는 MCQL SELECT 문 예입니다. 2026년 1월 20일과 21일 사이

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 문을 사용하여 특정 캠페인의 조회수를 기준으로 순위가 매겨진 상위 10개 크리에이터를 2026년 4월 23일에 가져옵니다.

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 문을 사용하여 특정 캠페인의 조회수를 기준으로 순위가 매겨진 상위 10개 제품을 2026년 6월 20일에 가져옵니다.

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 및 date.
  • youtube_campaign_videos_stats_view: campaign_id, channel_id, date.
  • youtube_campaign_products_stats_view: campaign_id 및 date.
• 지연 시간: 쿼리의 지연 시간은 요청된 데이터 양에 따라 다릅니다. 대규모 데이터 세트를 포함하는 쿼리는 시간이 오래 걸리고 시간 초과가 발생할 수 있습니다.