REST Resource: advertisers.adGroups

منبع: AdGroup

یک گروه تبلیغاتی منفرد مرتبط با یک آیتم خط.

نمایندگی JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
فیلدها
name

string

نام منبع گروه تبلیغاتی

advertiser Id

string ( int64 format)

شناسه منحصر به فرد تبلیغ کننده ای که گروه تبلیغاتی به آن تعلق دارد.

ad Group Id

string ( int64 format)

شناسه منحصر به فرد گروه تبلیغاتی. توسط سیستم تعیین شده است.

line Item Id

string ( int64 format)

شناسه منحصر به فرد مورد خطی که گروه تبلیغاتی به آن تعلق دارد.

display Name

string

نام نمایشی گروه تبلیغاتی

باید UTF-8 با حداکثر اندازه 255 بایت کدگذاری شود.

ad Group Format

enum ( AdGroupFormat )

فرمت تبلیغات در گروه تبلیغاتی

bid Strategy

object ( BiddingStrategy )

استراتژی پیشنهادی که توسط گروه تبلیغاتی استفاده می شود. فقط فیلد youtubeAndPartnersBid را می توان در استراتژی مناقصه استفاده کرد.

entity Status

enum ( EntityStatus )

کنترل می کند که آیا گروه تبلیغاتی می تواند بودجه و پیشنهاد خود را برای موجودی هزینه کند یا خیر.

اگر مورد خط اصلی گروه آگهی فعال نباشد، گروه آگهی نمی‌تواند بودجه خود را خرج کند حتی اگر وضعیت خودش ENTITY_STATUS_ACTIVE باشد.

targeting Expansion

object ( TargetingExpansionConfig )

تنظیمات هدف گیری بهینه گروه تبلیغات.

product Feed Data

object ( ProductFeedData )

تنظیمات فید محصول در این گروه تبلیغاتی.

AdGroupFormat

قالب گروه تبلیغاتی

Enums
AD_GROUP_FORMAT_UNSPECIFIED مقدار فرمت در این نسخه مشخص نشده یا ناشناخته است.
AD_GROUP_FORMAT_IN_STREAM تبلیغات درون جریانی
AD_GROUP_FORMAT_VIDEO_DISCOVERY تبلیغات درون فید.
AD_GROUP_FORMAT_BUMPER تبلیغات باپر.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM تبلیغات درون جریانی غیرقابل رد شدن
AD_GROUP_FORMAT_AUDIO تبلیغات صوتی در جریان غیرقابل رد شدن.
AD_GROUP_FORMAT_RESPONSIVE تبلیغات ریسپانسیو
AD_GROUP_FORMAT_REACH گروه‌های تبلیغاتی مؤثر ، از جمله تبلیغات درون جریانی و بامپر.
AD_GROUP_FORMAT_MASTHEAD آگهی سرصفحه ای که در قسمت بالای صفحه اصلی YouTube ظاهر می شود.

ProductFeedData

جزئیات خوراک محصول

نمایندگی JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
فیلدها
product Match Type

enum ( ProductMatchType )

نحوه انتخاب محصولات توسط فید محصول

product Match Dimensions[]

object ( ProductMatchDimension )

فهرستی از ابعاد مورد استفاده برای مطابقت با محصولات.

is Feed Disabled

boolean

آیا فید محصول از نمایش محصولات انصراف داده است یا خیر.

ProductMatchType

انواع روش های تطبیق محصولات

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED مشخص یا ناشناخته
PRODUCT_MATCH_TYPE_ALL_PRODUCTS همه محصولات مطابقت دارند.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS محصولات خاص انتخاب می شوند.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL محصولات را با برچسب سفارشی آنها مطابقت دهید.

ProductMatchDimension

ابعادی که برای مطابقت با محصولات استفاده می شود.

نمایندگی JSON 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
فیلدها
dimension میدان اتحادیه ابعاد و ارزشی که با آن محصول مطابقت دارد. dimension فقط می تواند یکی از موارد زیر باشد:
product Offer Id

string

شناسه پیشنهاد محصول برای مطابقت با محصولی با همان شناسه پیشنهاد.

custom Label

object ( CustomLabel )

برچسب سفارشی برای مطابقت با تمام محصولات با برچسب.

CustomLabel

کلید و ارزش یک برچسب سفارشی.

نمایندگی JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
فیلدها
key

enum ( CustomLabelKey )

کلید برچسب.

value

string

ارزش برچسب.

CustomLabelKey

کلید برچسب سفارشی

Enums
CUSTOM_LABEL_KEY_UNSPECIFIED مشخص یا ناشناخته
CUSTOM_LABEL_KEY_0 شاخص کلید 0.
CUSTOM_LABEL_KEY_1 شاخص کلید 1.
CUSTOM_LABEL_KEY_2 شاخص کلیدی 2.
CUSTOM_LABEL_KEY_3 شاخص کلید 3.
CUSTOM_LABEL_KEY_4 شاخص کلیدی 4.

روش ها

bulk List Ad Group Assigned Targeting Options

 گزینه های هدف گذاری اختصاص داده شده را برای چندین گروه تبلیغاتی در انواع هدف فهرست می کند.

get

 یک گروه تبلیغاتی دریافت می کند.

list

 گروه های تبلیغاتی را فهرست می کند.