Вы можете получить ключевые показатели эффективности для ваших продуктов, участвующих в партнерской программе YouTube, используя под-API «Отчетность». В этом руководстве объясняется, как запрашивать данные о партнерских программах YouTube, такие как продажи, комиссионные, заказы, просмотры и клики, относящиеся к различным авторам, видеоконтенту, отдельным продуктам и целевым кампаниям.
Вы можете использовать язык запросов Merchant Center (MCQL) для выбора метрик и параметров из специальных представлений партнерской программы YouTube, которые функционируют как таблицы в ваших запросах.
Предварительные требования
Перед использованием данного руководства убедитесь в следующем:
- Учетная запись, используемая для аутентификации вызовов API, имеет роль « Производительность и аналитика» , которая предоставляет доступ к показателям производительности.
- Ваш аккаунт Google Merchant Center участвует в партнерской программе YouTube .
Запрос к конечной точке alpha
Поскольку эта функция находится в стадии публичной альфа-версии, конечная точка отличается. Для получения данных о производительности партнерской программы 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, который можно использовать для получения списка 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 самых популярных товаров, отсортированных по валовым продажам, в указанном диапазоне дат.
Просмотрите показатели эффективности по всем кампаниям.
Чтобы понять, насколько эффективно работают ваши партнерские кампании в целом, воспользуйтесь запросом к представлению youtube_campaigns_stats_view . Это представление объединяет показатели по всем кампаниям, включая названия кампаний, даты начала и окончания, количество активных авторов, а также показатели продаж и вовлеченности.
Используйте следующий запрос MCQL SELECT , чтобы получить 10 самых популярных кампаний по количеству заказов на 23 апреля 2026 года :
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 . Это представление агрегирует показатели по каждому автору в рамках кампании, включая названия каналов, количество видео и названия товаров с тегами.
Используйте следующий запрос MCQL SELECT , чтобы получить список из 10 авторов, набравших наибольшее количество просмотров в рамках конкретной кампании 23 апреля 2026 года :
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 . Это представление предоставляет метрики эффективности на уровне отдельных видеороликов для автора в кампании, включая названия видео, форматы видео и помеченные товары.
Используйте следующий запрос MCQL SELECT , чтобы получить 10 видеороликов с наибольшим количеством просмотров для конкретного автора и кампании 20 мая 2026 года :
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 . Это представление предоставляет показатели эффективности на уровне товаров в рамках кампании, включая названия товаров, сведения о связанных видеороликах и показатели продаж.
Используйте следующий запрос MCQL SELECT , чтобы получить 10 товаров с наибольшим количеством просмотров для конкретной кампании 20 июня 2026 года :
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_idanddate. -
youtube_campaign_videos_stats_view:campaign_id,channel_idиdate. -
youtube_campaign_products_stats_view:campaign_idanddate.
-
- Задержка : Задержка запросов зависит от объема запрашиваемых данных. Запросы, охватывающие большие наборы данных, занимают больше времени и могут привести к таймаутам.