Esportare i dati di Channel Services in BigQuery

Questa pagina mostra come configurare un'esportazione di Channel Services e descrive anche lo schema disponibile per un'esportazione.

Con BigQuery, puoi esportare i dati di fatturazione di Channel Services in un set di dati BigQuery specificato. Questi dati possono aiutarti a eseguire un'analisi dettagliata del modo in cui i tuoi clienti o partner di canale utilizzano i servizi che offri.

Le esportazioni da Channel Services contengono dati specifici del rivenditore non inclusi nelle esportazioni di Fatturazione Cloud. compresi i costi, i crediti e i dati sull'utilizzo con le regole di ricalcolo dei prezzi configurate. Queste esportazioni aggregano anche tutte le informazioni relative agli account di fatturazione principali dei tuoi clienti in un unico set di dati.

Tuttavia, i dati di un'esportazione di Channel Services sono compatibili con quelli delle esportazioni della fatturazione Cloud e puoi utilizzare le query per unire entrambi i set di dati per l'analisi.

Per informazioni sulle esportazioni di fatturazione Cloud per i non rivenditori, consulta la sezione sulla configurazione delle esportazioni di fatturazione Cloud in BigQuery.

Prima di iniziare

Prima di iniziare a esportare i dati di fatturazione di Channel Services, devi:

• Configura un progetto per l'hosting del set di dati BigQuery Assicurati che la fatturazione sia abilitata per il progetto.
• Abilita l'API BigQuery Data Transfer Service nel progetto.
• Crea un set di dati per i dati esportati.

Se hai già un progetto e un set di dati BigQuery per le esportazioni dei dati di fatturazione Cloud, puoi riutilizzarli per l'esportazione di Channel Services.

Per informazioni dettagliate sulla configurazione di un progetto e di un set di dati, consulta Configurare l'esportazione dei dati di fatturazione Cloud in BigQuery.

Autorizzazioni richieste per le esportazioni

Per attivare e configurare le esportazioni di Channel Services, devi disporre dei seguenti ruoli:

• Per BigQuery, se hai creato il set di dati di destinazione, devi avereBigQuery User per il progetto che contiene il set di dati. Se il set di dati è stato creato da qualcun altro, devi disporre del ruolo BigQuery Data Owner.

• Per attivare le esportazioni di Google Cloud, in Partner Sales Console devi avere il ruolo Amministratore rivenditore Google Cloud.

  Scopri come assegnare i ruoli Google Cloud nella Console Partner Sales

• Per attivare le esportazioni di Google Workspace, devi essere un amministratore rivenditore o disporre dei privilegi di fatturazione di Google Workspace.

  Scopri di più sull'assegnazione dei ruoli di Google Workspace nella Partner Sales Console

• (Facoltativo) Project Viewer per il progetto che contiene il set di dati BigQuery di destinazione, per verificare automaticamente se la fatturazione è attivata nel progetto.

Seleziona un progetto e un set di dati

Nella Partner Sales Console, seleziona un progetto e un set di dati in BigQuery per archiviare i dati di Channel Services. Abilita la fatturazione nel progetto, se non è già attivata.

Quando selezioni o crei un set di dati BigQuery, puoi scegliere una delle località BigQuery supportate per il set di dati. Quando attivi l'esportazione dei dati di Channel Services per la prima volta per ogni origine dati (Google Cloud o Google Workspace):

• Se configuri il tuo [BigQuery

  set di dati](/bigquery/docs/datasets-intro) per utilizzare una località multi-regione, i dati di esportazione di BigQuery sono disponibili per ogni origine dati selezionata dall'inizio del mese precedente. Ad esempio, se attivi BigQuery Export il 23 settembre, l'esportazione includerà i dati a partire dal 1° agosto.

