Analyze YouTube Affiliate Performance (Alpha)

Puoi recuperare le metriche di rendimento chiave per i tuoi prodotti che partecipano al programma di affiliazione di YouTube utilizzando l'API Reports. Questa guida spiega come eseguire query sui dati di affiliazione specifici di YouTube , come vendite, commissioni, ordini, visualizzazioni e clic , attribuiti a diversi creator, contenuti video e singoli prodotti.

Puoi utilizzare MCQL per selezionare metriche e dimensioni dalle "visualizzazioni" di affiliazione di YouTube dedicate, che funzionano come tabelle nelle query.

Prerequisiti

Prima di utilizzare questa guida, assicurati che:

Eseguire una query sull'endpoint alpha

Tieni presente che, trattandosi di una versione alpha pubblica, l'endpoint è diverso. Per recuperare i dati sul rendimento degli affiliati di YouTube, devi inviare la richiesta POST all' v1alpha endpoint. Ecco una richiesta di esempio:

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

Esaminare il rendimento per creator

Per capire quali creator di YouTube generano il maggior numero di interazioni e vendite, puoi eseguire una query su youtube_creator_performance_view. Questa visualizzazione aggrega le metriche in base ai singoli creator di YouTube e include i titoli dei creator e gli ID dei canali.

Di seguito è riportato un esempio di istruzione SELECT MCQL che puoi utilizzare per ottenere i 3 creator con il rendimento migliore in base alle vendite tra il 1° e il 2 maggio 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

Questa query recupera il titolo del creator, l'ID canale e le metriche di rendimento chiave per i 3 creator principali classificati in base alla metrica delle vendite nell'intervallo di date specificato.

Esaminare il rendimento per contenuti

Per vedere quali video di YouTube specifici hanno il rendimento migliore, puoi eseguire una query su youtube_content_performance_view. Questa visualizzazione aggrega le metriche in base ai singoli video di YouTube e include i titoli e gli ID dei video.

Per recuperare i 3 video principali in base alle visualizzazioni tra il 1° e il 2 maggio 2025, trasmetti la seguente istruzione di Merchant Center Query Language al accounts.reports.search metodo:

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

Questa query recupera il titolo del video, l'ID del video e le metriche chiave per i 3 video principali classificati in base al numero totale di views nell'intervallo di date specificato.

Considerazioni importanti

  • Date: filtra sempre le query in base a date utilizzando le clausole WHERE per specificare il periodo di generazione dei report. Le date sono nel formato YYYY-MM-DD.
  • Latenza: la latenza delle query dipende dal volume di dati richiesto. Le query di grandi dimensioni richiedono più tempo e potrebbero causare timeout.