شرکا گزارشهای خلاصهای از صورتحسابها دریافت میکنند که تعداد کل رویدادهای قابل پرداخت روزانه را بر اساس اپراتور، نوع رویداد و اپراتور گروهبندی میکند. این گزارشها به عنوان خلاصهای سطح بالا از تمام ترافیک قابل پرداخت عمل میکنند و تجزیه و تحلیلهای ارزشمندی را در اختیار شما قرار میدهند و امکان مشاهده دادههای ترافیک شما را فراهم میکنند.
تولید فایل و دسترسی
گزارشها روزانه در قالب CSV تولید و با استفاده از سرویس SFTP گوگل ارائه میشوند.
دسترسی SFTP
دسترسی به گزارشها توسط جفت کلیدهای عمومی/خصوصی محافظت میشود. اعتبارنامههای SFTP دسترسی ایمن و ایزوله را تضمین میکنند.
نحوه دسترسی به SFTP
برای دریافت گزارشهای صورتحساب، ابتدا باید اعتبارنامههای SFTP خود را تنظیم کنید:
- ایجاد یک جفت کلید SSH: دستورالعملها را برای ایجاد یک جفت کلید Secure Shell (SSH) برای یک دراپ باکس SFTP دنبال کنید.
- شروع فرآیند استخدام: اگر علاقهمند به دریافت گزارشهای همکاری هستید، با نماینده تجاری گوگل یا رابط اصلی گوگل خود تماس بگیرید. آنها شما را در مراحل اولیه راهاندازی و ثبت حساب همکاری برای گزارشدهی صورتحساب راهنمایی خواهند کرد.
- کلید عمومی خود را ارسال کنید: کلید عمومی خود (فایل PUB) را به مخاطب گوگل خود ارائه دهید. سپس گوگل حساب شما را تأمین میکند،
<partner_id>منحصر به فرد شما را اختصاص میدهد و هنگامی که دسترسی آماده شد، به شما اطلاع میدهد. دسترسی به سرور: پس از اطلاعرسانی، میتوانید با استفاده از پورت ۱۹۳۲۱ به گزارشهای خود در سرور SFTP در
partnerupload.google.comدسترسی پیدا کنید. برای اتصال از دستور زیر استفاده کنید: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 | رشته | شناسه منحصر به فرد برای نماینده | acme_342h23_agent@rbm.goog |
agent_name | رشته | نام نمایندهای که در این رویداد شرکت کرده است | ACME Brand |
carrier_id | رشته | شناسه اپراتور برای ترافیک | super-carrier |
carrier_name | رشته | نام حامل | Super Carrier |
carrier_country | رشته | کد کشور ISO 3166-1 alpha-2 | US |
start_date | رشته | تاریخ شروع رویداد (قالب YYYY-MM-DD) | 2026-05-07 |
billing_date | رشته | تاریخ ایجاد گزارش صورتحساب | 2026-05-08 |
event_count | شماره | تعداد رویدادهای تجمیعشده به ازای هر نوع (SUM) | 150 |
segment_count * | شماره | تعداد بخشهای محاسبهشده برای رویدادهای مدل صورتحساب ایالات متحده (SUM) *فقط آمریکا | 5 |
شرکا گزارشهای خلاصهای از صورتحسابها دریافت میکنند که تعداد کل رویدادهای قابل پرداخت روزانه را بر اساس اپراتور، نوع رویداد و اپراتور گروهبندی میکند. این گزارشها به عنوان خلاصهای سطح بالا از تمام ترافیک قابل پرداخت عمل میکنند و تجزیه و تحلیلهای ارزشمندی را در اختیار شما قرار میدهند و امکان مشاهده دادههای ترافیک شما را فراهم میکنند.