Rapports sur la facturation partenaire

Les partenaires reçoivent des rapports de facturation récapitulatifs qui fournissent des décomptes quotidiens agrégés des événements facturables, regroupés par agent, type d'événement et opérateur. Il s'agit d'un récapitulatif de haut niveau de l'ensemble du trafic facturable, qui vous fournit des analyses précieuses et la visibilité nécessaire sur vos données sur le trafic.

Génération et accès aux fichiers

Les rapports sont générés quotidiennement au format CSV et transmis à l'aide du service SFTP de Google.

Accès SFTP

L'accès aux rapports est protégé par des paires de clés publique/privée. Les identifiants SFTP garantissent un accès sécurisé et isolé.

Comment obtenir un accès SFTP ?

Pour recevoir des rapports de facturation, vous devez d'abord configurer vos identifiants SFTP :

1. Générez une paire de clés SSH : suivez les instructions pour générer une paire de clés Secure Shell (SSH) pour une boîte de dépôt SFTP.
2. Lancez l'intégration : si vous souhaitez recevoir des rapports partenaires, contactez votre représentant commercial Google ou votre contact Google principal. Il vous guidera dans la configuration initiale et l'enregistrement de votre compte partenaire pour les rapports de facturation.
3. Envoyez votre clé publique : fournissez votre clé publique (fichier PUB) à votre contact Google. Google provisionnera ensuite votre compte, vous attribuera un <partner_id> unique et vous informera lorsque l'accès sera prêt.

4. Accédez au serveur : une fois que vous avez reçu la notification, vous pouvez accéder à vos rapports sur le serveur SFTP à l'adresse partnerupload.google.com à l'aide du port 19321. Utilisez la commande suivante pour vous connecter :

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

Convention de dénomination des fichiers

Tous les rapports d'opérateur sont divisés par opérateur.

Les structures de dénomination des répertoires et des fichiers sont les suivantes :

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

Le <prefix> identifie le type spécifique de rapport transmis.

Les préfixes standards incluent les suivants :

Type de rapport	Préfixe du nom de fichier
Rapport récapitulatif	summary

Un préfixe de nom de fichier personnalisé supplémentaire peut être ajouté si plusieurs rapports existent pour le même opérateur et partenaire (par exemple, lors des migrations de format). Vous devez toujours analyser tous les fichiers de manière récursive dans le répertoire daté.

Structure du rapport au format CSV

Les sections suivantes définissent les champs, les formats de données et les définitions de colonnes utilisés dans les rapports de facturation des partenaires.

Pour toute question supplémentaire, contactez votre opérateur.

Format du rapport récapitulatif

Champ	Format	Description	Exemple
type	chaîne	Type d'événement de facturation	a2p_session
agent_id	chaîne	ID unique de l'agent	[e-mail]
agent_name	chaîne	Nom de l'agent qui a participé à l'événement	ACME Brand
carrier_id	chaîne	ID de l'opérateur pour le trafic	super-carrier
carrier_name	chaîne	Nom du transporteur	Super Carrier
carrier_country	chaîne	Code pays ISO 3166-1 alpha-2	US
start_date	chaîne	Date de début de l'événement (format AAAA-MM-JJ)	2026-05-07
billing_date	chaîne	Date de génération du rapport de facturation	2026-05-08
event_count	nombre	Nombre d'événements agrégés par type (SOMME)	150
segment_count*	nombre	Nombre de segments calculé pour les événements du modèle de facturation américain (SOMME) *États-Unis uniquement	5