Analizzare il rendimento degli affiliati di YouTube (alpha)

Puoi recuperare le metriche sul rendimento chiave per i tuoi 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, singoli prodotti, categorie di prodotti e campagne target.

L'utilizzo delle API del programma di affiliazione di YouTube e dei dati associati deve essere conforme alle norme per gli sviluppatori di YouTube Shopping.

Puoi utilizzare Merchant Center Query Language (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 query sull'endpoint alpha

Poiché questa funzionalità è in versione alpha pubblica, l'endpoint è diverso. Per recuperare i dati sul rendimento dell'affiliazione di YouTube, devi inviare la richiesta POST all'endpoint v1alpha. Per saperne di più sul recupero dei report, consulta accounts.reports.search. Ecco una richiesta di esempio:

HTTP

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

{
  "query": "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"
}

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' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "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"
  }' \
  --compressed

Visualizzare il rendimento per creator

Per capire quali creator di YouTube generano il maggior coinvolgimento e le maggiori vendite, puoi eseguire una query su youtube_creator_performance_view. Questa visualizzazione aggrega le metriche per i singoli creator di YouTube e include i titoli dei creator e gli ID canale.

Di seguito è riportato un esempio di istruzione MCQL SELECT 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 sul rendimento chiave per i 3 creator con il rendimento migliore in base alla metrica delle vendite lorde nell'intervallo di date specificato.

Visualizzare il rendimento per contenuti

Per vedere quali video specifici di YouTube hanno il rendimento migliore, puoi eseguire una query su the youtube_content_performance_view. Questa visualizzazione aggrega le metriche per i singoli video di YouTube e include i titoli e gli ID dei video. Per i marketplace, includi account_id per suddividere il rendimento in base ai singoli account dei sub-venditori. Per visualizzare gli importi delle commissioni finanziate dai sub-venditori e dalla piattaforma del marketplace, includi seller_commissions e platform_commissions.

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,
  account_id,
  gross_sales,
  net_sales,
  commissions,
  seller_commissions,
  platform_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, l'ID dell'account del sub-venditore (account_id), le commissioni totali (commissions), le commissioni finanziate dal venditore (seller_commissions), le commissioni finanziate dalla piattaforma (platform_commissions) e altre metriche chiave per i 3 video con il rendimento migliore in base al numero totale di views nell'intervallo di date specificato. Nota: non puoi utilizzare account_id nella clausola MCQL WHERE per filtrare i risultati.

Visualizzare i prodotti taggati con il maggior coinvolgimento

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

Di seguito è riportato un esempio di istruzione MCQL SELECT 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 il rendimento per categoria di prodotti taggati

Per capire quali categorie di prodotti taggati generano il maggior coinvolgimento e le maggiori vendite, esegui una query su youtube_product_category_tagged_stats_view. Questa visualizzazione aggrega le metriche per categoria di prodotti (product_type) nella tassonomia dei prodotti, incluso il numero di creator e video distinti che hanno taggato i prodotti in ogni categoria.

Utilizza la seguente istruzione MCQL SELECT per ottenere le 10 categorie di prodotti taggati con il rendimento migliore in base alle vendite lorde il 1° settembre 2026: 

SELECT
  product_type,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_category_tagged_stats_view
WHERE date = '2026-09-01'
ORDER BY gross_sales DESC
LIMIT 10

Questa query recupera la categoria di prodotti (product_type), il conteggio dei creator taggati, il conteggio dei video taggati e le metriche sul rendimento chiave per le 10 categorie di prodotti con il rendimento migliore in base a gross_sales nella data specificata.

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 MCQL SELECT 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.

Visualizzare il rendimento di tutte le campagne

Per capire il rendimento complessivo delle tue campagne di affiliazione, esegui una query su youtube_campaigns_stats_view. Questa visualizzazione aggrega le metriche di tutte le campagne, inclusi i nomi delle campagne , le date di inizio e fine, il conteggio dei creator attivi e le metriche sulle vendite e sul coinvolgimento.