• Se configuri il tuo [BigQuery

  set di dati](/bigquery/docs/datasets-intro) per utilizzare una località di regione (diversa da multi-regione US o EU), i dati di BigQuery Export sono disponibili per ogni origine dati selezionata a partire dalla data di attivazione dell'esportazione e successivamente. In altre parole, i dati di BigQuery Export non vengono aggiunti in modo retroattivo per le posizioni dei set di dati non multiregione, pertanto non vedrai i dati di BigQuery Export precedenti all'attivazione dell'esportazione.

Per esportare i dati di fatturazione per più account Partner Sales Console, segui questi passaggi:

1. Nel set di dati BigQuery in cui vuoi esportare i dati, assicurati che gli amministratori della fatturazione di ogni account Partner Sales Console abbiano le autorizzazioni per visualizzare il set di dati.
2. Quando configuri l'esportazione dei dati di fatturazione in ogni account Partner Sales Console, seleziona il set di dati unificato.

Località BigQuery supportate

BigQuery supporta due tipi di regioni.

Più regioni

La tabella seguente elenca le regioni multiple in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Regioni

La tabella seguente elenca le regioni delle Americhe in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

La tabella seguente elenca le regioni dell'Asia-Pacifico in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

La tabella seguente elenca le regioni in Europa in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Abilita l'esportazione

Prima di attivare l'esportazione dei dati, prendi nota dell'ID set di dati completo, che è nel formato PROJECT_ID:DATASET_NAME.

Per attivare l'esportazione di Channel Services:

1. In Partner Sales Console, apri la pagina Fatturazione.
2. Seleziona Esportazione della fatturazione.
3. Inserisci l'ID completo del set di dati nel campo Set di dati di rifatturazione.
4. Seleziona le Origini dati per cui esportare i dati.
5. Fai clic su Aggiorna. *Se ti viene richiesto di aggiornare le autorizzazioni del set di dati, fai clic su Aggiorna*.

Una volta configurata, l'esportazione della fatturazione fornisce ogni giorno i dati incrementali sull'utilizzo. La tabella di esportazione non viene visualizzata finché l'esportazione della fatturazione non viene eseguita per il tuo account per la prima volta. Il set di dati contiene i dati dal momento in cui è stato configurato per la prima volta per conservare i dati.

Per interrompere l'esportazione dei dati di costo della rifatturazione verso il set di dati, fai clic su Disattiva esportazione dati di fatturazione nella pagina Rifatturazione dei clienti. Per riattivare l'esportazione, segui i passaggi precedenti per specificare un ID set di dati.

I dati di costo relativi alla rifatturazione potrebbero non essere disponibili per la durata in cui l'esportazione è stata disattivata. Se hai eliminato dati esportati durante questo periodo, non possiamo eseguire il backfill dei record eliminati.

Autorizzazioni degli account di servizio richieste

L'esportazione dei dati di Channel Services utilizza un account di servizio di proprietà e gestito da Google e autorizzato a scrivere record di fatturazione in una tabella. L'account di servizio è:

cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com

Questo account di servizio richiede il ruolo predefinito: roles/bigquery.dataEditor per consentire le esportazioni. Per configurare le autorizzazioni, segui i passaggi per attivare l'esportazione.

Esegui query sui dati in modo efficiente

Per impostazione predefinita, la tabella BigQuery è partizionata per export_time e raggruppata per payer_billing_account_id. Ciò significa che la tabella è suddivisa in partizioni più piccole, ognuna delle quali è ulteriormente suddivisa in cluster più piccoli. L'utilizzo delle chiavi di partizione e cluster in una query aiuterà BigQuery a individuare rapidamente i dati pertinenti, il che può ridurre notevolmente il costo della query.

Ad esempio, questa query è efficiente rispetto a una query senza partizione e chiavi di clustering:

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

Per ulteriori informazioni su partizionamento, clustering e best practice, consulta i seguenti link:

1. Eseguire query sulle tabelle partizionate
2. Eseguire query sulle tabelle in cluster
3. Ottimizzare il calcolo delle query
4. Best practice per controllare i costi in BigQuery

Trovare l'ID account di fatturazione del pagatore

