Vous pouvez récupérer les métriques de performances clés pour vos produits participant au programme d'affiliation YouTube à l'aide de la sous-API Reporting. Ce guide explique comment interroger les données d'affiliation spécifiques à YouTube, telles que les ventes, les commissions, les commandes, les vues et les clics, attribuées à différents créateurs, contenus vidéo, produits individuels, catégories de produits et campagnes ciblées.
Votre utilisation des API du programme d'affiliation YouTube et des données associées doit respecter les Règles pour les développeurs YouTube Shopping.
Vous pouvez utiliser le langage de requête Merchant Center (MCQL) pour sélectionner des métriques et des dimensions à partir de vues dédiées à l'affiliation YouTube, qui fonctionnent comme des tables dans vos requêtes.
Prérequis
Avant d'utiliser ce guide, vérifiez les points suivants :
- Le compte utilisé pour authentifier les appels d'API dispose du rôle Performances et insights, qui permet d'accéder aux métriques de performances.
- Votre compte Google Merchant Center participe au programme d'affiliation YouTube.
Interroger le point de terminaison alpha
Comme cette fonctionnalité est en version alpha publique, le point de terminaison est différent. Pour récupérer les données sur les performances de l'affiliation YouTube, vous devez envoyer la requête POST au point de terminaison v1alpha. Pour en savoir plus sur la récupération des rapports, consultez accounts.reports.search.
Voici un exemple de requête :
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
Voir les performances par créateur
Pour savoir quels créateurs YouTube génèrent le plus d'engagement et de ventes, vous pouvez interroger la vue youtube_creator_performance_view.
Cette vue regroupe les métriques par créateur YouTube et inclut les titres des créateurs et les ID des chaînes.
Voici un exemple d'instruction MCQL SELECT que vous pouvez utiliser pour obtenir les trois créateurs les plus performants en termes de ventes entre le 1er et le 2 mai 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
Cette requête récupère le titre du créateur, l'ID de la chaîne et les métriques de performances clés des trois premiers créateurs classés selon la métrique des ventes brutes au cours de la période spécifiée.
Afficher les performances par contenu
Pour savoir quelles vidéos YouTube sont les plus performantes, vous pouvez interroger la vue youtube_content_performance_view.
Cette vue regroupe les métriques par vidéo YouTube et inclut les titres et les ID des vidéos. Pour les places de marché, incluez account_id pour ventiler les performances par sous-compte de vendeur. Pour afficher les montants des commissions financés par les sous-vendeurs et la plate-forme de place de marché, incluez seller_commissions et platform_commissions.
Pour récupérer les trois vidéos les plus vues entre le 1er et le 2 mai 2025, transmettez l'instruction MCQL suivante à la méthode accounts.reports.search :
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
Cette requête récupère le titre de la vidéo, l'ID de la vidéo, l'ID du compte du sous-vendeur (account_id), le total des commissions (commissions), les commissions financées par le vendeur (seller_commissions), les commissions financées par la plate-forme (platform_commissions) et d'autres métriques clés pour les trois vidéos les mieux classées en fonction du nombre total de views au cours de la période spécifiée. Remarque : Vous ne pouvez pas utiliser account_id dans la clause WHERE de MCQL pour filtrer les résultats.
Voir les produits tagués qui génèrent le plus d'engagement
Pour identifier les produits tagués qui génèrent le plus d'engagement et de ventes, vous pouvez interroger la vue youtube_product_tagged_stats_view.
Cette vue regroupe les métriques par produit tagué, y compris leurs titres et leurs ID d'offre.
Voici un exemple d'instruction MCQL SELECT que vous pouvez utiliser pour obtenir les 10 produits les plus consultés entre le 20 et le 21 janvier 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
Cette requête récupère les titres, le nombre de vidéos taguées et les métriques clés des 10 produits les plus populaires, classés par nombre total de views au cours de la période spécifiée.
Afficher les performances par catégorie de produits tagués
Pour identifier les catégories de produits tagués qui génèrent le plus d'engagement et de ventes, interrogez la vue youtube_product_category_tagged_stats_view.
Cette vue regroupe les métriques par catégorie de produits (product_type) dans votre classification des produits, y compris le nombre de créateurs et de vidéos distincts ayant tagué des produits dans chaque catégorie.
Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 catégories de produits tagués les plus populaires, classées par ventes brutes, le 1er septembre 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
Cette requête récupère la catégorie de produits (product_type), le nombre de créateurs tagués, le nombre de vidéos taguées et les métriques de performances clés pour les 10 premières catégories de produits classées par gross_sales à la date spécifiée.
Afficher les produits les plus vendus
Pour identifier les produits qui enregistrent le plus de ventes, vous pouvez interroger la vue youtube_product_sold_stats_view.
Voici un exemple d'instruction MCQL SELECT que vous pouvez utiliser pour obtenir les 10 produits les plus vendus en termes de ventes brutes entre le 20 et le 21 janvier 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
Cette requête récupère les données de ventes, les commissions et les métriques clés pour les 10 produits les plus commandés en fonction des ventes brutes, sur la période spécifiée.
Consultez les performances de toutes vos campagnes
Pour comprendre les performances globales de vos campagnes d'affiliation, interrogez youtube_campaigns_stats_view.
Cette vue regroupe les métriques de toutes les campagnes, y compris les noms des campagnes, les dates de début et de fin, le nombre de créateurs actifs, ainsi que les métriques de ventes et d'engagement.
Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 campagnes ayant généré le plus de commandes le 23 avril 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
Cette requête récupère l'ID de campagne, le nom de la campagne, la plage de dates, le nombre de créateurs actifs et les métriques de performances clés pour les 10 premières campagnes classées par nombre total de orders à la date spécifiée.
Consulter les performances de la campagne par créateur
Pour analyser les performances des créateurs participant à une campagne spécifique, interrogez youtube_individual_campaign_stats_view.
Cette vue regroupe les métriques par créateur au sein d'une campagne, y compris les titres des chaînes, le nombre de vidéos et les titres des produits tagués.
Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 créateurs ayant enregistré le plus de vues pour une campagne spécifique le 23 avril 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
Cette requête récupère le titre de la chaîne du créateur, le nombre de vidéos, les titres des produits et les métriques de performances clés pour les 10 meilleurs créateurs classés par nombre total de vues pour la campagne et la date spécifiées.
Consulter les performances de la campagne par vidéo
Pour voir les performances de vidéos de créateurs spécifiques dans une campagne, interrogez youtube_campaign_videos_stats_view.
Cette vue fournit des métriques de performances au niveau de la vidéo pour un créateur dans une campagne, y compris les titres des vidéos, les formats vidéo et les produits tagués.
Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 vidéos les plus vues pour un créateur et une campagne spécifiques le 20 mai 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
Cette requête récupère le titre de la vidéo, le format de la vidéo (content_type), les titres des produits tagués et les métriques de performances clés pour les 10 premières vidéos classées par nombre total de views pour la chaîne du créateur, la campagne et la date spécifiées.
Consulter les performances de la campagne par produit
Pour comprendre les performances de chaque produit dans une campagne, interrogez youtube_campaign_products_stats_view.
Cette vue fournit des métriques de performances au niveau du produit dans une campagne, y compris les titres des produits, les détails des vidéos associées et les métriques de ventes.
Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 produits les plus vus pour une campagne spécifique le 20 juin 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
Cette requête récupère le titre de la chaîne du créateur, le titre du produit, le titre de la vidéo, l'URL de la vidéo et les métriques de performances clés pour les 10 produits les plus performants, classés par nombre total de views dans la campagne et la date spécifiées.
Remarques importantes
- Dates : filtrez toujours vos requêtes par
dateà l'aide de clausesWHEREpour spécifier la période de référence. Les dates sont au formatYYYY-MM-DD. - Filtres obligatoires : certaines vues de campagne nécessitent des filtres supplémentaires dans la clause
WHERE:youtube_individual_campaign_stats_view:campaign_idetdate.youtube_campaign_videos_stats_view:campaign_id,channel_idetdate.youtube_campaign_products_stats_view:campaign_idetdate.
- Latence : la latence des requêtes dépend du volume de données demandé. Les requêtes qui couvrent de grands ensembles de données prennent plus de temps et peuvent entraîner des délais d'expiration.