Google Ad Manager یک SOAP API برای گزارش‌دهی و دستکاری نهادهای قاچاق، مانند LineItems ارائه می‌کند. کتابخانه های مشتری به چندین زبان در دسترس هستند. مانند AdX Seller API، Ad Manager API از OAuth2 برای احراز هویت استفاده می کند.
برای شروع با اولین درخواست API خود، به شروع به کار مراجعه کنید.
گزارش در Ad Manager API
Ad Manager API ReportService دو روش برای اجرا و دانلود گزارش ها ارائه می دهد:
- ایجاد یک کوئری در UI و اجرای آن بر اساس شناسه آن.
- ساخت یک ReportQuery موقت.
با هر دو گزینه، گردش کار API از چهار مرحله تشکیل شده است:
- با runReportJob تماس بگیرید.
- نظرسنجی وضعیت گزارش با استفاده از getReportJobStatus .
- URL گزارش تکمیل شده را با استفاده از getReportDownloadUrlWithOptions دریافت کنید.
- گزارش را از URL برگشتی دانلود کنید.
برای جزئیات بیشتر، راهنمای گزارش را ببینید.
گزارش مناطق زمانی
برخلاف Ad Exchange Seller REST API، در Ad Manager API پیش‌فرض منطقه زمانی شبکه شما را گزارش می‌کند. برای تغییر این قسمت، قسمت TimeZoneType را تنظیم کنید.
AdX به Ad Manager متریک ها و نگاشت ابعاد
همه معیارها و ابعاد Ad Exchange Seller REST API پشتیبانی شده اکنون در API گزارش Ad Manager وجود دارد. برخی از نام ها تغییر کرده اند و تعدادی از آنها منسوخ شده اند. لطفا برای جزئیات بیشتر به جداول زیر مراجعه کنید.
معیارها / ستون ها
این جدول معیارهای AdX را به ستون‌های Ad Manager ترسیم می‌کند.
| AdX Metric | ستون Ad Manager | نام ابزار جستجوی Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | نمای فعال نمایش‌ها را فعال کرد |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | نمایش فعال، برداشت‌ها را اندازه‌گیری کرد |
| ACTIVE_VIEW_MEASURABLE_RATIO | (منسوخ) | (منسوخ) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | نمای فعال مشاهده شده است |
| 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 | 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 | CTR آگهی |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (توصیه جدید) AD_EXCHANGE_AD_ECPM | (توصیه جدید) eCPM آگهی |
| LIFT_RATE | AD_EXCHANGE_LIFT | بلند کردن |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | درخواست های منطبق |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | 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 | چارک ویدیو 1 |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | چارک ویدیو 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 VTR |
ابعاد
این جدول ابعاد AdX را به ابعاد Ad Manager ترسیم می کند.
| بعد AdX | بعد مدیر تبلیغات | نام ابزار جستجوی 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 | شبکه های خریدار |
| کد کشور | AD_EXCHANGE_COUNTRY_CODE | (در دسترس نیست) |
| نام کشور | 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 | درخواست منابع |
| نام دامنه | AD_EXCHANGE_SITE_NAME | سایت های |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP ها |
| 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 | پهنای باند |
| ماه | AD_EXCHANGE_MONTH | ماه ها |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | دسته های دستگاه |
| کد محصول | AD_EXCHANGE_PRODUCT_CODE | (در دسترس نیست) |
| نام محصول | 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 | 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 | قوانین قیمت گذاری |