Per trovare l'ID account di fatturazione del pagatore, apri la pagina degli account di fatturazione di Partner Sales Console e fai clic sulla scheda Fatturazione partner.

Puoi vedere tutti gli account di fatturazione e gli ID account di fatturazione del pagatore.

Configurare i controlli di accesso per altri utenti nel set di dati di esportazione

Esistono diversi modi per configurare i controlli di accesso ai dati in BigQuery Export. Per ulteriori informazioni, consulta i controlli di accesso di BigQuery.

Per assicurarti che gli utenti abbiano accesso solo ai dati che sono autorizzati a visualizzare, ti consigliamo di configurare le viste autorizzate per condividere i dati del set di dati esportato.

Per l'esportazione continua dei dati, quando configuri le autorizzazioni per gli utenti, assicurati che l'account di servizio cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com abbia sempre accesso completo come editor al set di dati di esportazione.

Schema tabella

Il seguente schema descrive i dati nella tabella BigQuery.

Nel tuo set di dati BigQuery, l'esportazione dettagliata dei dati di rifatturazione viene caricata in una tabella di dati denominata reseller_billing_detailed_export_v1.

Note aggiuntive sullo schema

Esistono alcune note aggiuntive sullo schema.

Colonne non applicabili a Google Workspace

Quando una colonna o un campo non si applica a una famiglia di prodotti, i dati esportati per questa famiglia contengono null in questo campo. I seguenti campi non si applicano alle esportazioni di Google Workspace:

• project
• labels
• resource
• credits
• adjustmentsInfo
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name

Colonne non applicabili agli ordini offline (anteprima)

Quando una colonna o un campo non si applica a una famiglia di prodotti, i dati esportati per questa famiglia di prodotti contengono null in questa colonna o in questo campo. Le seguenti colonne o campi non si applicano alle esportazioni della fatturazione degli ordini offline:

• project
• labels
• system_labels
• location
• resource
• credits
• entitlement_name
• channel_partner_name
• channel_partner_cost
• customer_name
• customer_cost
• cost_at_list
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name

Altre note sull'esportazione di Google Workspace

Esistono diversi comportamenti speciali per le esportazioni di Google Workspace:

• I dati di Google Workspace non contengono l'utilizzo del rivenditore.
• Quando cost_type è tax e adjustment, usage.amount_in_pricing_units è sempre 1.
• Nelle fatture di Google Workspace, le imposte vengono mostrate come una voce. Nell'esportazione, le imposte sono suddivise per cliente. Sebbene l'imposta totale debba corrispondere a quella indicata in fattura, le singole imposte potrebbero contenere piccole imprecisioni dovute all'arrotondamento.

billing_account_id

• Per Google Cloud, si tratta dell'account di fatturazione Cloud a cui è associato l'utilizzo.
• Per Google Workspace, si tratta dell'identità Cloud del cliente.
• Per gli ordini offline, si tratta del nome del cliente.

service e sku

Per Google Workspace, queste colonne rappresentano "Prodotto" e "SKU" associati all'utilizzo. Scopri di più sugli ID prodotto e SKU.

usage_start_time e usage_end_time

Nel file CSV della fattura di Google Workspace, questo valore è rappresentato come date. Nelle esportazioni, questi valori sono rappresentati come timestamp:

• Per usage_start_time, si tratta dell'ora di inizio (inclusa) dell'abbonamento, alle ore 00:00 PST della data di inizio.
• Per usage_end_time, si tratta dell'ora di fine (esclusiva) dell'abbonamento, alle 00:00 PST del giorno successivo alla data di fine.

project.labels

Per Google Cloud, si tratta delle coppie chiave-valore nel progetto Google Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni, consulta la sezione Utilizzare le etichette.

labels

Per Google Cloud, si tratta delle coppie chiave-valore nella risorsa Google Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni, consulta la sezione Utilizzare le etichette.

system_labels

