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 tue query.

Prerequisiti

Prima di utilizzare questa guida, assicurati che:

Esegui 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 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 tre 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 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 tre video in base al numero totale di views nell'intervallo di date specificato.

Visualizzare il rendimento per prodotto

Per analizzare il rendimento dei singoli prodotti all'interno del programma di affiliazione di YouTube, puoi eseguire query su youtube_product_performance_view. Questa visualizzazione aggrega le metriche per prodotto e include i titoli dei prodotti e gli ID offerta.

Ecco un esempio di istruzione MCQL SELECT che puoi utilizzare per trovare i primi 3 prodotti in base all'importo delle vendite tra il 1° e il 2 maggio 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

Questa query restituisce il titolo del prodotto, l'ID offerta e le metriche di rendimento per i primi tre prodotti, ordinati in base alla metrica sales, nel periodo 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.