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

• 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 sur les performances d'affiliation 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 savoir quels créateurs YouTube génèrent le plus d'engagement et de ventes, vous pouvez interroger la 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 chaîne.

Voici un exemple d'instruction MCQL SELECT que vous pouvez utiliser pour obtenir les trois meilleurs créateurs 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 en fonction de 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 la 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 meilleures vidéos en termes de vues entre le 1er et le 2 mai 2025, transmettez l'instruction MCQL suivante à la accounts.reports.search méthode :

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 de la vidéo, l'ID de la vidéo et les métriques clés pour les trois meilleures vidéos classées en fonction du nombre total de views au cours de la période spécifiée.

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 la 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 en termes de 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 en fonction du nombre total de views au cours de la période spécifiée.

Afficher les produits les plus vendus

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

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

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.
• 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.