Vous pouvez récupérer les métriques de performances clés de vos produits participant au Programme d'affiliation YouTube à l'aide de la sous-API Reporting. Ce guide explique comment interroger des 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 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 affiliées YouTube dédiées, qui fonctionnent comme des tableaux dans vos requêtes.
Prérequis
Avant d'utiliser ce guide, assurez-vous que :
- 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
Étant donné que cette fonctionnalité est en version alpha publique, le point de terminaison est différent. Pour récupérer les données sur les performances des affiliés 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
Afficher les performances par créateur
Pour identifier les créateurs YouTube qui génèrent le plus d'engagement et de ventes, vous pouvez interroger youtube_creator_performance_view.
Cette vue regroupe les métriques par créateur YouTube individuel et inclut les titres des créateurs et les ID de chaîne.
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 clés de performance pour les 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 identifier les vidéos YouTube spécifiques qui enregistrent les meilleures performances, vous pouvez interroger youtube_content_performance_view.
Cette vue agrège les métriques par vidéo YouTube individuelle et inclut les titres et les ID des vidéos.
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, 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
Cette requête récupère le titre, l'ID et les métriques clés des trois vidéos les plus populaires, classées en fonction du nombre total de views au cours de la période spécifiée.
Voir les produits tagués ayant généré le plus d'engagement
Pour identifier les produits tagués qui génèrent le plus d'engagement et de ventes, vous pouvez interroger 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 pour les 10 premiers produits classés par nombre total de views au cours de la période spécifiée.
Afficher les produits les plus vendus
Pour identifier les produits qui génèrent le plus de ventes, vous pouvez interroger youtube_product_sold_stats_view.
Voici un exemple d'instruction MCQL SELECT que vous pouvez utiliser pour obtenir les 10 premiers produits classés par chiffre d'affaires brut 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 vente, les commissions et les métriques clés pour les 10 produits les plus commandés en termes de ventes brutes, au cours de la période spécifiée.
Afficher les performances de toutes les campagnes
Pour comprendre les performances globales de vos campagnes affiliées, interrogez youtube_campaigns_stats_view.
Cette vue agrège 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 sur les ventes et l'engagement.
Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 premières campagnes par nombre 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 performance pour les 10 premières campagnes classées en fonction du nombre total de orders à la date spécifiée.
Afficher les performances des campagnes par créateur
Pour analyser les performances de chaque créateur participant à une campagne spécifique, interrogez youtube_individual_campaign_stats_view.
Cette vue regroupe les métriques par créateur dans une campagne, y compris les titres de 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 les plus populaires en termes 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 premiers créateurs classés par nombre total de vues au cours de la campagne et de la période spécifiées.
Afficher les performances des campagnes par vidéo
Pour connaître 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 des vidéos pour un créateur dans une campagne, y compris les titres et les formats des vidéos, ainsi que les produits tagués.
Utilisez l'instruction MCQL SELECT suivante pour obtenir le top 10 des vidéos par 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 vidéo (content_type), les titres des produits tagués et les métriques clés sur les performances pour les 10 premières vidéos classées par nombre total de views pour la chaîne, la campagne et la date du créateur spécifiés.
Afficher les performances des campagnes 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 des produits dans une campagne, y compris les titres des produits, les détails des vidéos associées et les métriques de vente.
Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 produits les plus consultés 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 premiers produits 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 requis : 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.