Esportare i dati di Channel Services in BigQuery

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

Utilizzando 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 di come i tuoi clienti o partner di canale utilizzano i servizi che fornisci.

Le esportazioni da Channel Services contengono dati specifici per i rivenditori non inclusi nelle esportazioni della 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 sugli 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 le esportazioni della fatturazione Cloud e puoi utilizzare le query per unire entrambi i set di dati per l'analisi.

Per informazioni sulle esportazioni della fatturazione Cloud non rivenditore, consulta Configurare le esportazioni della 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.
• Attiva 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 riutilizzare il progetto e il set di dati per l'esportazione di Channel Services.

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

Autorizzazioni richieste per le esportazioni

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

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

• Per abilitare le esportazioni di Google Cloud , nella Partner Sales Console devi disporre del ruolo Amministratore rivenditore Google Cloud .

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

• Per abilitare 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 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 è abilitata 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. Attiva la fatturazione per il progetto, se non l'hai già fatto.

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

• Se configuri il set di dati BigQuery in modo che utilizzi una posizione multiregionale, i dati di esportazione BigQuery sono disponibili per ogni origine dati selezionata a partire dall'inizio del mese precedente. Ad esempio, se attivi l'esportazione BigQuery il 23 settembre, l'esportazione includerà i dati a partire dal 1° agosto.

• Se configuri il set di dati BigQuery in modo che utilizzi una località regione (diversa da quella multiregionale USA o UE), i dati di esportazione BigQuery sono disponibili per ogni origine dati selezionata a partire dalla data in cui attivi l'esportazione e successivamente. Ciò significa che i dati di esportazione BigQuery non vengono aggiunti retroattivamente per le posizioni dei set di dati non multiregionali, quindi non vedrai i dati di esportazione BigQuery 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 per ogni account Partner Sales Console dispongano delle 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

Esistono due tipi di regioni supportate da BigQuery.

Più regioni

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

Regioni

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

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

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

Abilita l'esportazione

Prima di attivare l'esportazione dei dati, annota l'ID set di dati completo, che ha il 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 verrà visualizzata finché l'esportazione della fatturazione non viene eseguita per la prima volta per il tuo account. Il set di dati contiene i dati dal momento in cui è stato configurato per la prima volta per conservarli.

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 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 il periodo in cui l'esportazione è stata disattivata. Se hai eliminato dati esportati durante questo periodo, non possiamo eseguire il backfill dei record eliminati.

Autorizzazioni 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. Puoi configurare le autorizzazioni seguendo i passaggi per attivare l'esportazione.

Eseguire query sui dati in modo efficiente

La tabella BigQuery è partizionata per export_time e raggruppata in cluster per payer_billing_account_id per impostazione predefinita. 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 di clustering in una query aiuterà BigQuery a individuare rapidamente i dati pertinenti, il che può ridurre significativamente il costo della query.

Ad esempio, questa query è efficiente rispetto a una query senza chiavi di partizionamento e 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 saperne di più 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 della Partner Sales Console e fai clic sulla scheda Fatturazione partner.

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

Configurazione dei controlli dell'accesso per altri utenti nel set di dati di esportazione

Esistono diversi modi per configurare i controlli dell'accesso ai dati in BigQuery Export. Per ulteriori informazioni, consulta i controlli dell'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

Lo schema seguente 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 di prodotti 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
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

Colonne non applicabili agli SKU di Google Workspace a consumo

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 questo campo. I seguenti campi non si applicano alle esportazioni di Google Workspace:

• service.id
• sku.id
• project
• labels
• resource
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name
• subscription

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 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
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

Altre note sull'esportazione di Google Workspace

Esistono diversi comportamenti speciali con le esportazioni di Google Workspace:

• I dati di Google Workspace non contengono l'utilizzo proprio del rivenditore.
• Quando cost_type è tax e adjustment, usage.amount_in_pricing_units è sempre 1.
• Nelle fatture di Google Workspace, le imposte vengono visualizzate come una voce. Nell'esportazione, le imposte sono suddivise per cliente. Mentre l'imposta totale deve corrispondere alla fattura, le singole imposte potrebbero contenere piccole imprecisioni di arrotondamento.

billing_account_id

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

service e sku

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

Per gli SKU di consumo di Google Workspace (Google Voice e Drive), le colonne sku.id e service.id contengono null.

usage_start_time e usage_end_time

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

• Per usage_start_time, questo è l'orario di inizio (incluso) dell'abbonamento, alle ore 00:00 PST della data di inizio.
• Per usage_end_time, questa è l'ora di fine (esclusiva) dell'abbonamento, alle 00:00 PST del giorno successivo alla data di fine.

project.labels

Per Google Cloud, queste sono le coppie chiave:valore nel progettoGoogle Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni, vedi 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, vedi Utilizzare le etichette .

system_labels

• Per Google Cloud, si tratta delle coppie chiave-valore nella risorsaGoogle Cloud in cui si è verificato l'utilizzo. Per saperne di più, vedi Etichette di sistema disponibili.

• Per Google Workspace, si tratta di metadati aggiuntivi relativi al costo, che include:

  • 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 dell'ordine di acquisto.
  • workspace.googleapis.com/subscription_id: l'ID sottoscrizione.
  • 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 fatturato mensilmente e per il periodo di fatturazione o contrattuale di 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 si estenderà 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 fatturato mensilmente o fino alla fine del periodo di fatturazione o contrattuale per un abbonamento prepagato.
• COMMITMENT_CANCEL_ITEM: Registrato quando un abbonamento viene annullato. Sono inclusi gli addebiti associati alla risoluzione anticipata. Rappresenta un addebito per il resto del periodo contrattuale in caso di annullamento del contratto a metà periodo o un credito emesso per il resto del periodo di fatturazione in caso di modifica o annullamento del contratto a metà periodo.
• FLEXIBLE_SEATS_ITEM: Registra l'utilizzo da parte di 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 derivante dalla migrazione di Postini.
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: rappresenta le informazioni sull'utilizzo create 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, le utenze riservate agli impegni o quelle flessibili.

Per gli SKU di consumo di Google Workspace (Google Voice e Drive), questo è il numero di minuti utilizzati.

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, questo valore è 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 un credits.id alfanumerico. Alcuni esempi sono crediti per le prove gratuite o sconti per impegni di utilizzo basati sulla spesa . I valori di 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 nella Partner Sales Console, il tipo di credito sconto è indicato come Sconti basati sulla spesa (contrattuali).
• FREE_TIER : alcuni servizi offrono l'utilizzo senza costi delle risorse fino ai limiti specificati. Per questi servizi, i crediti vengono applicati per implementare l'utilizzo del livello gratuito.
• PROMOTION: questo tipo di credito include una Google Cloud prova gratuita e crediti per le campagne di marketing oppure altri vantaggi per utilizzare Google Cloud. Quando 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, questo è il prezzo addebitato per l'utilizzo degli SKU diGoogle Cloud o Google Maps Platform e dei livelli di prezzo degli SKU. Se il tuo account di fatturazione Cloud ha prezzi del contratto personalizzati, questo prezzo è specifico per la fatturazione Cloud. In caso contrario, si tratta del prezzo di listino dello SKU o del livello SKU.