Analyze YouTube Affiliate Performance (Alpha)

Вы можете получать ключевые показатели эффективности для своих продуктов, участвующих в партнёрской программе YouTube, с помощью API отчётов. В этом руководстве объясняется, как запрашивать данные о партнёрских программах YouTube, такие как продажи, комиссии, заказы, просмотры и клики, приписываемые разным авторам, видеоконтенту и отдельным продуктам.

Вы можете использовать MCQL для выбора показателей и измерений из специальных «представлений» партнерской программы YouTube, которые функционируют как таблицы в ваших запросах.

Предпосылки

Перед использованием данного руководства убедитесь, что:

Запросить конечную точку альфа

Обратите внимание, что, поскольку это общедоступная альфа-версия, конечная точка отличается. Чтобы получить данные об эффективности партнёрской программы YouTube, необходимо отправить POST-запрос на конечную точку версии v1alpha . Вот пример запроса:

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, включая названия авторов и идентификаторы каналов.

Ниже приведен пример оператора MCQL SELECT, который можно использовать для получения трех самых эффективных авторов по объему продаж в период с 1 по 2 мая 2025 года.

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

Этот запрос извлекает название создателя, идентификатор канала и ключевые показатели эффективности для трех лучших создателей, отсортированных по метрике продаж в указанном диапазоне дат.

Посмотрите эффективность по содержанию

Чтобы узнать, какие конкретно видео на YouTube показывают лучшие результаты, можно выполнить запрос к представлению youtube_content_performance_view . Это представление агрегирует показатели по отдельным видео на YouTube, включая названия и идентификаторы видео.

Ниже приведен пример оператора MCQL SELECT, который можно использовать для получения 3 лучших видеороликов по количеству просмотров в период с 1 по 2 мая 2025 года.

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 за указанный диапазон дат.

Посмотреть производительность по продукту

Чтобы проанализировать эффективность отдельных продуктов в рамках партнёрской программы YouTube, вы можете выполнить запрос к представлению youtube_product_performance_view . Это представление агрегирует показатели по продуктам, включая их названия и идентификаторы предложений.

Вот пример оператора MCQL SELECT, который можно использовать для поиска трех лучших продуктов по объему продаж в период с 1 по 2 мая 2025 года:

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 , за указанный период.

Важные соображения

  • Даты: Всегда фильтруйте запросы по date , используя предложения WHERE для указания отчётного периода. Даты представлены в формате YYYY-MM-DD .
  • Задержка: Задержка запросов зависит от объёма запрашиваемых данных. Большие запросы занимают больше времени и могут вызывать тайм-ауты.