Report sulla fatturazione partner

I partner ricevono report di fatturazione riepilogativi che forniscono conteggi giornalieri aggregati degli eventi fatturabili, raggruppati per agente, tipo di evento e operatore. Si tratta di un riepilogo di alto livello di tutto il traffico fatturabile, che ti fornisce dati e analisi preziose e la visibilità necessaria sui dati sul traffico.

Generazione e accesso ai file

I report vengono generati ogni giorno in formato CSV e forniti tramite il servizio SFTP di Google.

Accesso SFTP

L'accesso ai report è protetto da coppie di chiavi pubbliche/private. Le credenziali SFTP garantiscono un accesso sicuro e isolato.

Come ottenere l'accesso SFTP

Per ricevere i report di fatturazione, devi prima configurare le credenziali SFTP:

  1. Genera una coppia di chiavi SSH: segui le istruzioni per generare una coppia di chiavi Secure Shell (SSH) per una casella personale SFTP.
  2. Avvia l'onboarding: se ti interessa ricevere i report dei partner, contatta il tuo rappresentante commerciale di Google o il contatto Google principale. Ti guideranno nella configurazione iniziale e nella registrazione del tuo account partner per i report di fatturazione.
  3. Invia la chiave pubblica: fornisci la chiave pubblica (file PUB) al tuo contatto Google. Google eseguirà il provisioning del tuo account, assegnerà il tuo <partner_id> univoco e ti invierà una notifica quando l'accesso sarà pronto.

  4. Accedi al server: una volta ricevuta la notifica, puoi accedere ai report sul server SFTP all'indirizzo partnerupload.google.com utilizzando la porta 19321. Utilizza il seguente comando per connetterti:

    sftp -i <path_to_private_key> -P 19321 rbmreports-partner-<partner_id>@partnerupload.google.com

Convenzione di denominazione dei file

Tutti i report degli operatori sono suddivisi per operatore.

Le strutture di denominazione di directory e file sono le seguenti:


rbmreports-partner-<partner_id>/
  <YYYY>/<MM>/<DD>/
     summary_<short_carrier_id>/
        summary_<short_carrier_id>_<YYYY-MM-DD>.csv
     ...
     <prefix>_<short_carrier_id>/
        <prefix>_<short_carrier_id>_<YYYY-MM-DD>.csv

Il <prefix> identifica il tipo specifico di report fornito.

I prefissi standard includono:

Tipo di report Prefisso nome file
Report riepilogativo summary

Se esistono più report per lo stesso operatore e partner (ad esempio, durante le migrazioni di formato), è possibile aggiungere un prefisso del nome file personalizzato aggiuntivo. Devi sempre eseguire la scansione ricorsiva di tutti i file nella directory datata.

Struttura dei report CSV

Le sezioni seguenti definiscono i campi, i formati dei dati e le definizioni delle colonne utilizzati nei report di fatturazione dei partner.

Per ulteriori domande, contatta il tuo operatore.

Formato del report riepilogativo

Campo Formato Descrizione Esempio
type stringa Tipo di evento di fatturazione a2p_session
agent_id stringa ID univoco per l'agente acme_342h23_agent@rbm.goog
agent_name stringa Nome dell'agente che ha partecipato all'evento ACME Brand
carrier_id stringa ID operatore per il traffico super-carrier
carrier_name stringa Nome del corriere Super Carrier
carrier_country stringa Codice paese ISO 3166-1 alpha-2 US
start_date stringa Data di inizio dell'evento (formato AAAA-MM-GG) 2026-05-07
billing_date stringa Data di generazione del report sulla fatturazione 2026-05-08
event_count numero Numero di eventi aggregati per tipo (SOMMA) 150
segment_count* numero Il conteggio dei segmenti calcolato per gli eventi del modello di fatturazione statunitense (SOMMA)
*Solo Stati Uniti		 5
Indietro
Casi d'uso degli agenti e regole aziendali