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

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 d'affiliation YouTube, vous devez envoyer la requête POST au v1alpha point de terminaison. 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 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 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 créateurs les plus performants classés par la métrique des ventes 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 le 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 performantes en termes de vues entre le 1er et le 2 mai 2025, transmettez l'instruction de langage de requête Merchant Center suivante à la méthode accounts.reports.search :

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 de la vidéo, l'ID de la vidéo et les métriques clés pour les trois vidéos les plus performantes classées par le nombre total de views 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 d'attente.