Вы можете получать ключевые показатели эффективности для товаров, участвующих в партнерской программе YouTube, с помощью Reporting sub-API. В этом руководстве рассказывается, как запрашивать данные о партнерской программе YouTube, например о продажах, комиссиях, заказах, просмотрах и кликах, связанных с разными авторами, видеоконтентом, отдельными товарами, категориями товаров и целевыми кампаниями.
Использование API партнерской программы YouTube и связанных с ними данных должно соответствовать правилам для разработчиков YouTube Покупок.
Вы можете использовать язык запросов Merchant Center (MCQL), чтобы выбирать показатели и параметры из представлений YouTube Affiliate, которые работают как таблицы в запросах.
Требования
Прежде чем использовать это руководство, убедитесь, что:
- Аккаунт, используемый для аутентификации вызовов API, имеет роль Эффективность и статистика, которая предоставляет доступ к показателям эффективности.
- Ваш аккаунт Google Merchant Center участвует в партнерской программе YouTube.
Как отправить запрос к конечной точке альфа-версии
Поскольку эта функция находится на стадии общедоступного альфа-тестирования, конечная точка отличается. Чтобы получить данные об эффективности партнерской программы YouTube Покупок, отправьте запрос POST к конечной точке v1alpha. Подробнее о том,
как получать отчеты…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 и включают названия и идентификаторы каналов.
Ниже приведен пример запроса SELECT на языке MCQL, который позволяет получить список из трех авторов с самыми высокими продажами с 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, а также приводятся названия и идентификаторы видео. Для торговых площадок добавьте account_id, чтобы разбить данные об эффективности по отдельным дочерним аккаунтам продавцов. Чтобы посмотреть суммы комиссий, выплаченных субпродавцами и торговой площадкой, добавьте столбцы seller_commissions и platform_commissions.
Чтобы получить три самых популярных видео по количеству просмотров с 1 по 2 мая 2025 года, передайте в метод accounts.reports.search следующий запрос MCQL:
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
Этот запрос позволяет получить название видео, идентификатор видео, идентификатор аккаунта субпродавца (account_id), общую сумму комиссий (commissions), сумму комиссий, выплаченных продавцом (seller_commissions), сумму комиссий, выплаченных платформой (platform_commissions), и другие ключевые показатели для трех видео, которые занимают первые места по общему количеству views за указанный диапазон дат. Примечание. Вы не можете использовать account_id в условии WHERE MCQL для фильтрации результатов.
Как посмотреть, с какими отмеченными товарами зрители взаимодействуют чаще всего
Чтобы узнать, какие отмеченные товары имеют наибольшую вовлеченность и продажи, вы можете запросить youtube_product_tagged_stats_view.
В этом представлении показатели агрегируются по отдельным отмеченным товарам, включая их названия и идентификаторы предложений.
Ниже приведен пример запроса MCQL SELECT, который можно использовать, чтобы получить 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_category_tagged_stats_view.
В этом представлении показатели агрегируются по категориям товаров (product_type) в вашей таксономии товаров, включая количество отдельных авторов и видео, в которых отмечены товары в каждой категории.
Используйте следующий оператор MCQL SELECT, чтобы получить 10 самых популярных категорий товаров, ранжированных по валовому объему продаж на 1 сентября 2026 г.:
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
Этот запрос возвращает категорию товара (product_type), количество авторов, отметивших товар, количество видео, в которых отмечен товар, и ключевые показатели эффективности для 10 основных категорий товаров, упорядоченных по gross_sales на указанную дату.
Посмотреть самые продаваемые товары
Чтобы узнать, какие товары продаются лучше всего, можно запросить 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 самых популярных товаров, упорядоченных по валовому объему продаж за указанный диапазон дат.
Просмотр эффективности всех кампаний
Чтобы узнать, насколько эффективны ваши партнерские кампании в целом, отправьте запрос к ресурсу youtube_campaigns_stats_view.
В этом представлении собраны показатели по всем кампаниям, включая названия кампаний, даты начала и окончания, количество активных авторов, а также показатели продаж и вовлеченности.
Чтобы получить список из 10 кампаний, которые принесли больше всего заказов 23 апреля 2026 г., используйте следующий запрос MCQL SELECT:
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
Этот запрос возвращает идентификатор кампании, название кампании, диапазон дат, количество активных авторов и ключевые показатели эффективности для 10 лучших кампаний, ранжированных по общему количеству orders на указанную дату.
Как посмотреть эффективность кампании по авторам
Чтобы проанализировать эффективность отдельных авторов, участвующих в определенной кампании, отправьте запрос к ресурсу youtube_individual_campaign_stats_view.
В этом представлении агрегируются показатели по авторам в рамках кампании, включая названия каналов, количество видео и названия отмеченных товаров.
Чтобы получить список из 10 авторов, набравших больше всего просмотров в рамках определенной кампании 23 апреля 2026 г., используйте следующий запрос MCQL SELECT:
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.
В этом представлении приводятся показатели эффективности на уровне видео для автора в кампании, включая названия видео, форматы видео и отмеченные товары.
Чтобы получить список из 10 самых популярных видео определенного автора и кампании за 20 мая 2026 г., используйте следующий запрос MCQL SELECT:
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
Этот запрос позволяет получить название видео, формат видео (content_type), названия отмеченных товаров и ключевые показатели эффективности для 10 лучших видео, ранжированных по общему количеству views для указанного канала автора, кампании и даты.
Как посмотреть эффективность кампании по товарам
Чтобы узнать, насколько эффективны отдельные товары в кампании, отправьте запрос к ресурсу youtube_campaign_products_stats_view.
В этом представлении содержатся показатели эффективности на уровне товара в рамках кампании, включая названия товаров, сведения о связанных видео и показатели продаж.
Чтобы получить список из 10 товаров с наибольшим количеством просмотров в определенной кампании за 20 июня 2026 г., используйте следующий запрос MCQL SELECT:
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
Этот запрос позволяет получить название канала автора, название товара, название видео, URL видео и ключевые показатели эффективности для 10 товаров, у которых больше всего views в рамках указанной кампании и даты.
Важные примечания
- Даты. Всегда фильтруйте запросы по параметру
date, используя операторWHERE, чтобы указать отчетный период. Даты указываются в формате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.
- Задержка. Задержка запросов зависит от объема запрашиваемых данных. Запросы, охватывающие большие наборы данных, выполняются дольше и могут привести к тайм-аутам.