Analyze Youtube Affiliate Performance (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 e singoli prodotti.

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:

• L'account utilizzato per autenticare le chiamate API dispone del ruolo Prestazioni e approfondimenti che concede l'accesso alle metriche sul rendimento.
• Il tuo account Google Merchant Center partecipa al programma di affiliazione YouTube.

Esegui una query sull'endpoint alpha

Tieni presente che, trattandosi di una 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. 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

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.

Di seguito è riportato un esempio di istruzione MCQL SELECT che puoi utilizzare per ottenere i primi tre creator 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 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 recuperare i primi tre 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 generano il maggior coinvolgimento e vendite, puoi interrogare youtube_product_tagged_stats_view. Questa visualizzazione aggrega le metriche per singoli prodotti taggati, inclusi i titoli e gli ID offerta.

Ecco un esempio di istruzione MCQL SELECT che puoi utilizzare per ottenere i 10 prodotti più popolari 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 primi 10 prodotti 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.

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.

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.
• 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.