• Per Google Cloud, si tratta delle coppie chiave-valore nella risorsa Google Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni, consulta la sezione Etichette di sistema disponibili.

• Per Google Workspace, si tratta di metadati aggiuntivi relativi al costo, tra cui:

  • workspace.googleapis.com/domain_name: il nome di dominio del cliente.
  • workspace.googleapis.com/order_id: l'ID ordine.
  • workspace.googleapis.com/purchase_order_id: l'ID ordine di acquisto.
  • workspace.googleapis.com/subscription_id: l'ID abbonamento.
  • workspace.googleapis.com/usage_type: il tipo di utilizzo. Non applicabile se cost_type non è regular.

I tipi di utilizzo di Google Workspace includono:

• COMMITMENT_TERM_START_ITEM: inizio di un abbonamento. In genere associato a un mese parziale per un abbonamento con impegno con fatturazione mensile e al periodo di fatturazione o contrattuale per un abbonamento prepagato.
• COMMITMENT_TERM_END_ITEM: fine di un abbonamento. In genere associato agli addebiti dell'ultimo mese di un abbonamento con impegno fatturato mensilmente.
• COMMITMENT_TERM_RENEWAL_ITEM: inizio di un periodo di abbonamento successivo.
• COMMITMENT_MONTHLY_ITEM: utilizzo registrato per gli impegni esistenti all'inizio del mese. Nella maggior parte dei casi, l'addebito verrà esteso per tutto il mese.
• COMMITMENT_SEATS_CHANGE_ITEM: registrato quando il livello di impegno cambia (aumento o diminuzione). Spesso inizia a metà mese e si estende fino alla fine del mese per un abbonamento con impegno con fatturazione mensile o fino alla fine del periodo di fatturazione o del contratto per un abbonamento prepagato.
• COMMITMENT_CANCEL_ITEM: viene registrato quando un abbonamento viene annullato. Sono inclusi gli addebiti associati alla risoluzione anticipata. Rappresenta un addebito per il resto del periodo di contratto quando il contratto viene annullato a metà termine o un credito emesso per il resto del periodo di fatturazione quando un contratto viene modificato o annullato a metà termine.
• FLEXIBLE_SEATS_ITEM: registra l'utilizzo per un determinato numero di utenti per un blocco contiguo di un determinato numero di giorni. Destinato solo agli utenti senza impegno.
• COUPON_DISCOUNT_ITEM: importo dello sconto associato a un coupon.
• MIGRATED_CREDIT_ITEM: credito proveniente dalla migrazione di Postini.
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: rappresenta i dati di utilizzo creati all'inizio del ciclo di pagamento per l'intero ciclo per un abbonamento prepagato con impegno.

usage.amount

Per l'utilizzo basato sulle utenze di Google Workspace, questo valore indica le utenze a pagamento. Ad esempio, utenze riservate agli impegni o numero di utenze a pagamento per il servizio flessibile.

usage.pricing_unit

• Per Google Cloud, scopri di più sull'API Cloud Billing Catalog. {: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
• Per Google Workspace, si tratta di count.

credits.id

Per Google Cloud, si tratta di un identificatore univoco alfanumerico (12-b34-c56-d78) o di una descrizione del tipo di credito (Sconto per impegno di utilizzo: CPU ). Se il campo credits.id è vuoto, lo SKU prodotto non è associato a un credito.

credits.full_name

Per Google Cloud, si tratta di una descrizione leggibile di uncredits.id alfanumerico. Alcuni esempi sono credito per la prova gratuita o sconto per impegno di utilizzo basato sulla spesa . I valori credits.full_name vengono compilati solo per gli SKU con un credits.id alfanumerico. Se il valore di credits.id è una descrizione del tipo di credito (ad esempio Sconto per impegno di utilizzo: CPU), il campo credits.full_name sarà vuoto.

credits.type

Per Google Cloud, i tipi di credito includono:

