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 l'API Reports. 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 MCQL pour sélectionner des métriques et des dimensions à partir des "vues" dédiées aux affiliés YouTube, qui fonctionnent comme des tables dans vos requêtes.

Prérequis

Avant d'utiliser ce guide, assurez-vous des points suivants :

Interroger le point de terminaison alpha

Notez que le point de terminaison diffère, car il s'agit d'une version alpha publique. 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 :

HTTP

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

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' \
  --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,
  sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY 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 premiers créateurs classés selon la métrique "Ventes" dans la plage de dates 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 regroupe les métriques par vidéo YouTube individuelle et inclut les titres et les ID des vidéos.

Voici un exemple d'instruction MCQL SELECT que vous pouvez utiliser pour obtenir les trois vidéos les plus vues entre le 1er et le 2 mai 2025.

SELECT
  title,
  video_id,
  views,
  clicks,
  sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '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.

Afficher les performances par produit

Pour analyser les performances de produits individuels dans le programme d'affiliation YouTube, vous pouvez interroger youtube_product_performance_view. Cette vue agrège les métriques par produit et inclut les titres des produits et les ID d'offre.

Voici un exemple d'instruction SELECT MCQL que vous pouvez utiliser pour trouver les trois meilleurs produits en termes de montant des ventes entre le 1er mai et le 2 mai 2025 :

SELECT
  title,
  offer_id,
  sales,
  commissions,
  orders,
  clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3

Cette requête renvoie le titre du produit, l'ID de l'offre et les métriques de performances pour les trois meilleurs produits, classés par métrique sales, 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 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 volumineuses prennent plus de temps et peuvent entraîner des délais avant expiration.