Отчеты о выставлении счетов партнерам

Партнеры получают сводные отчеты по выставлению счетов , содержащие агрегированные ежедневные данные о платных событиях, сгруппированные по агенту, типу события и оператору связи. Это служит общим обзором всего платного трафика, предоставляя вам ценную аналитику и необходимую информацию о ваших данных о трафике.

Создание и доступ к файлам

Отчеты формируются ежедневно в формате CSV и доставляются с помощью сервиса Google SFTP.

Доступ по SFTP

Доступ к отчетам защищен парами открытого и закрытого ключей. Учетные данные SFTP обеспечивают безопасный и изолированный доступ.

Как получить доступ к SFTP

Для получения отчетов о выставлении счетов необходимо сначала настроить учетные данные SFTP:

1. Сгенерируйте пару ключей SSH: Следуйте инструкциям, чтобы сгенерировать пару ключей Secure Shell (SSH) для SFTP-сервера .
2. Начало процесса регистрации: Если вас интересуют партнерские отчеты, обратитесь к своему представителю Google Business или к основному контактному лицу Google. Они помогут вам выполнить первоначальную настройку и регистрацию вашей партнерской учетной записи для формирования отчетов по выставлению счетов.
3. Отправьте свой открытый ключ: предоставьте свой открытый ключ (файл PUB) вашему контакту в Google. После этого Google создаст вашу учетную запись, присвоит вам уникальный <partner_id> ) и уведомит вас, когда доступ будет готов.

4. Подключение к серверу: После получения уведомления вы сможете получить доступ к своим отчетам на SFTP-сервере по адресу partnerupload.google.com , используя порт 19321. Для подключения используйте следующую команду:

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

Соглашение об именовании файлов

Все отчеты по каждому перевозчику представлены в отдельном виде.

Структура именования каталогов и файлов выглядит следующим образом:

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

Префикс <prefix> указывает на конкретный тип предоставляемого отчета.

К стандартным префиксам относятся:

Тип отчета	Префикс имени файла
Сводный отчет	summary

При наличии нескольких отчетов для одного и того же перевозчика и партнера (например, при миграции форматов) можно дополнительно добавить пользовательский префикс имени файла. Всегда следует рекурсивно сканировать все файлы в каталоге с указанной датой.

Структура CSV-отчета

В следующих разделах описываются поля, форматы данных и определения столбцов, используемые в отчетах по выставлению счетов партнерам.

По дополнительным вопросам обращайтесь к своему оператору связи.

Формат сводного отчета

Поле	Формат	Описание	Пример
type	нить	Тип события выставления счетов	a2p_session
agent_id	нить	Уникальный идентификатор для агента	[e-mail]
agent_name	нить	Имя агента, участвовавшего в мероприятии.	ACME Brand
carrier_id	нить	Идентификатор оператора для трафика	super-carrier
carrier_name	нить	Название оператора связи	Super Carrier
carrier_country	нить	Код страны ISO 3166-1 alpha-2	US
start_date	нить	Дата начала мероприятия (формат ГГГГ-ММ-ДД)	2026-05-07
billing_date	нить	Дата формирования отчета о выставлении счетов	2026-05-08
event_count	число	Количество агрегированных событий по типам (сумма)	150
segment_count *	число	Вычисленное количество сегментов для событий модели выставления счетов в США (SUM) *Только для США	5