• COMMITTED_USAGE_DISCOUNT: contratti per uso confermato basati su risorse acquistati per Compute Engine in cambio di prezzi notevolmente scontati per l'utilizzo delle VM.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: contratti per uso confermato basati sulla spesa acquistati per servizi in cambio di un impegno di spesa minimo.
• DISCOUNT: questo tipo di credito viene utilizzato per i crediti guadagnati al raggiungimento di una soglia di spesa contrattuale. Tieni presente che, nei report di fatturazione Cloud disponibili in Partner Sales Console, il tipo di credito sconto è indicato come Sconti basati sulla spesa (contrattuali).
• FREE_TIER: alcuni servizi offrono l'utilizzo gratuito delle risorse fino ai limiti specificati. Per questi servizi, i crediti vengono applicati per implementare l'utilizzo del livello senza costi.
• PROMOTION: questo tipo di credito include una prova senza costi di Google Cloud e crediti per le campagne di marketing oppure altri vantaggi per utilizzare Google Cloud. Se disponibili, i crediti promozionali sono considerati una forma di pagamento e vengono applicati automaticamente per ridurre l'importo totale della fattura.
• RESELLER_MARGIN: se sei un rivenditore, il tipo di credito margine rivenditore indica gli sconti del Programma per rivenditori guadagnati per ogni voce idonea.
• SUBSCRIPTION_BENEFIT: crediti guadagnati acquistando abbonamenti a lungo termine a servizi in cambio di sconti.
• SUSTAINED_USAGE_DISCOUNT: Il tipo di credito per sconti per utilizzo sostenuto è uno sconto automatico guadagnato per l'esecuzione di risorse Compute Engine specifiche per una parte significativa del mese di fatturazione.

adjustmentsInfo

Per Google Cloud, questi valori vengono compilati solo se la voce di costo è stata generata in seguito a una modifica della fatturazione Cloud. Il tipo adjustmentsInfo contiene i dettagli sull'aggiustamento, se è stato emesso per correggere un errore o per altri motivi.

adjustmentsInfo.adjustment_type

Per Google Cloud, sono inclusi:

• USAGE_CORRECTION: una correzione dovuta a un utilizzo errato registrato.
• PRICE_CORRECTION: una correzione dovuta a regole per la determinazione del prezzo non corrette.
• METADATA_CORRECTION: una correzione apportata ai metadati senza modificare il costo.
• GOODWILL: un credito emesso per il cliente per l'avviamento.
• SALES_BASED_GOODWILL: un credito emesso per il cliente per l'avviamento nell'ambito di un contratto.
• SLA_VIOLATION: un credito emesso per il cliente a causa di una violazione di un obiettivo del livello di servizio (SLO).
• BALANCE_TRANSFER: un aggiustamento per trasferire fondi da un account pagamenti a un altro.
• ACCOUNT_CLOSURE: un aggiustamento per azzerare il saldo di un account chiuso.
• GENERAL_ADJUSTMENT: una modifica generale dell'account di fatturazione Cloud.

adjustmentsInfo.adjustment_mode

Per Google Cloud, sono inclusi:

• PARTIAL_CORRECTION: la correzione annulla parzialmente l'utilizzo e il costo originali.
• COMPLETE_NEGATION_WITH_REMONETIZATION: la correzione annulla completamente l'utilizzo e il costo originali ed emette le voci corrette con utilizzo e costo aggiornati.
• COMPLETE_NEGATION: la correzione annulla completamente l'utilizzo e il costo originali e non vengono rimonetizzati ulteriori utilizzi.
• MANUAL_ADJUSTMENT: l'aggiustamento viene assegnato manualmente al costo e all'utilizzo.

price.effective_price

Per Google Cloud, si tratta del prezzo addebitato per l'utilizzo degli SKU e dei livelli di prezzo di Google Cloud o Google Maps Platform. Se il tuo account di fatturazione Cloud ha prezzi del contratto personalizzati, questo prezzo è specifico per la tua fatturazione Cloud. In caso contrario, si tratta del prezzo di listino dell'SKU o del livello SKU.