Analyze Youtube Affiliate Performance (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 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 et produits individuels.

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 des 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

Notez que, comme il s'agit d'une version alpha publique, le point de terminaison est différent. Pour récupérer les données de performances des affiliés YouTube, vous devez envoyer la requête POST au point de terminaison v1alpha. Voici un exemple de requête :

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

  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' \
  --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 performances pour les trois premiers créateurs classés selon la métrique "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 dans la plage de dates 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 produits les plus vendus en termes de 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 ventes, les commissions et les métriques clés pour les 10 produits les plus commandés en fonction des ventes brutes, dans la plage de dates spécifiée.

Remarques importantes

• Dates : filtrez toujours vos requêtes par date à l'aide de clauses WHERE pour spécifier la période du rapport. Les dates sont au format YYYY-MM-DD.
• 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.