Analyze YouTube Affiliate Performance (Alpha)

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

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

Предварительные требования

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

• Учетная запись, используемая для аутентификации вызовов API, имеет роль « Производительность и аналитика» , которая предоставляет доступ к показателям производительности.
• Ваш аккаунт Google Merchant Center участвует в партнерской программе YouTube .

Запрос к конечной точке alpha

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

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

Вот пример оператора MCQL SELECT, который можно использовать для получения списка 3 авторов, показавших лучшие результаты по продажам в период с 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 и включает названия и идентификаторы видео.

Чтобы получить список из 3 видеороликов с наибольшим количеством просмотров за период с 1 по 2 мая 2025 года, передайте методу accounts.reports.search следующее выражение на языке запросов Merchant Center :

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

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

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

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