Analyze Youtube Affiliate Performance (Alpha)

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

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

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

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

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

Оценка эффективности в зависимости от контента.

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

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

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

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

Посмотреть товары с наибольшим количеством взаимодействий

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

Вот пример запроса SELECT в формате MCQL, который можно использовать для получения списка 10 товаров с наибольшим количеством просмотров за период с 20 по 21 января 2026 года :

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

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

Посмотреть самые продаваемые товары

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

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

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 самых популярных товаров, отсортированных по валовым продажам, в указанном диапазоне дат.

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

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