Analyze Youtube Affiliate Performance (Alpha)

Puoi recuperare le metriche di rendimento chiave per i prodotti che partecipano al Programma di affiliazione di YouTube utilizzando la sotto-API Reporting. 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 il linguaggio di query di Merchant Center (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:

• L'account utilizzato per autenticare le chiamate API abbia il ruolo Rendimento e approfondimenti che concede l'accesso alle metriche di rendimento.
• Il tuo account Google Merchant Center partecipi al Programma di affiliazione di YouTube.

Eseguire query sull'endpoint alpha

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

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

  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 per 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,
  gross_sales,
  net_sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date >= '2025-05-01' AND date < '2025-05-02'
ORDER BY gross_sales DESC LIMIT 3

Questa query recupera il titolo del creator, l'ID canale e le metriche di rendimento chiave per i 3 creator con il rendimento migliore in base alla metrica delle vendite lorde 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 per singoli video di YouTube e include i titoli e gli ID dei video.

Per recuperare i 3 video con il rendimento migliore in base alle visualizzazioni tra il 1° e il 2 maggio 2025, trasmetti la seguente istruzione MCQL al accounts.reports.search metodo:

SELECT
  title,
  video_id,
  gross_sales,
  net_sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_content_performance_view
WHERE date >= '2025-05-01' AND date < '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 con il rendimento migliore in base al numero totale di views nell'intervallo di date specificato.

Visualizzare i prodotti taggati con il maggior numero di interazioni

Per capire quali prodotti taggati generano il maggior numero di interazioni e vendite, puoi eseguire una query su youtube_product_tagged_stats_view. Questa visualizzazione aggrega le metriche per singoli prodotti taggati, inclusi i relativi titoli e ID offerta.

Di seguito è riportato un esempio di istruzione SELECT MCQL che puoi utilizzare per ottenere i 10 prodotti con il rendimento migliore in base alle visualizzazioni tra il 20 e il 21 gennaio 2026:

SELECT
  title,
  offer_id,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_tagged_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY views DESC LIMIT 10

Questa query recupera i titoli, il conteggio dei video taggati e le metriche chiave per i 10 prodotti con il rendimento migliore in base al numero totale di views nell'intervallo di date specificato.

Visualizzare i prodotti più venduti

Per capire quali prodotti generano il maggior numero di vendite, puoi eseguire una query su youtube_product_sold_stats_view.

Di seguito è riportato un esempio di istruzione SELECT MCQL che puoi utilizzare per ottenere i 10 prodotti con il rendimento migliore in base alle vendite lorde tra il 20 e il 21 gennaio 2026:

SELECT
  title,
  offer_id,
  gross_sales,
  net_sales,
  commissions,
  orders
FROM youtube_product_sold_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY gross_sales DESC LIMIT 10

Questa query recupera i dati sulle vendite, le commissioni e le metriche chiave per i 10 prodotti con il rendimento migliore in base alle vendite lorde, 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 che riguardano set di dati di grandi dimensioni richiedono più tempo e potrebbero causare timeout.