Analyser les performances de vos contenus affiliés YouTube (alpha)

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, catégories de produits et campagnes ciblées.

Votre utilisation des API du programme d'affiliation YouTube et des données associées doit être conforme aux Règles pour les développeurs YouTube Shopping.

Vous pouvez utiliser le langage MCQL (Merchant Center Query Language) pour sélectionner des métriques et des dimensions dans des vues d'affiliation YouTube dédiées, qui fonctionnent comme des tables dans vos requêtes.

Prérequis

Avant d'utiliser ce guide, assurez-vous que :

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 d'affiliation YouTube, vous devez envoyer la requête POST au point de terminaison v1alpha. Pour en savoir plus sur la récupération de 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 savoir quels créateurs YouTube génèrent le plus d'engagement et de ventes, vous pouvez interroger youtube_creator_performance_view. Cette vue agrège les métriques par créateur YouTube individuel et inclut les titres des créateurs et les ID de la 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 de performances clés pour les trois meilleurs créateurs classés par la métrique des ventes brutes au cours de la période spécifiée.

Afficher les performances par contenu

Pour voir quelles vidéos YouTube spécifiques sont les plus performantes, vous pouvez interroger the 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 les places de marché, incluez account_id pour répartir les performances par compte de sous-vendeur individuel. Pour afficher les montants des commissions financées par les sous-vendeurs et la plate-forme de la place de marché, incluez seller_commissions et platform_commissions.

Pour récupérer les trois meilleures vidéos par vues entre le 1er et le 2 mai 2025, transmettez l'instruction MCQL suivante à la accounts.reports.search méthode : 

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 de 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 meilleures vidéos classées par le nombre total de views au cours de la période spécifiée. Remarque : Vous ne pouvez pas utiliser account_id dans la clause MCQL WHERE pour filtrer les résultats.

Afficher les produits tagués avec le plus d'engagement

Pour savoir quels produits tagués génèrent le plus d'engagement et de ventes, vous pouvez interroger les youtube_product_tagged_stats_view. Cette vue agrège les métriques par produit tagué individuel, y compris leurs titres et leurs ID d'offre.

Voici un exemple d'instruction MCQL SELECT que vous pouvez utiliser pour obtenir les 10 meilleurs produits par vues 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 meilleurs produits classés par le nombre total de views au cours de la période spécifiée.

Afficher les performances par catégorie de produits tagués

Pour savoir quelles catégories de produits tagués génèrent le plus d'engagement et de ventes, interrogez youtube_product_category_tagged_stats_view. Cette vue agrège 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 qui ont tagué des produits dans chaque catégorie.

Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 meilleures catégories de produits tagués 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 meilleures catégories de produits classées par gross_sales à la date spécifiée.

Afficher les produits les plus vendus

Pour savoir quels produits génèrent le plus de ventes, vous pouvez interroger le youtube_product_sold_stats_view.

Voici un exemple d'instruction MCQL SELECT que vous pouvez utiliser pour obtenir les 10 meilleurs produits classés par 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 meilleurs produits classés par ventes brutes au cours de la période spécifiée.

Afficher les performances de toutes les campagnes

Pour savoir comment vos campagnes d'affiliation fonctionnent globalement, interrogez les 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 de ventes et d'engagement.

Utilisez l'instruction MCQL SELECT suivante pour obtenir les 10 meilleures campagnes par 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 période, le nombre de créateurs actifs et les métriques de performance clés pour les 10 meilleures campagnes classées par le nombre total de orders à la date spécifiée.

Afficher les performances des campagnes par créateur

Pour analyser les performances des créateurs individuels participant à une campagne spécifique, interrogez le youtube_individual_campaign_stats_view. Cette vue agrège 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 meilleurs créateurs par 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 le nombre total de vues au sein de la campagne et à la date spécifiées.

Afficher les performances des campagnes par vidéo

Pour voir comment les vidéos de créateurs spécifiques fonctionnent au sein d'une campagne, interrogez the 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 meilleures 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 de performances clés pour les 10 meilleures vidéos classées par le nombre total de views pour la chaîne du créateur, la campagne et la date spécifiées.

Afficher les performances des campagnes par produit

Pour savoir comment les produits individuels fonctionnent au sein d'une campagne, interrogez les youtube_campaign_products_stats_view. Cette vue fournit des métriques de performances au niveau du produit au sein d'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 meilleurs produits par vues 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 meilleurs produits classés par le nombre total de views au sein de la campagne et à la date spécifiées.

Remarques importantes

  • Dates : filtrez toujours vos requêtes par date à l'aide de clauses WHERE pour spécifier la période de référence. Les dates sont au format YYYY-MM-DD.
  • Filtres obligatoires : certaines vues de campagne nécessitent des filtres supplémentaires dans la clause WHERE :
    • youtube_individual_campaign_stats_view : campaign_id et date.
    • youtube_campaign_videos_stats_view: campaign_id, channel_id et date.
    • youtube_campaign_products_stats_view : campaign_id et date.
  • 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'attente.
Précédent
Explore your competitive landscape
Suivant
Analyze UCP agentic performance (Alpha)