احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به
مقدمه REST مراجعه کنید.
AdGroupBidModifier
یک اصلاح کننده پیشنهاد گروه تبلیغاتی را نشان می دهد.
نمایندگی JSON |
---|
{
"resourceName": string,
"bidModifierSource": enum (BidModifierSource ),
"adGroup": string,
"criterionId": string,
"bidModifier": number,
"baseAdGroup": string,
// Union field criterion can be only one of the following:
"hotelDateSelectionType": {
object (HotelDateSelectionTypeInfo )
},
"hotelAdvanceBookingWindow": {
object (HotelAdvanceBookingWindowInfo )
},
"hotelLengthOfStay": {
object (HotelLengthOfStayInfo )
},
"hotelCheckInDay": {
object (HotelCheckInDayInfo )
},
"device": {
object (DeviceInfo )
},
"hotelCheckInDateRange": {
object (HotelCheckInDateRangeInfo )
}
// End of list of possible types for union field criterion .
} |
فیلدها |
---|
resourceName | string تغییرناپذیر. نام منبع اصلاح کننده پیشنهاد گروه آگهی. نام منابع اصلاح کننده پیشنهاد قیمت گروه تبلیغات به شکل زیر است: customers/{customerId}/adGroupBidModifiers/{adGroupId}~{criterionId} |
bidModifierSource | enum ( BidModifierSource ) فقط خروجی منبع اصلاح کننده پیشنهاد قیمت |
adGroup | string تغییرناپذیر. گروه تبلیغاتی که این معیار به آن تعلق دارد. |
criterionId | string ( int64 format) فقط خروجی شناسه معیار برای تغییر پیشنهاد. این فیلد برای جهش نادیده گرفته می شود. |
bidModifier | number اصلاح کننده پیشنهاد زمانی که معیار مطابقت دارد. اصلاح کننده باید در محدوده: 0.1 - 10.0 باشد. محدوده 1.0 - 6.0 برای PreferredContent است. از 0 برای انصراف از نوع دستگاه استفاده کنید. |
baseAdGroup | string فقط خروجی گروه آگهی پایه که این اصلاحکننده پیشنهاد گروه آگهی پیشنویس/آزمایشی از آن ایجاد شده است. اگر adGroup یک گروه تبلیغاتی پایه باشد، این فیلد برابر با adGroup خواهد بود. اگر گروه تبلیغاتی در پیش نویس یا آزمایشی ایجاد شده باشد و هیچ گروه تبلیغاتی پایه متناظری نداشته باشد، این قسمت خالی خواهد بود. این فیلد فقط خواندنی است. |
criterion میدان اتحادیه . معیار این اصلاح کننده پیشنهاد گروه آگهی. در عملیات ایجاد شروع در V5 مورد نیاز است. criterion فقط می تواند یکی از موارد زیر باشد: |
hotelDateSelectionType | object ( HotelDateSelectionTypeInfo ) تغییرناپذیر. معیار انتخاب تاریخ هتل (تاریخ پیشفرض در مقابل انتخاب کاربر). |
hotelAdvanceBookingWindow | object ( HotelAdvanceBookingWindowInfo ) تغییرناپذیر. ملاک تعداد روزهای قبل از اقامت رزرو در حال انجام است. |
hotelLengthOfStay | object ( HotelLengthOfStayInfo ) تغییرناپذیر. ملاک مدت اقامت در هتل در شب. |
hotelCheckInDay | object ( HotelCheckInDayInfo ) تغییرناپذیر. ملاک روز هفته که رزرو برای آن است. |
device | object ( DeviceInfo ) تغییرناپذیر. یک معیار دستگاه |
hotelCheckInDateRange | object ( HotelCheckInDateRangeInfo ) تغییرناپذیر. معیار محدوده تاریخ ورود به هتل. |
BidModifierSource
Enum منابع اصلاح کننده پیشنهاد ممکن را توصیف می کند.
Enums |
---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
CAMPAIGN | اصلاح کننده پیشنهاد در سطح کمپین، در معیار سطح کمپین مشخص شده است. |
AD_GROUP | اصلاح کننده پیشنهاد در سطح گروه تبلیغاتی مشخص شده است (لغو می شود). |
HotelDateSelectionTypeInfo
معیار انتخاب تاریخ هتل (تاریخ پیشفرض در مقابل انتخاب کاربر).
HotelAdvanceBookingWindowInfo
ملاک تعداد روزهای قبل از اقامت رزرو در حال انجام است.
نمایندگی JSON |
---|
{
"minDays": string,
"maxDays": string
} |
فیلدها |
---|
minDays | string ( int64 format) پایان کم تعداد روزهای قبل از اقامت. |
maxDays | string ( int64 format) پایان بالای تعداد روزهای قبل از اقامت. |
HotelLengthOfStayInfo
ملاک مدت اقامت در هتل در شب.
نمایندگی JSON |
---|
{
"minNights": string,
"maxNights": string
} |
فیلدها |
---|
minNights | string ( int64 format) تعداد شب های اقامت کم است. |
maxNights | string ( int64 format) تعداد شب های اقامت زیاد است. |
HotelCheckInDayInfo
ملاک روز هفته که رزرو برای آن است.
نمایندگی JSON |
---|
{
"dayOfWeek": enum (DayOfWeek )
} |
فیلدها |
---|
dayOfWeek | enum ( DayOfWeek ) روز هفته. |
HotelCheckInDateRangeInfo
نمایندگی JSON |
---|
{
"startDate": string,
"endDate": string
} |
فیلدها |
---|
startDate | string تاریخ شروع در قالب YYYY-MM-DD. |
endDate | string تاریخ پایان در قالب YYYY-MM-DD. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-03-07 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-03-07 بهوقت ساعت هماهنگ جهانی."],[[["Represents an ad group bid modifier, allowing adjustments to bids when specific criteria are met."],["The bid modifier can be based on various factors such as hotel date selection, booking window, length of stay, check-in day, device, and check-in date range."],["Bid modifiers are applied as a percentage adjustment to the base bid, ranging from 0.1 to 10.0 (or 1.0 to 6.0 for PreferredContent), with 0 opting out of a device type."],["The bid modifier source can be either at the campaign level or overridden at the ad group level."],["Each bid modifier criterion has its own specific fields and values for defining the targeting criteria."]]],["This document details ad group bid modifiers, outlining their JSON representation, fields, and associated criteria. Key actions include defining a `bidModifier` within the range of 0.1-10.0, specifying its `resourceName`, `adGroup`, and `criterionId`. Information covered includes: `bidModifierSource` (CAMPAIGN or AD_GROUP), hotel-related criteria such as date selection, advance booking window, length of stay, check-in day, and check-in date range, and also device criterion. Each hotel criteria has details with its data type and value range.\n"]]