Analizzare il rendimento degli affiliati di YouTube (alpha)

Puoi recuperare le metriche principali sul rendimento dei tuoi prodotti che partecipano al Programma di affiliazione di YouTube utilizzando l'API secondaria 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 e campagne mirate.

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

Puoi utilizzare Merchant Center Query Language (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:

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

Visualizzare il rendimento per creator

Per capire quali creator di YouTube generano il maggior coinvolgimento e 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.

Di seguito è riportato un esempio di istruzione MCQL SELECT che puoi utilizzare per ottenere i tre 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 chiave sul rendimento per i primi tre creator classificati in base alla metrica delle vendite lorde nell'intervallo di date specificato.

Visualizzare il rendimento per contenuti

Per vedere quali video di YouTube specifici hanno il rendimento migliore, puoi eseguire query sulla youtube_content_performance_view. Questa visualizzazione aggrega le metriche in base ai singoli video di YouTube e include titoli e ID dei video.

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

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, l'ID video e le metriche chiave dei primi tre video in base al numero totale di views nel periodo di tempo specificato.

Visualizzare i prodotti taggati con il maggior coinvolgimento

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

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

Visualizzare i prodotti più venduti

Per capire quali prodotti hanno 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.

Visualizzare il rendimento di tutte le campagne

Per comprendere il rendimento complessivo delle tue campagne di affiliazione, esegui una query sul 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, i conteggi dei creator attivi e le metriche di vendite e coinvolgimento.

Utilizza la seguente istruzione MCQL SELECT per ottenere le 10 campagne principali per ordini il giorno 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 chiave di rendimento per le prime 10 campagne classificate 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, tra cui titoli dei canali, numero di video e titoli dei prodotti taggati.

Utilizza la seguente istruzione MCQL SELECT per ottenere i primi 10 creator 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 chiave sul rendimento per i primi 10 creator in base alle visualizzazioni totali all'interno della campagna e della data specificate.

Visualizzare il rendimento delle campagne per video

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

Utilizza la seguente istruzione MCQL SELECT per ottenere i 10 video più visualizzati per un determinato creator e una specifica campagna il giorno 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 principali metriche di rendimento per i primi 10 video classificati in base al numero totale di views per il canale, la campagna e la data del creator specificati.

Visualizzare il rendimento delle campagne per prodotto

Per comprendere 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 titoli dei prodotti, dettagli dei video associati e metriche sulle vendite.

Utilizza la seguente istruzione MCQL SELECT per ottenere i 10 prodotti più visualizzati 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 chiave di rendimento 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 per 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 richiesto. Le query che coprono set di dati di grandi dimensioni richiedono più tempo e potrebbero causare timeout.
Indietro
Explore your competitive landscape
Avanti
Use Merchant Center Query Language