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" dedicate di YouTube Affiliate, che funzionano come tabelle nelle query.

Prerequisiti

Prima di utilizzare questa guida, assicurati che:

• L'account utilizzato per autenticare le chiamate API dispone del ruolo Rendimento e approfondimenti che concede l'accesso alle metriche sul rendimento.
• Il tuo account Google Merchant Center partecipa al programma di affiliazione YouTube.

Nota: le visualizzazioni del rendimento degli affiliati di YouTube nell'API Merchant Reports sono in versione alpha. Le funzionalità sono soggette a modifica e potrebbero essere aggiornate o interrotte.

Esegui una query sull'endpoint alpha

Tieni presente che, trattandosi di una versione alpha pubblica, l'endpoint è diverso. Per recuperare i dati sul rendimento del programma di affiliazione di YouTube, devi inviare la richiesta POST all'endpoint v1alpha. 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

Visualizzare il rendimento per creator

Per capire quali creator di YouTube generano il maggior coinvolgimento e le maggiori vendite, puoi eseguire 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 canale.

Ecco un esempio di istruzione SELECT MCQL che puoi utilizzare per ottenere i primi tre creator 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 principali metriche di rendimento per i primi tre creator classificati in base alla metrica delle vendite nell'intervallo di date specificato.

Visualizzare 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 titoli e ID dei video.

Ecco un esempio di istruzione SELECT MCQL che puoi utilizzare per ottenere i primi 3 video per visualizzazioni tra il 1° e il 2 maggio 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

Questa query recupera il titolo, l'ID e le metriche chiave dei primi 3 video 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 del report. Le date sono nel formato YYYY-MM-DD.
• Latenza: la latenza delle query dipende dal volume di dati richiesti. Le query di grandi dimensioni richiedono più tempo e potrebbero causare timeout.