Analyze Youtube Affiliate Performance (Alpha)

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

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

기본 요건

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

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

알파 엔드포인트 쿼리

공개 알파 버전이므로 엔드포인트가 다릅니다. YouTube 제휴사 실적 데이터를 가져오려면 v1alpha 엔드포인트로 POST 요청을 보내야 합니다. 다음은 샘플 요청입니다.

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

  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,
  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개 제품의 판매 데이터, 수수료, 주요 측정항목을 가져옵니다.

중요 고려사항

• 날짜: 항상 WHERE 절을 사용하여 date별로 쿼리를 필터링하여 보고 기간을 지정합니다. 날짜는 YYYY-MM-DD 형식입니다.
• 지연 시간: 쿼리의 지연 시간은 요청된 데이터 양에 따라 다릅니다. 대규모 데이터 세트를 포함하는 쿼리는 시간이 오래 걸리고 시간 초과가 발생할 수 있습니다.