Вы можете получать ключевые показатели эффективности товаров, участвующих в партнерской программе YouTube Покупок, с помощью вложенного 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, включая названия каналов и идентификаторы каналов.
Вот пример запроса MCQL SELECT, с помощью которого можно получить информацию о трех авторах с самыми высокими показателями продаж с 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.
- Задержка. Задержка запросов зависит от объема запрашиваемых данных. Запросы, охватывающие большие наборы данных, выполняются дольше и могут привести к тайм-аутам.