Google Ad Manager یک SOAP API برای گزارش‌دهی و دستکاری نهادهای ترافیک، مانند LineItems، ارائه می‌دهد.
کتابخانه‌های مشتری به چندین زبان دردسترس است. مانند AdX Seller API، Ad Manager API از OAuth2 برای احراز هویت استفاده می‌کند.
برای شروع به کار با اولین درخواست API، به شروع به کار مراجعه کنید.
گزارش‌دهی در Ad Manager API
Ad Manager API ReportService دو روش برای اجرا و بارگیری گزارش‌ها ارائه می‌دهد:
- ایجاد پُرسمان در واسط کاربر و اجرای آن براساس شناسه‌اش.
- ساختن ReportQuery موردی.
با هریک از این گزینه‌ها، گردش کار میانای برنامه‌سازی کاربردی شامل چهار مرحله است:
- با runReportJob تماس بگیرید.
- بااستفاده از getReportJobStatus، وضعیت گزارش را نظرسنجی کنید.
- بااستفاده از getReportDownloadUrlWithOptions، نشانی وب گزارش تکمیل‌شده را دریافت کنید.
- گزارش را از نشانی وب برگردانده‌شده بارگیری کنید.
برای جزئیات بیشتر، راهنمای گزارش تخلف را ببینید.
منطقه‌های زمانی گزارش‌دهی
برخلاف Ad Exchange Seller REST API، در Ad Manager API گزارش‌ها به‌طور پیش‌فرض براساس منطقه زمانی شبکه شما است. برای تغییر این مورد، فیلد
TimeZoneType
را تنظیم کنید.
نگاشت سنجه‌ها و ابعاد AdX به Ad Manager
همه سنجه‌ها و ابعاد پشتیبانی‌شده Ad Exchange Seller REST API اکنون در Ad Manager reporting API وجود دارند. برخی‌از نام‌ها تغییر کرده‌اند و چند نام منسوخ شده‌اند. لطفاً برای جزئیات، جدول‌های زیر را ببینید.
سنجه‌ها / ستون‌ها
این جدول «سنجه‌های AdX» را به ستون‌های Ad Manager نگاشت می‌کند.
| سنجه AdX | ستون Ad Manager | نام ابزار پُرسمان Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | درج‌های فعال‌شده Active View |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | درج‌های اندازه‌گیری‌شده Active View |
| ACTIVE_VIEW_MEASURABLE_RATIO | (منسوخ‌شده) | (منسوخ‌شده) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | ظهورهای مشاهده‌شده Active View |
| ACTIVE_VIEW_VIEWABLE_RATIO | (منسوخ‌شده) | (منسوخ‌شده) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | میانگین زمان قابل‌مشاهده (ثانیه) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | تعداد بازدید از تبلیغ |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | eCPM آگهی |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | درخواست‌های آگهی |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | پوشش |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | نرخ کلیک درخواست آگهی |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | eCPM درخواست آگهی |
| کلیک‌ها | AD_EXCHANGE_CLICKS | کلیک‌ها |
| COST_PER_CLICK | AD_EXCHANGE_CPC | کلیک بها (CPC) |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | درخواست‌های آگهی معامله‌ها |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | پاسخ‌های قیمت پیشنهادی معامله |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | نرخ انطباق معامله‌ها |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | درخواست‌های منطبق با معامله‌ها |
| درآمدها | AD_EXCHANGE_ESTIMATED_REVENUE | درآمد تخمینی |
| INDIVIDUAL_AD_IMPRESSIONS | (منسوخ‌شده) | (منسوخ‌شده) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | نرخ کلیک‌گذری آگهی |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (توصیه جدید) AD_EXCHANGE_AD_ECPM | (توصیه جدید) هزارظهوربهای آگهی |
| LIFT_RATE | AD_EXCHANGE_LIFT | روشن کردن سایه |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | درخواست‌های منطبق |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | ن.کلیک.ر |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | eCPM تطبیق‌یافته |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | نرخ رها کردن ویدیو |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | نرخ کاهش ویدیو |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | چارک ۱ ویدیو |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | چارک ۳ ویدیو |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | نرخ رد کردن TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | بازدیدهای TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | نرخ بازدید گذری TrueView |
ابعاد
این جدول «بُعدهای AdX» را به بُعدهای Ad Manager نگاشت می‌کند.
| بُعد AdX | بُعد Ad Manager | نام ابزار پُرسمان Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | دارایی واقع در وب |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | منطقه‌های نمایش آگهی |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | برچسب‌ها |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (دردسترس نیست) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | اندازه‌های فضای آگهی |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | دامنه‌های آگهی‌دهنده |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | تبلیغ‌کنندگان |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | حوزه‌های تبلیغ‌کننده |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | بنگاه‌های تبلیغاتی |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (دردسترس نیست) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | نمانام‌ها |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (دردسترس نیست) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | انواع نمانام‌سازی |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (دردسترس نیست) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | شبکه‌های خریدار |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (دردسترس نیست) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | کشورها |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | اندازه‌های طرح‌آگهی |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (دردسترس نیست) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (دردسترس نیست) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | کانال‌ها |
| تاریخ | AD_EXCHANGE_DATE | روز |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | شناسه‌های معامله |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | نام‌های تخفیف |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (دردسترس نیست) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | واحدهای آگهی DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | منابع درخواست |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | سایت‌ها |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | پلتفرم‌های سمت تقاضا |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | انواع گسترش‌پذیر |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | مالکیت فضای آگهی |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | نام شرکای شبکه |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | نام برنامه‌ها |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | نام شرکت‌های مخابراتی |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | دستگاه‌ها |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | انواع سیاهه‌‌های آگهی |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | سیستم عامل |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Bandwidth |
| ماه | AD_EXCHANGE_MONTH | ماه |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | دسته‌های دستگاه |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (دردسترس نیست) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | محصولات |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (دردسترس نیست) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | انواع هدف‌یابی |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (دردسترس نیست) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | انواع تراکنش |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (دردسترس نیست) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | نشانی‌های وب |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (دردسترس نیست) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | مدت آگهی ویدیویی |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | انواع آگهی ویدیویی |
| هفته | AD_EXCHANGE_WEEK | هفته |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (دردسترس نیست) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | قوانین قیمت‌گذاری |