Analizzare il rendimento degli affiliati di YouTube (alpha)

Puoi recuperare le metriche sul rendimento principali per i tuoi prodotti che partecipano al programma di affiliazione di YouTube utilizzando la sub-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 dedicate del programma di affiliazione di YouTube, che funzionano come tabelle nelle query.

Prerequisiti

Prima di utilizzare questa guida, assicurati che:

Esegui una query sull'endpoint alpha

Poiché questa funzionalità è in 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. 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

Visualizza 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 canale.

Ecco 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° maggio 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 principali per i primi 3 creator classificati in base alla metrica delle vendite lorde nell'intervallo di date specificato.

Visualizza 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 i marketplace, includi account_id per suddividere il rendimento in base ai singoli account dei sub-venditori. Per visualizzare gli importi delle commissioni finanziati dai sub-venditori e dalla piattaforma del marketplace, includi seller_commissions e platform_commissions.

Per recuperare i primi 3 video per visualizzazioni tra il 1° e il 2 maggio 2025, passa la seguente istruzione MCQL al metodo accounts.reports.search: 

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 video, l'ID 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 primi 3 video classificati in base al numero totale di views nell'intervallo di date specificato. Nota: non puoi utilizzare account_id nella clausola WHERE di MCQL per filtrare i risultati.

Visualizza i prodotti taggati con il maggior coinvolgimento

Per capire quali prodotti taggati hanno il maggior coinvolgimento e le maggiori vendite, puoi eseguire una query su youtube_product_tagged_stats_view. Questa visualizzazione aggrega le metriche in base ai singoli prodotti taggati, inclusi i relativi titoli e ID offerta.

Ecco un esempio di istruzione SELECT MCQL che puoi utilizzare per ottenere i primi 10 prodotti per 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 numero di video taggati e le metriche chiave per i primi 10 prodotti classificati in base al numero totale di views nell'intervallo di date specificato.

Visualizza il rendimento per categoria di prodotto taggato

Per capire quali categorie di prodotti taggati generano il maggior numero di interazioni e vendite, esegui una query su youtube_product_category_tagged_stats_view. Questa visualizzazione aggrega le metriche per categoria di prodotto (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 principali categorie di prodotti taggati classificate 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 prodotto (product_type), il numero di creator taggati, il numero di video taggati e le metriche sul rendimento principali per le prime 10 categorie di prodotto classificate in base a gross_sales nella data specificata.

Visualizza i prodotti più venduti

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

Ecco un esempio di istruzione MCQL SELECT che puoi utilizzare per ottenere i primi 10 prodotti classificati 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 di vendita, le commissioni e le metriche chiave per i primi 10 prodotti ordinati in base alle vendite lorde nell'intervallo di date specificato.

Visualizza il rendimento di tutte le campagne

Per comprendere 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 di fine, il numero di creator attivi e le metriche relative alle vendite e al coinvolgimento.

Utilizza la seguente istruzione MCQL SELECT per ottenere le prime 10 campagne per 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 numero di creator attivi e le metriche sul rendimento principali per le prime 10 campagne classificate in base al numero totale di orders nella data specificata.

Visualizza il rendimento della campagna 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, i conteggi dei video e i titoli dei prodotti taggati.

Utilizza la seguente istruzione MCQL SELECT per ottenere i 10 creator principali per 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 numero di video, i titoli dei prodotti e le metriche sul rendimento principali per i primi 10 creator classificati in base alle visualizzazioni totali all'interno della campagna e della data specificate.

Visualizza il rendimento della campagna per video

Per vedere il rendimento di video di creator specifici 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 titoli dei video, formati dei video e prodotti taggati.

Utilizza la seguente istruzione MCQL SELECT per ottenere i 10 video principali per 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 principali per i primi 10 video classificati in base al numero totale di views per il canale del creator, la campagna e la data specificati.

Visualizza il rendimento della campagna 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, tra cui i titoli dei prodotti, i dettagli dei video associati e le metriche sulle vendite.

Utilizza la seguente istruzione MCQL SELECT per ottenere i primi 10 prodotti per 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 principali per i primi 10 prodotti classificati in base al numero totale di views all'interno della campagna e della data specificate.

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.
  • 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 richiesti. Le query che coprono set di dati di grandi dimensioni richiedono più tempo e potrebbero causare timeout.
Indietro
Explore your competitive landscape
Avanti
Analyze UCP agentic performance (Alpha)