Utilizza la seguente istruzione MCQL SELECT per ottenere le 10 campagne con il rendimento migliore in base agli ordini il 23 aprile 2026: 

SELECT
  campaign_id,
  campaign_name,
  start_date,
  end_date,
  active_creators,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaigns_stats_view
WHERE date = '2026-04-23'
ORDER BY orders DESC LIMIT 10

Questa query recupera l'ID campagna, il nome della campagna, l'intervallo di date, il conteggio dei creator attivi e le metriche sul rendimento chiave per le 10 campagne con il rendimento migliore in base al numero totale di orders nella data specificata.

Visualizzare il rendimento delle campagne per creator

Per analizzare il rendimento dei singoli creator che partecipano a una campagna specifica, esegui una query su youtube_individual_campaign_stats_view. Questa visualizzazione aggrega le metriche per creator all'interno di una campagna, inclusi i titoli dei canali, il conteggio dei video e i titoli dei prodotti taggati.

Utilizza la seguente istruzione MCQL SELECT per ottenere i 10 creator con il rendimento migliore in base alle visualizzazioni per una campagna specifica il 23 aprile 2026: 

SELECT
  channel_title,
  video_count,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_individual_campaign_stats_view
WHERE date = '2026-04-23'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10

Questa query recupera il titolo del canale del creator, il conteggio dei video, i titoli dei prodotti e le metriche sul rendimento chiave per i 10 creator con il rendimento migliore in base alle visualizzazioni totali nella campagna e nella data specificate.

Visualizzare il rendimento delle campagne per video

Per vedere il rendimento di video specifici dei creator all'interno di una campagna, esegui una query su youtube_campaign_videos_stats_view. Questa visualizzazione fornisce metriche sul rendimento a livello di video per un creator in una campagna, inclusi i titoli dei video, i formati dei video e i prodotti taggati.

Utilizza la seguente istruzione MCQL SELECT per ottenere i 10 video con il rendimento migliore in base alle visualizzazioni per un creator e una campagna specifici il 20 maggio 2026: 

SELECT
  video_title,
  content_type,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_videos_stats_view
WHERE date = '2026-05-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
  AND channel_id = 'YOUR_CHANNEL_ID'
ORDER BY views DESC LIMIT 10

Questa query recupera il titolo del video, il formato del video (content_type), i titoli dei prodotti taggati e le metriche sul rendimento chiave per i 10 video con il rendimento migliore in base al numero totale di views per il canale del creator, la campagna e la data specificati.

Visualizzare il rendimento delle campagne per prodotto

Per capire il rendimento dei singoli prodotti all'interno di una campagna, esegui una query su youtube_campaign_products_stats_view. Questa visualizzazione fornisce metriche sul rendimento a livello di prodotto all'interno di una campagna, inclusi i titoli dei prodotti, i dettagli dei video associati e le metriche sulle vendite.

Utilizza la seguente istruzione MCQL SELECT per ottenere i 10 prodotti con il rendimento migliore in base alle visualizzazioni per una campagna specifica il 20 giugno 2026: 

SELECT
  channel_title,
  product_title,
  video_title,
  video_url,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_products_stats_view
WHERE date = '2026-06-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10

Questa query recupera il titolo del canale del creator, il titolo del prodotto, il titolo del video, l'URL del video e le metriche sul rendimento chiave per i 10 prodotti con il rendimento migliore in base al numero totale di views nella campagna e nella data specificate.

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.
  • Filtri obbligatori: alcune visualizzazioni delle campagne richiedono filtri aggiuntivi nella clausola WHERE:
    • youtube_individual_campaign_stats_view: campaign_id e date.
    • youtube_campaign_videos_stats_view: campaign_id, channel_id e date.
    • youtube_campaign_products_stats_view: campaign_id e date.
  • 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.
Indietro
Explore your competitive landscape
Avanti
Analyze UCP agentic performance (Alpha)