SearchAds360Row

یک ردیف برگشتی از پرس و جو.

نمایندگی JSON 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
فیلدها
ad Group

object ( AdGroup )

گروه تبلیغاتی مورد اشاره در پرس و جو.

ad Group Ad

object ( AdGroupAd )

آگهی اشاره شده در پرس و جو.

ad Group Ad Effective Label

object ( AdGroupAdEffectiveLabel )

برچسب مؤثر آگهی گروه آگهی که در پرس و جو ارجاع شده است.

ad Group Ad Label

object ( AdGroupAdLabel )

برچسب آگهی گروه تبلیغاتی که در پرس و جو ارجاع داده شده است.

ad Group Asset

object ( AdGroupAsset )

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

ad Group Asset Set

object ( AdGroupAssetSet )

مجموعه دارایی گروه تبلیغاتی که در جستار به آن اشاره شده است.

ad Group Audience View

object ( AdGroupAudienceView )

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

ad Group Bid Modifier

object ( AdGroupBidModifier )

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

ad Group Criterion

object ( AdGroupCriterion )

معیاری که در پرس و جو به آن اشاره شده است.

ad Group Criterion Effective Label

object ( AdGroupCriterionEffectiveLabel )

برچسب موثر معیار گروه آگهی که در پرس و جو ارجاع شده است.

ad Group Criterion Label

object ( AdGroupCriterionLabel )

برچسب معیار گروه آگهی که در پرس و جو ارجاع داده شده است.

ad Group Effective Label

object ( AdGroupEffectiveLabel )

برچسب موثر گروه آگهی که در پرس و جو ارجاع داده شده است.

ad Group Label

object ( AdGroupLabel )

برچسب گروه تبلیغاتی که در پرس و جو ارجاع داده شده است.

age Range View

object ( AgeRangeView )

نمای محدوده سنی اشاره شده در پرس و جو.

asset

object ( Asset )

دارایی مورد اشاره در پرس و جو.

asset Group Asset

object ( AssetGroupAsset )

دارایی گروه دارایی که در پرس و جو به آن اشاره شده است.

asset Group Signal

object ( AssetGroupSignal )

سیگنال گروه دارایی که در پرس و جو ارجاع داده شده است.

asset Group Listing Group Filter

object ( AssetGroupListingGroupFilter )

فیلتر گروه فهرست گروه دارایی که در جستار به آن ارجاع داده شده است.

asset Group Top Combination View

object ( AssetGroupTopCombinationView )

نمای ترکیبی بالای گروه دارایی که در پرس و جو ارجاع داده شده است.

asset Group

object ( AssetGroup )

گروه دارایی مورد اشاره در پرس و جو.

asset Set Asset

object ( AssetSetAsset )

دارایی مجموعه دارایی که در پرس و جو به آن اشاره شده است.

asset Set

object ( AssetSet )

مجموعه دارایی مورد اشاره در پرس و جو.

bidding Strategy

object ( BiddingStrategy )

استراتژی مناقصه اشاره شده در پرس و جو.

campaign Budget

object ( CampaignBudget )

بودجه کمپین اشاره شده در پرس و جو.

campaign

object ( Campaign )

کمپین مورد اشاره در پرس و جو.

campaign Asset

object ( CampaignAsset )

دارایی کمپین اشاره شده در پرس و جو.

campaign Asset Set

object ( CampaignAssetSet )

مجموعه دارایی کمپین مورد اشاره در پرس و جو.

campaign Audience View

object ( CampaignAudienceView )

نمای مخاطب کمپین که در پرس و جو به آن اشاره شده است.

campaign Criterion

object ( CampaignCriterion )

معیار کمپین مورد اشاره در پرس و جو.

campaign Effective Label

object ( CampaignEffectiveLabel )

برچسب موثر کمپین که در پرس و جو به آن اشاره شده است.

campaign Label

object ( CampaignLabel )

برچسب کمپین مورد اشاره در پرس و جو.

cart Data Sales View

object ( CartDataSalesView )

نمای فروش داده های سبد خرید که در پرس و جو ارجاع شده است.

audience

object ( Audience )

مخاطبی که در پرس و جو به آن اشاره شده است.

conversion Action

object ( ConversionAction )

عمل تبدیلی که در پرس و جو به آن اشاره شده است.

conversion Custom Variable

object ( ConversionCustomVariable )

متغیر سفارشی تبدیل که در پرس و جو ارجاع داده شده است.

customer

object ( Customer )

مشتری در پرس و جو به آن اشاره کرد.

customer Asset

object ( CustomerAsset )

دارایی مشتری اشاره شده در پرس و جو.

customer Asset Set

object ( CustomerAssetSet )

مجموعه دارایی مشتری که در پرس و جو به آن اشاره شده است.

accessible Bidding Strategy

object ( AccessibleBiddingStrategy )

استراتژی مناقصه قابل دسترس که در پرس و جو به آن اشاره شده است.

customer Client

object ( CustomerClient )

مشتری مشتری در پرس و جو به آن اشاره کرد.

dynamic Search Ads Search Term View

object ( DynamicSearchAdsSearchTermView )

مشاهده عبارت جستجوی تبلیغات جستجوی پویا که در پرس و جو ارجاع شده است.

gender View

object ( GenderView )

نمای جنسیتی اشاره شده در پرس و جو.

geo Target Constant

object ( GeoTargetConstant )

ثابت هدف جغرافیایی که در پرس و جو ارجاع داده شده است.

keyword View

object ( KeywordView )

نمای کلمه کلیدی مورد اشاره در پرس و جو.

label

object ( Label )

برچسب اشاره شده در پرس و جو.

language Constant

object ( LanguageConstant )

ثابت زبان مورد اشاره در پرس و جو.

location View

object ( LocationView )

نمای مکان اشاره شده در پرس و جو.

product Bidding Category Constant

object ( ProductBiddingCategoryConstant )

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

product Group View

object ( ProductGroupView )

نمای گروه محصول اشاره شده در پرس و جو.

shopping Performance View

object ( ShoppingPerformanceView )

نمای عملکرد خرید اشاره شده در پرس و جو.

user List

object ( UserList )

لیست کاربری که در پرس و جو به آن اشاره شده است.

user Location View

object ( UserLocationView )

نمای موقعیت مکانی کاربر که در پرس و جو به آن اشاره شده است.

webpage View

object ( WebpageView )

نمای صفحه وب مورد اشاره در پرس و جو.

visit

object ( Visit )

بازدید سطح رویداد که در پرس و جو به آن اشاره شده است.

conversion

object ( Conversion )

تبدیل سطح رویداد که در پرس و جو ارجاع شده است.

metrics

object ( Metrics )

معیارها

segments

object ( Segments )

بخش ها

custom Columns[]

object ( Value )

ستون های سفارشی

AdGroup

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

نمایندگی JSON 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
فیلدها
resource Name

string

نام منبع گروه تبلیغاتی نام منابع گروه تبلیغات به شکل زیر است:

customers/{customerId}/adGroups/{ad_group_id}

status

enum ( AdGroupStatus )

وضعیت گروه تبلیغاتی

type

enum ( AdGroupType )

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

ad Rotation Mode

enum ( AdGroupAdRotationMode )

حالت چرخش تبلیغات گروه تبلیغاتی.

creation Time

string

مهر زمانی که این گروه تبلیغاتی ایجاد شد. مُهر زمانی در منطقه زمانی مشتری و در قالب «سالم-MM-dd HH:mm:ss» است.

targeting Setting

object ( TargetingSetting )

تنظیم برای هدف قرار دادن ویژگی های مرتبط.

labels[]

string

نام منابع برچسب های پیوست شده به این گروه تبلیغاتی.

effective Labels[]

string

نام منابع برچسب های موثر متصل به این گروه تبلیغاتی. یک برچسب موثر برچسبی است که به ارث رسیده یا مستقیماً به این گروه تبلیغاتی اختصاص داده شده است.

engine Id

string

شناسه گروه تبلیغات در حساب موتور خارجی. این فیلد فقط برای حساب غیر Google Ads است، به عنوان مثال، Yahoo Japan، Microsoft، Baidu و غیره. برای نهاد Google Ads، به جای آن از "adGroup.id" استفاده کنید.

start Date

string

تاریخی که این گروه تبلیغاتی شروع به ارائه تبلیغات می کند. به‌طور پیش‌فرض، گروه تبلیغات اکنون شروع می‌شود یا تاریخ شروع گروه تبلیغات، هر کدام که دیرتر باشد. اگر این فیلد تنظیم شده باشد، گروه تبلیغاتی از ابتدای تاریخ مشخص شده در منطقه زمانی مشتری شروع می شود. این فیلد فقط برای حساب‌های تبلیغاتی مایکروسافت و گیت‌وی فیس‌بوک در دسترس است.

قالب: YYYY-MM-DD مثال: 2019-03-14

end Date

string

تاریخ پایان ارائه تبلیغات توسط گروه تبلیغاتی. به طور پیش فرض، گروه تبلیغات در تاریخ پایان گروه تبلیغات به پایان می رسد. اگر این قسمت تنظیم شده باشد، گروه تبلیغات در پایان تاریخ مشخص شده در منطقه زمانی مشتری به پایان می رسد. این فیلد فقط برای حساب‌های تبلیغاتی مایکروسافت و گیت‌وی فیس‌بوک در دسترس است.

قالب: YYYY-MM-DD مثال: 2019-03-14

language Code

string

زبان تبلیغات و کلمات کلیدی در یک گروه تبلیغاتی. این فیلد فقط برای حساب‌های تبلیغاتی مایکروسافت در دسترس است. جزئیات بیشتر: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

last Modified Time

string

تاریخ آخرین تغییر این گروه تبلیغاتی. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.

id

string ( int64 format)

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

name

string

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

این قسمت الزامی است و نباید هنگام ایجاد گروه های تبلیغاتی جدید خالی باشد.

باید کمتر از 255 نویسه تمام عرض UTF-8 داشته باشد.

نباید دارای هیچ نویسه تهی (نقطه کد 0x0)، خوراک خط NL (نقطه کد 0xA) یا نویسه برگشتی (نقطه کد 0xD) باشد.

cpc Bid Micros

string ( int64 format)

حداکثر پیشنهاد CPC (هزینه به ازای هر کلیک).

engine Status

enum ( AdGroupEngineStatus )

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

AdGroupStatus

وضعیت های احتمالی یک گروه تبلیغاتی

Enums
UNSPECIFIED وضعیت مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

ENABLED گروه تبلیغات فعال است.
PAUSED گروه تبلیغات متوقف شده است.
REMOVED گروه تبلیغات حذف می شود.

AdGroupType

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

Enums
UNSPECIFIED نوع آن مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

SEARCH_STANDARD نوع گروه تبلیغاتی پیش‌فرض برای کمپین‌های جستجو.
DISPLAY_STANDARD نوع گروه تبلیغاتی پیش‌فرض برای کمپین‌های نمایش.
SHOPPING_PRODUCT_ADS نوع گروه تبلیغاتی برای کمپین های خرید که تبلیغات محصول استاندارد را ارائه می دهند.
SHOPPING_SHOWCASE_ADS نوع برای گروه‌های تبلیغاتی که محدود به ارائه تبلیغات ویترینی یا Merchant در نتایج خرید هستند.
HOTEL_ADS نوع گروه تبلیغاتی پیش‌فرض برای کمپین‌های هتل.
SHOPPING_SMART_ADS نوع گروه های تبلیغاتی در کمپین های خرید هوشمند.
VIDEO_BUMPER تبلیغات ویدیویی کوتاه غیرقابل رد شدن در جریان.
VIDEO_TRUE_VIEW_IN_STREAM تبلیغات ویدیویی TrueView (قابل رد شدن) در جریان.
VIDEO_TRUE_VIEW_IN_DISPLAY تبلیغات ویدیویی TrueView در نمایشگر.
VIDEO_NON_SKIPPABLE_IN_STREAM تبلیغات ویدیویی در جریان غیرقابل رد شدن
VIDEO_OUTSTREAM تبلیغات ویدیویی خارج از جریان
SEARCH_DYNAMIC_ADS نوع گروه آگهی برای گروه های تبلیغاتی تبلیغات جستجوی پویا.
SHOPPING_COMPARISON_LISTING_ADS نوع گروه های تبلیغاتی در کمپین های فهرست مقایسه خرید.
PROMOTED_HOTEL_ADS نوع گروه تبلیغاتی برای گروه‌های تبلیغاتی هتل تبلیغاتی.
VIDEO_RESPONSIVE گروه های تبلیغاتی واکنشگرا ویدیویی
VIDEO_EFFICIENT_REACH گروه های تبلیغاتی با دسترسی کارآمد ویدیویی.
SMART_CAMPAIGN_ADS نوع گروه تبلیغاتی برای کمپین های هوشمند.
TRAVEL_ADS نوع گروه تبلیغاتی برای کمپین های مسافرتی.

AdGroupAdRotationMode

حالت های احتمالی چرخش تبلیغات یک گروه تبلیغاتی.

Enums
UNSPECIFIED حالت چرخش تبلیغات مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

OPTIMIZE تبلیغات گروه تبلیغات را بر اساس کلیک یا تبدیل بهینه کنید.
ROTATE_FOREVER برای همیشه یکنواخت بچرخانید.

AdGroupEngineStatus

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AD_GROUP_ELIGIBLE

منسوخ شده است. استفاده نکنید.

AD_GROUP_EXPIRED هیچ تبلیغی برای این گروه تبلیغاتی اجرا نمی شود، زیرا تاریخ پایان گروه آگهی به پایان رسیده است.
AD_GROUP_REMOVED گروه تبلیغاتی حذف شده است.
AD_GROUP_DRAFT هیچ تبلیغی برای این گروه تبلیغاتی اجرا نمی شود زیرا گروه تبلیغات مرتبط هنوز در فرم پیش نویس است.
AD_GROUP_PAUSED گروه تبلیغات متوقف شده است.
AD_GROUP_SERVING گروه تبلیغاتی فعال است و در حال حاضر در حال ارائه تبلیغات است.
AD_GROUP_SUBMITTED گروه تبلیغات ارسال شده است (وضعیت میراث تبلیغات مایکروسافت بینگ).
CAMPAIGN_PAUSED هیچ تبلیغی برای این گروه تبلیغاتی اجرا نمی شود، زیرا کمپین متوقف شده است.
ACCOUNT_PAUSED هیچ تبلیغی برای این گروه تبلیغاتی اجرا نمی شود، زیرا حساب متوقف شده است.

TargetingSetting

تنظیمات برای ویژگی های مرتبط با هدف، در سطوح کمپین و گروه تبلیغاتی. برای جزئیات بیشتر در مورد تنظیم هدف، از https://support.google.com/google-ads/answer/7365594 دیدن کنید

نمایندگی JSON 
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
فیلدها
target Restrictions[]

object ( TargetRestriction )

تنظیم هر هدف-بعد برای محدود کردن دسترسی کمپین یا گروه تبلیغاتی شما.

محدودیت هدف

فهرست تنظیمات هدف گذاری در هر بعد هدف.

نمایندگی JSON 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
فیلدها
targeting Dimension

enum ( TargetingDimension )

بعد هدف گیری که این تنظیمات روی آن اعمال می شود.

bid Only

boolean

نشان می دهد که آیا تبلیغات خود را محدود کنید تا فقط برای معیارهایی که برای این targetingDimension انتخاب کرده اید نشان داده شود یا اینکه همه مقادیر را برای این targetingDimension هدف قرار دهید و تبلیغات را بر اساس هدف شما در سایر TargetingDimensions نشان دهید. مقدار true به این معنی است که این معیارها فقط تعدیل‌کننده‌های پیشنهاد قیمت را اعمال می‌کنند و بر هدف‌گذاری تأثیر نمی‌گذارند. مقدار false به این معنی است که این معیارها هدف گذاری و همچنین اعمال اصلاح کننده قیمت را محدود می کنند.

بعد هدف

Enum ابعاد هدف گیری احتمالی را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
KEYWORD معیارهای کلمه کلیدی، به عنوان مثال، "کروز مریخ". KEYWORD ممکن است به عنوان یک بعد پیشنهاد سفارشی استفاده شود. کلمات کلیدی همیشه یک بعد هدف هستند، بنابراین ممکن است به عنوان یک بعد "ALL" هدف با TargetRestriction تنظیم نشوند.
AUDIENCE معیارهای مخاطب، که شامل لیست کاربر، علاقه کاربر، تمایل سفارشی و سفارشی در بازار است.
TOPIC معیارهای موضوع برای هدف قرار دادن دسته‌های محتوا، به عنوان مثال، «دسته::حیوانات>حیوانات خانگی» که برای هدف‌یابی نمایش و ویدیو استفاده می‌شود.
GENDER معیارهای هدف قرار دادن جنسیت
AGE_RANGE معیارهای هدف گذاری محدوده سنی
PLACEMENT معیارهای قرارگیری، که شامل وب‌سایت‌هایی مانند «www.flowers4sale.com» و همچنین برنامه‌های تلفن همراه، دسته‌های برنامه‌های تلفن همراه، ویدیوهای YouTube و کانال‌های YouTube است.
PARENTAL_STATUS معیارهای هدف قرار دادن وضعیت والدین.
INCOME_RANGE معیارهای هدف گذاری محدوده درآمدی

AdGroupAd

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

نمایندگی JSON 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
فیلدها
resource Name

string

نام منبع آگهی نام منابع تبلیغاتی گروه تبلیغات به شکل زیر است:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum ( AdGroupAdStatus )

وضعیت آگهی.

ad

object ( Ad )

آگهی

creation Time

string

مهر زمانی که این adGroupAd ایجاد شد. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.

labels[]

string

نام منابع برچسب های پیوست شده به این آگهی گروه تبلیغاتی.

effective Labels[]

string

نام منابع برچسب های موثر پیوست شده به این آگهی. یک برچسب مؤثر برچسبی است که به ارث برده شده یا مستقیماً به این آگهی اختصاص داده شده است.

engine Id

string

شناسه آگهی در حساب موتور خارجی. این فیلد فقط برای حساب Search Ads 360 است، به عنوان مثال، Yahoo Japan، Microsoft، Baidu و غیره. برای موجودیت غیر جستجوی Ads 360، به جای آن از "adGroupAd.ad.id" استفاده کنید.

engine Status

enum ( AdGroupAdEngineStatus )

وضعیت اضافی آگهی در حساب موتور خارجی. وضعیت‌های احتمالی (بسته به نوع حساب خارجی) شامل فعال، واجد شرایط، در حال بررسی و غیره است.

last Modified Time

string

زمانی که این آگهی گروه تبلیغاتی آخرین بار تغییر کرده است. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.

AdGroupAdStatus

وضعیت های ممکن یک AdGroupAd.

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

ENABLED تبلیغ گروه تبلیغاتی فعال است.
PAUSED تبلیغ گروه تبلیغاتی متوقف شده است.
REMOVED آگهی گروه تبلیغات حذف می شود.

نوع تبلیغ

انواع احتمالی یک آگهی

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

TEXT_AD آگهی یک تبلیغ متنی است.
EXPANDED_TEXT_AD آگهی یک تبلیغ متنی گسترده است.
CALL_ONLY_AD آگهی فقط یک تماس است.
EXPANDED_DYNAMIC_SEARCH_AD تبلیغ یک تبلیغ جستجوی پویا گسترده است.
HOTEL_AD آگهی آگهی هتل است.
SHOPPING_SMART_AD این تبلیغ یک آگهی خرید هوشمند است.
SHOPPING_PRODUCT_AD آگهی یک آگهی خرید استاندارد است.
VIDEO_AD تبلیغ یک تبلیغ ویدیویی است.
GMAIL_AD این تبلیغ یک تبلیغ جیمیل است.
IMAGE_AD این تبلیغ یک تبلیغ تصویری است.
RESPONSIVE_SEARCH_AD آگهی یک آگهی جستجوی واکنشگرا است.
LEGACY_RESPONSIVE_DISPLAY_AD این تبلیغ یک تبلیغ نمایشی پاسخگو قدیمی است.
APP_AD تبلیغ یک تبلیغ اپلیکیشن است.
LEGACY_APP_INSTALL_AD این تبلیغ یک تبلیغ نصب برنامه قدیمی است.
RESPONSIVE_DISPLAY_AD تبلیغ یک تبلیغ نمایشی واکنش گرا است.
LOCAL_AD آگهی یک آگهی محلی است.
HTML5_UPLOAD_AD این تبلیغ یک آگهی آپلود نمایشی با نوع محصول HTML5_UPLOAD_AD است.
DYNAMIC_HTML5_AD این تبلیغ یک آگهی آپلود نمایشی با یکی از انواع محصول DYNAMIC_HTML5_* است.
APP_ENGAGEMENT_AD تبلیغ یک تبلیغ تعامل با اپلیکیشن است.
SHOPPING_COMPARISON_LISTING_AD این آگهی یک آگهی فهرست مقایسه خرید است.
VIDEO_BUMPER_AD تبلیغ ویدیویی بامپر.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD تبلیغ ویدیویی غیرقابل رد شدن در جریان.
VIDEO_OUTSTREAM_AD تبلیغ ویدیویی خارج از جریان
VIDEO_TRUEVIEW_DISCOVERY_AD تبلیغ ویدیویی TrueView در نمایش.
VIDEO_TRUEVIEW_IN_STREAM_AD تبلیغ ویدیویی TrueView در جریان.
VIDEO_RESPONSIVE_AD تبلیغ ویدئویی واکنشگرا
SMART_CAMPAIGN_AD تبلیغات کمپین هوشمند
APP_PRE_REGISTRATION_AD آگهی پیش ثبت نام جهانی برنامه.
DISCOVERY_MULTI_ASSET_AD تبلیغ چند دارایی Discovery.
TRAVEL_AD آگهی سفر.
DISCOVERY_VIDEO_RESPONSIVE_AD تبلیغ پاسخگو ویدیوی اکتشافی.
MULTIMEDIA_AD تبلیغ چند رسانه ای

SearchAds360TextAdInfo

یک تبلیغ متنی Search Ads 360.

نمایندگی JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
فیلدها
headline

string

تیتر آگهی.

description1

string

خط اول توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

display Url

string

URL نمایش داده شده آگهی.

display Mobile Url

string

نشانی اینترنتی موبایل نمایش داده شده آگهی.

ad Tracking Id

string ( int64 format)

شناسه پیگیری آگهی

SearchAds360ExpandedTextAdInfo

یک تبلیغ متنی توسعه یافته Search Ads 360.

نمایندگی JSON 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
فیلدها
headline

string

تیتر آگهی.

headline2

string

تیتر دوم آگهی.

headline3

string

عنوان سوم آگهی.

description1

string

خط اول توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

path1

string

نوشتاری به نشانی اینترنتی قابل مشاهده که به‌طور خودکار ایجاد می‌شود با یک جداکننده اضافه شد.

path2

string

متن با یک جداکننده به path1 اضافه شد.

ad Tracking Id

string ( int64 format)

شناسه پیگیری آگهی

SearchAds360ResponsiveSearchAdInfo

یک تبلیغ جستجوی پاسخگو Search Ads 360.

نمایندگی JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
فیلدها
headlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود.

path1

string

نوشتاری به نشانی اینترنتی قابل مشاهده که به‌طور خودکار ایجاد می‌شود با یک جداکننده اضافه شد.

path2

string

متن با یک جداکننده به path1 اضافه شد.

ad Tracking Id

string ( int64 format)

شناسه پیگیری آگهی

AdTextAsset

دارایی متنی که در یک آگهی استفاده می شود.

نمایندگی JSON 
{
  "text": string
}
فیلدها
text

string

متن دارایی

SearchAds360ProductAdInfo

این نوع هیچ فیلدی ندارد.

تبلیغ محصول Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

یک تبلیغ جستجوی پویا گسترده

نمایندگی JSON 
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
فیلدها
description1

string

خط اول توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

ad Tracking Id

string ( int64 format)

شناسه پیگیری آگهی

AdGroupAdEngineStatus

وضعیت موتور AdGroupAd را برمی شمارد.

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AD_GROUP_AD_ELIGIBLE

منسوخ شده است. استفاده نکنید.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN بایدو: خلاقیت تایید نشد.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: URL موبایل در حال بررسی است.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: Creative در دستگاه تلفن همراه نامعتبر است، اما در رایانه رومیزی معتبر است.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Creative برای فعال سازی آماده است.
AD_GROUP_AD_NOT_REVIEWED بایدو: خلاق بررسی نشد.
AD_GROUP_AD_ON_HOLD

منسوخ شده است. استفاده نکنید. قبلا توسط Gemini استفاده شده بود

AD_GROUP_AD_PAUSED خلاقیت موقتاً متوقف شده است.
AD_GROUP_AD_REMOVED خلاق حذف شده است.
AD_GROUP_AD_PENDING_REVIEW Creative در انتظار بررسی است.
AD_GROUP_AD_UNDER_REVIEW Creative در دست بررسی است.
AD_GROUP_AD_APPROVED خلاق تایید شده است.
AD_GROUP_AD_DISAPPROVED خلاقیت تایید نشده است.
AD_GROUP_AD_SERVING خلاق در خدمت است.
AD_GROUP_AD_ACCOUNT_PAUSED خلاقیت موقتاً متوقف شده است زیرا حساب موقتاً متوقف شده است.
AD_GROUP_AD_CAMPAIGN_PAUSED Creative به دلیل توقف موقت کمپین متوقف شده است.
AD_GROUP_AD_AD_GROUP_PAUSED خلاقیت موقتاً متوقف شده است زیرا گروه آگهی متوقف شده است.

AdGroupAdEffectiveLabel

رابطه بین یک تبلیغ گروه تبلیغاتی و یک برچسب موثر. یک برچسب مؤثر برچسبی است که به ارث رسیده یا مستقیماً به این آگهی گروه تبلیغاتی اختصاص داده شده است.

نمایندگی JSON 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resource Name

string

نام منبع برچسب مؤثر آگهی گروه آگهی. نام‌های منابع برچسب مؤثر آگهی گروه آگهی به این شکل است: customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}

ad Group Ad

string

آگهی گروه تبلیغاتی که برچسب موثر به آن چسبانده شده است.

label

string

برچسب موثر اختصاص داده شده به تبلیغ گروه تبلیغاتی.

owner Customer Id

string ( int64 format)

شناسه مشتری که دارای برچسب موثر است.

AdGroupAdLabel

رابطه بین یک تبلیغ گروه تبلیغاتی و یک برچسب.

نمایندگی JSON 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resource Name

string

نام منبع برچسب آگهی گروه تبلیغاتی. نام منابع برچسب آگهی گروه تبلیغات به شکل زیر است: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

ad Group Ad

string

آگهی گروه تبلیغاتی که برچسب به آن چسبانده شده است.

label

string

برچسبی که به تبلیغ گروه تبلیغاتی اختصاص داده شده است.

owner Customer Id

string ( int64 format)

شناسه مشتری مالک برچسب.

AdGroupAsset

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

نمایندگی JSON 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
فیلدها
resource Name

string

نام منبع دارایی گروه تبلیغات. نام منابع AdGroupAsset به شکل زیر است:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

ad Group

string

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

asset

string

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

status

enum ( AssetLinkStatus )

وضعیت دارایی گروه تبلیغات.

AssetLinkStatus

فهرستی که وضعیت یک پیوند دارایی را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ENABLED پیوند دارایی فعال است.
REMOVED پیوند دارایی حذف شده است.
PAUSED پیوند دارایی متوقف شده است.

AdGroupAssetSet

AdGroupAssetSet پیوند بین یک گروه تبلیغاتی و یک مجموعه دارایی است. ایجاد AdGroupAssetSet یک مجموعه دارایی را با یک گروه تبلیغاتی پیوند می دهد.

نمایندگی JSON 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
فیلدها
resource Name

string

نام منبع مجموعه دارایی گروه تبلیغات. نام منابع مجموعه دارایی گروه تبلیغات به شکل زیر است:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

ad Group

string

گروه تبلیغاتی که این مجموعه دارایی به آن مرتبط است.

asset Set

string

مجموعه دارایی که به گروه تبلیغاتی مرتبط است.

status

enum ( AssetSetLinkStatus )

وضعیت مجموعه دارایی گروه تبلیغات. فقط خواندنی

AssetSetLinkStatus

وضعیت های احتمالی پیوند بین مجموعه دارایی و ظرف آن.

Enums
UNSPECIFIED وضعیت مشخص نشده است.
UNKNOWN مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است.
ENABLED ارتباط بین مجموعه دارایی و محفظه آن فعال است.
REMOVED ارتباط بین مجموعه دارایی و ظرف آن حذف شده است.

AdGroupAudienceView

نمای مخاطب گروه تبلیغاتی شامل داده‌های عملکرد از علایق و فهرست‌های بازاریابی مجدد برای تبلیغات شبکه نمایش و شبکه YouTube، و فهرست‌های بازاریابی مجدد برای تبلیغات جستجو (RLSA)، جمع‌آوری‌شده در سطح مخاطب است.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

نام منبع نمای مخاطب گروه تبلیغات. نام منابع مشاهده مخاطبان گروه تبلیغات به شکل زیر است:

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

یک اصلاح کننده پیشنهاد گروه تبلیغاتی را نشان می دهد.

نمایندگی JSON 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
فیلدها
resource Name

string

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

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bid Modifier

number

اصلاح کننده پیشنهاد زمانی که معیار مطابقت دارد. اصلاح کننده باید در محدوده: 0.1 - 10.0 باشد. محدوده 1.0 - 6.0 برای PreferredContent است. از 0 برای انصراف از نوع دستگاه استفاده کنید.

criterion میدان اتحادیه . معیار این اصلاح کننده پیشنهاد گروه آگهی.

در عملیات ایجاد شروع در V5 مورد نیاز است. criterion فقط می تواند یکی از موارد زیر باشد:

device

object ( DeviceInfo )

یک معیار دستگاه

اطلاعات دستگاه

یک معیار دستگاه

نمایندگی JSON 
{
  "type": enum (Device)
}
فیلدها
type

enum ( Device )

نوع دستگاه.

دستگاه

دستگاه‌های Google Ads را برای هدف‌یابی برمی‌شمارد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
MOBILE دستگاه های تلفن همراه با مرورگر کامل.
TABLET تبلت با مرورگر کامل
DESKTOP کامپیوترها
CONNECTED_TV تلویزیون های هوشمند و کنسول های بازی.
OTHER انواع دستگاه های دیگر

AdGroup Criterion

یک معیار گروه تبلیغاتی گزارش adGroupCriterion فقط معیارهایی را برمی‌گرداند که به صراحت به گروه آگهی اضافه شده‌اند.

نمایندگی JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
فیلدها
resource Name

string

نام منبع معیار گروه آگهی. نام منابع معیار گروه تبلیغات به شکل زیر است:

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creation Time

string

مهر زمانی که این معیار گروه آگهی ایجاد شد. مُهر زمانی در منطقه زمانی مشتری و در قالب «سالم-MM-dd HH:mm:ss» است.

status

enum ( AdGroupCriterionStatus )

وضعیت معیار.

این وضعیت موجودیت معیار گروه آگهی است که توسط مشتری تنظیم شده است. توجه: گزارش‌های UI ممکن است حاوی اطلاعات بیشتری باشد که بر واجد شرایط بودن یک معیار برای اجرا تأثیر می‌گذارد. در برخی موارد، معیاری که در API حذف شده است همچنان می‌تواند در رابط کاربری فعال نشان داده شود. به عنوان مثال، کمپین‌ها به‌طور پیش‌فرض به کاربران در تمام محدوده‌های سنی نشان داده می‌شوند، مگر اینکه حذف شوند. رابط کاربری هر محدوده سنی را به عنوان "فعال" نشان می دهد، زیرا آنها واجد شرایط دیدن تبلیغات هستند. اما AdGroupCriterion.status "حذف شده" را نشان می دهد، زیرا هیچ معیار مثبتی اضافه نشده است.

quality Info

object ( QualityInfo )

اطلاعات مربوط به کیفیت معیار.

type

enum ( CriterionType )

نوع معیار.

labels[]

string

نام منابع برچسب های پیوست شده به این معیار گروه تبلیغاتی.

effective Labels[]

string

نام منابع برچسب های موثر پیوست شده به این معیار گروه تبلیغاتی. یک برچسب مؤثر برچسبی است که به ارث رسیده یا مستقیماً به این معیار گروه تبلیغاتی اختصاص داده شده است.

position Estimates

object ( PositionEstimates )

تخمین پیشنهادهای معیار در موقعیت های مختلف.

final Urls[]

string

لیست URL های نهایی ممکن پس از همه تغییر مسیرهای بین دامنه ای برای تبلیغ.

engine Id

string

شناسه معیار گروه آگهی در حساب موتور خارجی. این فیلد فقط برای حساب غیر Google Ads است، به عنوان مثال، Yahoo Japan، Microsoft، Baidu و غیره. برای موجودیت Google Ads، به جای آن از "adGroupCriterion.criterion_id" استفاده کنید.

last Modified Time

string

زمانی که این معیار گروه آگهی آخرین بار اصلاح شد. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.

criterion Id

string ( int64 format)

شناسه معیار.

ad Group

string

گروه تبلیغاتی که معیار به آن تعلق دارد.

negative

boolean

آیا برای هدف قرار دادن ( false ) یا حذف ( true ) معیار.

این میدان تغییر ناپذیر است. برای تغییر یک معیار از مثبت به منفی، آن را حذف کنید و دوباره اضافه کنید.

bid Modifier

number

اصلاح کننده پیشنهاد زمانی که معیار مطابقت دارد. اصلاح کننده باید در محدوده: 0.1 - 10.0 باشد. بیشتر انواع معیارهای قابل هدف از اصلاح کننده ها پشتیبانی می کنند.

cpc Bid Micros

string ( int64 format)

پیشنهاد CPC (هزینه به ازای هر کلیک).

effective Cpc Bid Micros

string ( int64 format)

پیشنهاد CPC موثر (هزینه به ازای هر کلیک).

engine Status

enum ( AdGroupCriterionEngineStatus )

معیار وضعیت موتور برای گروه آگهی.

final Url Suffix

string

الگوی URL برای الحاق پارامترها به URL نهایی.

tracking Url Template

string

الگوی URL برای ساخت URL ردیابی.

criterion میدان اتحادیه . معیار گروه تبلیغاتی

دقیقاً یکی باید تنظیم شود. criterion فقط می تواند یکی از موارد زیر باشد:

keyword

object ( KeywordInfo )

کلمه کلیدی

listing Group

object ( ListingGroupInfo )

گروه لیست.

age Range

object ( AgeRangeInfo )

محدوده سنی.

gender

object ( GenderInfo )

جنسیت.

user List

object ( UserListInfo )

لیست کاربر.

webpage

object ( WebpageInfo )

صفحه وب

location

object ( LocationInfo )

مکان.

AdGroupCriterionStatus

وضعیت های ممکن یک AdGroupCriterion.

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

ENABLED معیار گروه آگهی فعال است.
PAUSED معیار گروه آگهی متوقف شده است.
REMOVED معیار گروه آگهی حذف شده است.

QualityInfo

ظرفی برای اطلاعات کیفیت معیار گروه آگهی.

نمایندگی JSON 
{
  "qualityScore": integer
}
فیلدها
quality Score

integer

نمره کیفیت.

اگر Google اطلاعات کافی برای تعیین مقدار نداشته باشد، ممکن است این فیلد پر نشود.

CriterionType

Enum انواع معیارهای ممکن را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
KEYWORD کلمه کلیدی، به عنوان مثال، "کروز مریخ".
PLACEMENT مکان، همچنین به عنوان وب سایت شناخته می شود، برای مثال، "www.flowers4sale.com"
MOBILE_APP_CATEGORY دسته بندی برنامه های موبایل برای هدف قرار دادن.
MOBILE_APPLICATION برنامه های موبایل برای هدف قرار دادن.
DEVICE دستگاه هایی برای هدف قرار دادن
LOCATION مکان های مورد نظر
LISTING_GROUP لیست کردن گروه ها برای هدف.
AD_SCHEDULE جدول زمانی تبلیغات
AGE_RANGE محدوده سنی.
GENDER جنسیت.
INCOME_RANGE محدوده درآمد
PARENTAL_STATUS وضعیت والدین.
YOUTUBE_VIDEO ویدیوی یوتیوب.
YOUTUBE_CHANNEL کانال یوتیوب.
USER_LIST لیست کاربران.
PROXIMITY نزدیکی.
TOPIC هدف موضوعی در شبکه نمایش (به عنوان مثال، "حیوانات خانگی و حیوانات").
LISTING_SCOPE دامنه فهرست به هدف.
LANGUAGE زبان.
IP_BLOCK IPBlock.
CONTENT_LABEL برچسب محتوا برای حذف دسته.
CARRIER حامل.
USER_INTEREST دسته ای که کاربر به آن علاقه مند است.
WEBPAGE معیار صفحه وب برای تبلیغات جستجوی پویا
OPERATING_SYSTEM_VERSION نسخه سیستم عامل.
APP_PAYMENT_MODEL مدل پرداخت اپلیکیشن
MOBILE_DEVICE دستگاه موبایل.
CUSTOM_AFFINITY قرابت سفارشی
CUSTOM_INTENT قصد سفارشی
LOCATION_GROUP گروه مکان.
CUSTOM_AUDIENCE مخاطب سفارشی
COMBINED_AUDIENCE مخاطب ترکیبی
KEYWORD_THEME تم کلمه کلیدی کمپین هوشمند
AUDIENCE مخاطب
LOCAL_SERVICE_ID شناسه سرویس تبلیغات خدمات محلی.
BRAND نام تجاری
BRAND_LIST لیست برند
LIFE_EVENT رویداد زندگی

تخمین موقعیت

تخمین پیشنهادهای معیار در موقعیت های مختلف.

نمایندگی JSON 
{
  "topOfPageCpcMicros": string
}
فیلدها
top Of Page Cpc Micros

string ( int64 format)

تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در بالای صفحه اول نتایج جستجو.

AdGroupCriterionEngineStatus

وضعیت موتور AdGroupCriterion را برمی شمارد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AD_GROUP_CRITERION_ELIGIBLE

منسوخ شده است. استفاده نکنید.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: قیمت پیشنهادی یا کیفیت خیلی پایین است که نمایش داده نمی شود.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: به دلیل حجم کم جستجو توسط بایدو متوقف شد.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: URL موبایل در حال بررسی است.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: صفحه فرود برای یک دستگاه نامعتبر است، در حالی که صفحه فرود برای دستگاه دیگر معتبر است.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: کلمه کلیدی توسط مدیریت حساب بایدو ایجاد و متوقف شده است و اکنون برای فعال کردن آن آماده است.
AD_GROUP_CRITERION_UNDER_REVIEW بایدو: در حال بررسی توسط بایدو. جمینی: معیار در دست بررسی.
AD_GROUP_CRITERION_NOT_REVIEWED بایدو: معیاری که باید بررسی شود.
AD_GROUP_CRITERION_ON_HOLD

منسوخ شده است. استفاده نکنید. قبلا توسط Gemini استفاده شده بود

AD_GROUP_CRITERION_PENDING_REVIEW Y!J: معیار در انتظار بررسی
AD_GROUP_CRITERION_PAUSED معیار متوقف شده است.
AD_GROUP_CRITERION_REMOVED معیار حذف شده است.
AD_GROUP_CRITERION_APPROVED معیار تایید شده است.
AD_GROUP_CRITERION_DISAPPROVED معیار رد شده است.
AD_GROUP_CRITERION_SERVING معیار فعال و در حال خدمت است.
AD_GROUP_CRITERION_ACCOUNT_PAUSED از زمانی که حساب متوقف شده است، معیار موقتاً متوقف شده است.

KeywordInfo

معیار کلمه کلیدی

نمایندگی JSON 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
فیلدها
match Type

enum ( KeywordMatchType )

نوع مطابقت کلمه کلیدی.

text

string

متن کلمه کلیدی (حداکثر 80 کاراکتر و 10 کلمه).

KeywordMatchType

انواع تطابق کلمات کلیدی ممکن

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
EXACT مطابقت دقیق
PHRASE مطابقت عبارت
BROAD مسابقه گسترده

ListingGroupInfo

یک معیار گروه فهرست بندی

نمایندگی JSON 
{
  "type": enum (ListingGroupType)
}
فیلدها
type

enum ( ListingGroupType )

نوع گروه لیست

ListingGroupType

نوع گروه فهرست.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
SUBDIVISION تقسیم بندی محصولات در امتداد برخی از ابعاد فهرست بندی. این گره ها با ارائه خدمات برای ورودی های فهرست بندی مورد استفاده قرار نمی گیرند، بلکه صرفاً برای تعریف ساختار درخت هستند.
UNIT فهرست کردن واحد گروه که یک پیشنهاد را تعریف می کند.

AgeRangeInfo

یک معیار محدوده سنی

نمایندگی JSON 
{
  "type": enum (AgeRangeType)
}
فیلدها
type

enum ( AgeRangeType )

نوع محدوده سنی

AgeRangeType

نوع محدوده سنی جمعیتی (مثلاً بین 18 تا 24 سال).

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AGE_RANGE_18_24 بین 18 تا 24 سال.
AGE_RANGE_25_34 بین 25 تا 34 سال.
AGE_RANGE_35_44 بین 35 تا 44 سال.
AGE_RANGE_45_54 بین 45 تا 54 سال.
AGE_RANGE_55_64 بین 55 تا 64 سال.
AGE_RANGE_65_UP 65 سال به بالا.
AGE_RANGE_UNDETERMINED محدوده سنی نامشخص

اطلاعات جنسیتی

یک معیار جنسیتی

نمایندگی JSON 
{
  "type": enum (GenderType)
}
فیلدها
type

enum ( GenderType )

نوع جنسیت

جنسیت

نوع جنسیت های جمعیتی (مثلاً زن).

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
MALE مرد.
FEMALE زن.
UNDETERMINED جنسیت نامشخص

UserListInfo

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

نمایندگی JSON 
{
  "userList": string
}
فیلدها
user List

string

نام منبع فهرست کاربران

اطلاعات صفحه وب

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

نمایندگی JSON 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
فیلدها
conditions[]

object ( WebpageConditionInfo )

شرایط یا عبارات منطقی برای هدف گذاری صفحه وب. لیست شرایط هدف گذاری صفحه وب هنگام ارزیابی برای هدف گذاری با هم تنظیم می شود. یک لیست خالی از شرایط نشان می دهد که تمام صفحات وب سایت کمپین هدف قرار گرفته اند.

این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است.

coverage Percentage

number

درصد پوشش معیارهای وب سایت. این درصد محاسبه شده از پوشش وب سایت بر اساس هدف وب سایت، هدف منفی وب سایت و کلمات کلیدی منفی در گروه تبلیغاتی و کمپین است. به عنوان مثال، وقتی پوشش به صورت 1 برمی گردد، نشان می دهد که پوشش 100٪ دارد. این فیلد فقط خواندنی است.

criterion Name

string

نام معیاری که با این پارامتر تعریف می شود. از مقدار نام برای شناسایی، مرتب‌سازی و فیلتر کردن معیارها با این نوع پارامترها استفاده می‌شود.

این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است.

WebpageConditionInfo

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

نمایندگی JSON 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
فیلدها
operand

enum ( WebpageConditionOperand )

عامل شرایط هدف گذاری صفحه وب.

operator

enum ( WebpageConditionOperator )

اپراتور شرایط هدف گذاری صفحه وب.

argument

string

استدلال شرایط هدف گذاری صفحه وب.

WebpageConditionOperand

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
URL عملوند نشان دهنده شرایط هدف گذاری URL صفحه وب است.
CATEGORY عملوند نشان دهنده شرایط هدف گذاری دسته بندی صفحه وب است.
PAGE_TITLE عملوند که بیانگر شرایط هدف گذاری عنوان صفحه وب است.
PAGE_CONTENT عملوند بیانگر شرایط هدف گذاری محتوای صفحه وب است.
CUSTOM_LABEL عملوند نشان دهنده شرایط هدف گذاری برچسب سفارشی صفحه وب است.

WebpageConditionOperator

عملگر وضعیت صفحه وب در معیار صفحه وب.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
EQUALS شرط وب آرگومان با شرایط وب مقایسه شده برابر است.
CONTAINS شرط وب آرگومان بخشی از شرایط وب مقایسه شده است.

LocationInfo

یک معیار مکان.

نمایندگی JSON 
{
  "geoTargetConstant": string
}
فیلدها
geo Target Constant

string

نام منبع ثابت هدف جغرافیایی.

AdGroupCriterionEffectiveLabel

رابطه بین معیار گروه تبلیغات و برچسب موثر. یک برچسب مؤثر برچسبی است که به ارث رسیده یا مستقیماً به این معیار گروه تبلیغاتی اختصاص داده شده است.

نمایندگی JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resource Name

string

نام منبع برچسب موثر معیار گروه آگهی. نام‌های منابع برچسب مؤثر معیار گروه آگهی به این شکل است: customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}

ad Group Criterion

string

معیار گروه آگهی که برچسب مؤثر به آن چسبانده شده است.

label

string

برچسب موثر اختصاص داده شده به معیار گروه آگهی.

owner Customer Id

string ( int64 format)

شناسه مشتری که دارای برچسب موثر است.

AdGroupCriterionLabel

رابطه بین معیار گروه آگهی و برچسب.

نمایندگی JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resource Name

string

نام منبع برچسب معیار گروه آگهی. نام‌های منابع برچسب معیار گروه آگهی به این شکل است: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

ad Group Criterion

string

معیار گروه آگهی که برچسب به آن چسبانده شده است.

label

string

برچسبی که به معیار گروه آگهی اختصاص داده شده است.

owner Customer Id

string ( int64 format)

شناسه مشتری که دارای برچسب است.

AdGroupEffectiveLabel

رابطه بین یک گروه تبلیغاتی و یک برچسب موثر. یک برچسب موثر برچسبی است که به ارث رسیده یا مستقیماً به این گروه تبلیغاتی اختصاص داده شده است.

نمایندگی JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resource Name

string

نام منبع برچسب موثر گروه تبلیغاتی. نام‌های منابع برچسب مؤثر گروه تبلیغات به شکل زیر است: customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

ad Group

string

گروه تبلیغاتی که برچسب موثر به آن چسبانده شده است.

label

string

برچسب موثر اختصاص داده شده به گروه تبلیغاتی.

owner Customer Id

string ( int64 format)

شناسه مشتری که دارای برچسب موثر است.

AdGroupLabel

رابطه بین یک گروه تبلیغاتی و یک برچسب.

نمایندگی JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resource Name

string

نام منبع برچسب گروه تبلیغات. نام منابع برچسب گروه تبلیغات به شکل زیر است: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

ad Group

string

گروه تبلیغاتی که برچسب به آن چسبانده شده است.

label

string

برچسبی که به گروه تبلیغات اختصاص داده شده است.

owner Customer Id

string ( int64 format)

شناسه مشتری که دارای برچسب است.

AgeRangeView

نمای محدوده سنی

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

نام منبع نمای محدوده سنی. نام منابع نمای محدوده سنی به شکل زیر است:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

دارایی

دارایی بخشی از یک تبلیغ است که می تواند در چندین آگهی به اشتراک گذاشته شود. این می تواند یک تصویر (ImageAsset)، یک ویدیو (YoutubeVideoAsset) و غیره باشد. دارایی ها تغییر ناپذیر هستند و قابل حذف نیستند. برای جلوگیری از ارائه دارایی، دارایی را از نهادی که از آن استفاده می کند حذف کنید.

نمایندگی JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
فیلدها
resource Name

string

نام منبع دارایی نام منابع دارایی به شکل زیر است:

customers/{customerId}/assets/{assetId}

type

enum ( AssetType )

نوع دارایی

final Urls[]

string

لیستی از URL های نهایی ممکن پس از تغییر مسیرهای متقابل دامنه.

status

enum ( AssetStatus )

وضعیت دارایی.

creation Time

string

مهر زمانی که این دارایی ایجاد شد. مُهر زمانی در منطقه زمانی مشتری و در قالب «سالم-MM-dd HH:mm:ss» است.

last Modified Time

string

تاریخ آخرین تغییر این دارایی. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.

id

string ( int64 format)

شناسه دارایی

name

string

نام اختیاری دارایی

tracking Url Template

string

قالب URL برای ساخت URL ردیابی.

engine Status

enum ( AssetEngineStatus )

وضعیت موتور برای یک دارایی

asset_data فیلد اتحادیه. نوع خاص دارایی asset_data تنها می تواند یکی از موارد زیر باشد:
youtube Video Asset

object ( YoutubeVideoAsset )

یک دارایی ویدیوی YouTube.

image Asset

object ( ImageAsset )

دارایی تصویر

text Asset

object ( TextAsset )

دارایی متن

callout Asset

object ( UnifiedCalloutAsset )

دارایی فراخوانی یکپارچه.

page Feed Asset

object ( UnifiedPageFeedAsset )

دارایی فید صفحه یکپارچه.

mobile App Asset

object ( MobileAppAsset )

دارایی اپلیکیشن موبایل

call Asset

object ( UnifiedCallAsset )

دارایی تماس یکپارچه

call To Action Asset

object ( CallToActionAsset )

دارایی دعوت به اقدام

location Asset

object ( UnifiedLocationAsset )

دارایی مکان یکپارچه

نوع دارایی

فهرستی که انواع احتمالی دارایی را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
YOUTUBE_VIDEO دارایی ویدیوی YouTube.
MEDIA_BUNDLE دارایی بسته رسانه ای
IMAGE دارایی تصویر
TEXT دارایی متن
LEAD_FORM دارایی فرم سرب.
BOOK_ON_GOOGLE رزرو در دارایی Google.
PROMOTION دارایی ارتقاء
CALLOUT دارایی Callout.
STRUCTURED_SNIPPET دارایی قطعه ساختاریافته.
PAGE_FEED دارایی فید صفحه.
DYNAMIC_EDUCATION دارایی آموزش پویا
MOBILE_APP دارایی اپلیکیشن موبایل
HOTEL_CALLOUT دارایی فراخوان هتل.
CALL دارایی تماس.
PRICE قیمت دارایی
CALL_TO_ACTION دارایی فراخوان برای اقدام
DYNAMIC_REAL_ESTATE دارایی املاک و مستغلات پویا.
DYNAMIC_CUSTOM دارایی سفارشی پویا
DYNAMIC_HOTELS_AND_RENTALS دارایی هتل ها و اجاره های پویا.
DYNAMIC_FLIGHTS دارایی پروازهای پویا
DYNAMIC_TRAVEL دارایی سفر پویا
DYNAMIC_LOCAL دارایی محلی پویا
DYNAMIC_JOBS دارایی مشاغل پویا
LOCATION دارایی مکان.
HOTEL_PROPERTY دارایی ملک هتل

وضعیت دارایی

وضعیت های احتمالی یک دارایی

Enums
UNSPECIFIED وضعیت مشخص نشده است.
UNKNOWN مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است.
ENABLED دارایی فعال است.
REMOVED دارایی حذف می شود.
ARCHIVED دارایی بایگانی می شود.
PENDING_SYSTEM_GENERATED دارایی در انتظار بررسی کاربر توسط سیستم ایجاد شده است.

AssetEngineStatus

شناسه بعدی = 11

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
SERVING دارایی فعال است
SERVING_LIMITED دارایی محدود فعال است.
DISAPPROVED دارایی تایید نشده است (واجد شرایط نیست).
DISABLED دارایی غیرفعال است (در انتظار).
REMOVED دارایی حذف شده است.

YouTubeVideoAsset

دارایی YouTube

نمایندگی JSON 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
فیلدها
youtube Video Title

string

عنوان ویدیوی یوتیوب.

youtube Video Id

string

شناسه ویدیوی یوتیوب این مقدار رشته 11 کاراکتری است که در URL ویدیوی YouTube استفاده می شود.

ImageAsset

دارایی تصویر

نمایندگی JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
فیلدها
mime Type

enum ( MimeType )

نوع MIME دارایی تصویر.

full Size

object ( ImageDimension )

فراداده این تصویر در اندازه اصلی آن.

file Size

string ( int64 format)

اندازه فایل دارایی تصویر بر حسب بایت.

MimeType

نوع میم

Enums
UNSPECIFIED نوع mime مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

IMAGE_JPEG نوع MIME تصویر/jpeg.
IMAGE_GIF نوع MIME تصویر/گیف.
IMAGE_PNG نوع MIME تصویر/png.
FLASH نوع MIME از برنامه/X-shockwave-flash.
TEXT_HTML نوع MIME متن/HTML.
PDF نوع MIME برنامه/PDF.
MSWORD نوع MIME از برنامه/msword.
MSEXCEL نوع MIME از برنامه/vnd.ms-excel.
RTF نوع MIME برنامه/RTF.
AUDIO_WAV نوع MIME از AUDIO/WAV.
AUDIO_MP3 نوع MIME AUDIO/MP3.
HTML5_AD_ZIP نوع MIME کاربرد/X-HTML5-AD-ZIP.

تصویر

ابرداده برای یک تصویر در اندازه خاص ، یا اصلی یا اندازه گیری شده.

نمایندگی JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
فیلدها
height Pixels

string ( int64 format)

ارتفاع تصویر.

width Pixels

string ( int64 format)

عرض تصویر.

url

string

URL که تصویر را با این ارتفاع و عرض برمی گرداند.

TextAsset

یک دارایی متنی

نمایندگی JSON 
{
  "text": string
}
فیلدها
text

string

محتوای متن دارایی متن.

یکپارچه

یک دارایی فراخوانی یکپارچه.

نمایندگی JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
فیلدها
callout Text

string

متن فراخوانی طول این رشته باید بین 1 تا 25 باشد ، فراگیر.

start Date

string

تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند.

end Date

string

آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD.

ad Schedule Targets[]

object ( AdScheduleInfo )

لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42.

use Searcher Time Zone

boolean

آیا می توان دارایی را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود.

adscheduleinfo

معیار adschedule را نشان می دهد.

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

بیش از شش Adschedules را نمی توان برای همان روز اضافه کرد.

نمایندگی JSON 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
فیلدها
start Minute

enum ( MinuteOfHour )

دقایقی بعد از ساعت شروع که این برنامه شروع می شود.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

end Minute

enum ( MinuteOfHour )

دقایقی بعد از ساعت پایان که این برنامه به پایان می رسد. برنامه منحصر به فرد از دقیقه پایان است.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

day Of Week

enum ( DayOfWeek )

روز هفته برنامه مربوط می شود.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

start Hour

integer

ساعت شروع در زمان 24 ساعت. این قسمت باید بین 0 تا 23 باشد ، فراگیر.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

end Hour

integer

ساعت پایان در زمان 24 ساعت ؛ 24 نشانگر پایان روز است. این قسمت باید بین 0 تا 24 باشد ، فراگیر.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

دقیقه

شمارش چهارم ساعت. به عنوان مثال ، "پانزده"

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
ZERO دقیقه صفر ساعت.
FIFTEEN پانزده دقیقه از ساعت گذشته.
THIRTY سی دقیقه از ساعت گذشته.
FORTY_FIVE چهل و پنج دقیقه از ساعت گذشته.

روز هفته

به عنوان مثال "دوشنبه" روزهای هفته را ذکر می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
MONDAY دوشنبه.
TUESDAY سه شنبه.
WEDNESDAY چهارشنبه.
THURSDAY پنج شنبه.
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یکشنبه.

unifiedSitelinkAsset

یک دارایی یکپارچه Sitelink.

نمایندگی JSON 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
فیلدها
link Text

string

متن نمایش URL برای SiteLink. طول این رشته باید بین 1 تا 25 باشد ، فراگیر.

description1

string

خط اول توضیحات برای Sitelink. در صورت تنظیم ، طول باید بین 1 تا 35 باشد ، فراگیر و توضیحات 2 نیز باید تنظیم شود.

description2

string

خط دوم توضیحات برای Sitelink. در صورت تنظیم ، طول باید بین 1 تا 35 باشد ، فراگیر و توضیحات 1 نیز باید تنظیم شود.

start Date

string

تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند.

end Date

string

آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD.

ad Schedule Targets[]

object ( AdScheduleInfo )

لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42.

tracking Id

string ( int64 format)

شناسه برای ردیابی کلیک برای دارایی SiteLink استفاده می شود. این یک یاهو است! فقط میدان ژاپن.

use Searcher Time Zone

boolean

آیا می توان دارایی SiteLink را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود.

mobile Preferred

boolean

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

یکپارچه

یک دارایی یک صفحه یکپارچه.

نمایندگی JSON 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
فیلدها
page Url

string

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

labels[]

string

برچسب های مورد استفاده برای گروه بندی URL های صفحه.

موبایل

دارایی که یک برنامه تلفن همراه را نشان می دهد.

نمایندگی JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
فیلدها
app Id

string

مورد نیاز. رشته ای که منحصر به فرد یک برنامه تلفن همراه را مشخص می کند. این فقط باید شناسه بومی پلتفرم مانند "com.android.ebay" برای Android یا "12345689" برای iOS باشد.

app Store

enum ( MobileAppVendor )

مورد نیاز. فروشگاه برنامه ای که این برنامه خاص را توزیع می کند.

موبایل

نوع فروشنده برنامه تلفن همراه

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
APPLE_APP_STORE فروشنده برنامه تلفن همراه برای فروشگاه App App.
GOOGLE_APP_STORE فروشنده برنامه موبایل برای فروشگاه App Google.

یکپارچه

یک دارایی تماس یکپارچه.

نمایندگی JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
فیلدها
country Code

string

کد کشور دو حرف شماره تلفن. مثالها: "ما" ، "ما".

phone Number

string

شماره تلفن خام تبلیغ کننده. مثال: '1234567890' ، '(123) 456-7890'

call Conversion Reporting State

enum ( CallConversionReportingState )

نشان می دهد که آیا این Callasset باید از تنظیمات تبدیل تماس خود استفاده کند ، تنظیم سطح حساب را دنبال کنید یا تبدیل تماس را غیرفعال کنید.

call Conversion Action

string

اقدام تبدیل برای نسبت دادن یک تماس به. در صورت عدم تنظیم ، از عمل تبدیل پیش فرض استفاده می شود. این قسمت فقط در صورتی که CallConversionReportingState روی use_resource_level_call_conversion_action تنظیم شده باشد ، تأثیر دارد.

ad Schedule Targets[]

object ( AdScheduleInfo )

لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42.

call Only

boolean

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

call Tracking Enabled

boolean

آیا تماس باید در ردیابی تماس فعال باشد. برای تبلیغات مایکروسافت اعمال می شود.

use Searcher Time Zone

boolean

آیا می توان پسوند تماس را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود.

start Date

string

تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند.

end Date

string

آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD.

CallConversionReportingState

انواع داده های احتمالی برای حالت اقدام تبدیل تماس.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
DISABLED اقدام تبدیل تماس غیرفعال است.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION اقدام به تبدیل تماس از نوع تبدیل تماس تنظیم شده در سطح حساب استفاده می شود.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION اقدام به تبدیل تماس از نوع تبدیل تماس تنظیم شده در سطح منبع (فقط تماس با تبلیغات/برنامه های افزودنی تماس) استفاده می شود.

calltoactionasset

فراخوانی به دارایی اقدام.

نمایندگی JSON 
{
  "callToAction": enum (CallToActionType)
}
فیلدها
call To Action

enum ( CallToActionType )

فراخوان به اقدام.

نوع calltoactiontype

Enum توصیف انواع احتمالی تماس با عمل.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
LEARN_MORE نوع فراخوان به عمل بیشتر می آموزد.
GET_QUOTE نوع فراخوان به عمل نقل قول است.
APPLY_NOW اکنون نوع تماس با عمل اعمال می شود.
SIGN_UP نوع تماس با عمل ثبت نام می کند.
CONTACT_US نوع تماس با عمل با ما تماس بگیرید.
SUBSCRIBE نوع فراخوان به عمل مشترک است.
DOWNLOAD نوع تماس با عمل بارگیری است.
BOOK_NOW نوع تماس با عمل اکنون کتاب است.
SHOP_NOW نوع تماس با عمل اکنون فروشگاه است.
BUY_NOW نوع تماس با عمل اکنون خرید است.
DONATE_NOW اکنون نوع فراخوان به عمل اهدا می شود.
ORDER_NOW نوع تماس با عمل اکنون سفارش است.
PLAY_NOW نوع تماس با عمل اکنون بازی است.
SEE_MORE نوع فراخوان به عمل بیشتر است.
START_NOW نوع تماس با عمل اکنون شروع شده است.
VISIT_SITE نوع تماس با عمل به سایت مراجعه کنید.
WATCH_NOW نوع تماس با عمل اکنون تماشا می شود.

یکپارچه یکپارچه

یک دارایی مکان یکپارچه.

نمایندگی JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
فیلدها
place Id

string

شناسه های منحصر به فرد مکانی را در پایگاه داده Google Places و در Google Maps قرار دهید. این قسمت برای شناسه مشتری خاص و نوع دارایی بی نظیر است. برای کسب اطلاعات بیشتر در مورد شناسه مکان ، به https://developers.google.com/places/web-service/place-id مراجعه کنید.

business Profile Locations[]

object ( BusinessProfileLocation )

لیست مکان های تجاری برای مشتری. این تنها درصورتی بازگردانده می شود که دارایی مکان از حساب پروفایل تجاری همگام سازی شود. می توان چندین لیست پروفایل تجاری را تحت همان حساب که به همان شناسه مکان اشاره دارد ، داشته باشید.

location Ownership Type

enum ( LocationOwnershipType )

نوع مالکیت مکان. اگر این نوع Business_owner باشد ، به عنوان یک برنامه افزودنی محل خدمت می شود. اگر نوع وابسته باشد ، به عنوان یک مکان وابسته خدمت می شود.

تجارت

داده های مکان مشخصات کسب و کار از حساب پروفایل کسب و کار پیوند یافته همگام سازی شده است.

نمایندگی JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
فیلدها
labels[]

string

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

store Code

string

کد فروشگاه پروفایل تجاری این مکان. این از حساب پروفایل تجاری همگام سازی شده است.

listing Id

string ( int64 format)

شناسه لیست این مکان پروفایل تجاری. این از حساب پروفایل کسب و کار مرتبط است.

موقعیت مکانی

انواع احتمالی مالکیت مکان.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
BUSINESS_OWNER صاحب مشاغل مکان (میراث موقعیت مکانی میراث - LE).
AFFILIATE موقعیت مکانی وابسته (پسوند موقعیت مکانی شخص ثالث - ALE).

دارایی گروه

AssetGroupAsset پیوند بین دارایی و یک گروه دارایی است. اضافه کردن یک AssetGroupAsset دارایی را با یک گروه دارایی پیوند می دهد.

نمایندگی JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
فیلدها
resource Name

string

نام منابع دارایی گروه دارایی. نام منابع دارایی دارایی فرم دارد:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

asset Group

string

گروه دارایی که این دارایی گروه دارایی در حال پیوند است.

asset

string

دارایی که این دارایی گروه دارایی در حال پیوند است.

field Type

enum ( AssetFieldType )

توضیحات قرار دادن دارایی در گروه دارایی. به عنوان مثال: تیتر ، youtube_video و غیره

status

enum ( AssetLinkStatus )

وضعیت پیوند بین یک گروه دارایی و دارایی.

نوع دارایی

enum توصیف مکان های احتمالی یک دارایی.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
HEADLINE دارایی برای استفاده به عنوان تیتر مرتبط است.
DESCRIPTION دارایی برای استفاده به عنوان توضیحات در ارتباط است.
MANDATORY_AD_TEXT دارایی برای استفاده به عنوان متن تبلیغاتی اجباری مرتبط است.
MARKETING_IMAGE دارایی برای استفاده به عنوان یک تصویر بازاریابی در ارتباط است.
MEDIA_BUNDLE دارایی برای استفاده به عنوان بسته نرم افزاری رسانه ای مرتبط است.
YOUTUBE_VIDEO دارایی برای استفاده به عنوان یک فیلم YouTube در ارتباط است.
BOOK_ON_GOOGLE این دارایی برای نشان دادن اینکه یک کمپین هتل ها "کتاب در Google" فعال شده است ، مرتبط است.
LEAD_FORM دارایی برای استفاده به عنوان پسوند فرم سرب مرتبط است.
PROMOTION دارایی برای استفاده به عنوان یک پسوند ارتقاء مرتبط است.
CALLOUT دارایی برای استفاده به عنوان پسوند فراخوانی مرتبط است.
STRUCTURED_SNIPPET دارایی برای استفاده به عنوان یک پسوند قطعه ساختاری مرتبط است.
MOBILE_APP دارایی برای استفاده به عنوان برنامه افزودنی برنامه تلفن همراه در ارتباط است.
HOTEL_CALLOUT این دارایی برای استفاده به عنوان پسوند فراخوانی هتل مرتبط است.
CALL دارایی برای استفاده به عنوان پسوند تماس مرتبط است.
PRICE دارایی برای استفاده به عنوان یک پسوند قیمت مرتبط است.
LONG_HEADLINE دارایی برای استفاده به عنوان یک تیتر طولانی مرتبط است.
BUSINESS_NAME دارایی برای استفاده به عنوان یک نام تجاری در ارتباط است.
SQUARE_MARKETING_IMAGE دارایی برای استفاده به عنوان یک تصویر بازاریابی مربع مرتبط است.
PORTRAIT_MARKETING_IMAGE دارایی برای استفاده به عنوان یک تصویر بازاریابی پرتره مرتبط است.
VIDEO دارایی برای استفاده به عنوان یک آرم غیر یوتیوب در ارتباط است.
CALL_TO_ACTION_SELECTION دارایی برای استفاده برای انتخاب تماس با عمل پیوند دارد.
AD_IMAGE دارایی برای استفاده برای انتخاب یک تصویر تبلیغاتی در ارتباط است.
HOTEL_PROPERTY این دارایی برای استفاده به عنوان یک ملک هتل در کمپین عملکردی برای اهداف مسافرتی در ارتباط است.

دارای گروههای دارایی

AssetGroupSignal یک سیگنال در یک گروه دارایی را نشان می دهد. وجود یک سیگنال به کمپین عملکرد Max که به احتمال زیاد تبدیل می شود ، می گوید. عملکرد حداکثر از سیگنال برای جستجوی افراد جدید با قصد مشابه یا قوی تر برای یافتن تبدیل در جستجوی ، نمایش ، فیلم و موارد دیگر استفاده می کند.

نمایندگی JSON 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
فیلدها
resource Name

string

نام منبع سیگنال گروه دارایی. نام منابع سیگنال گروه دارایی فرم دارد:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

asset Group

string

گروه دارایی که این سیگنال گروه دارایی متعلق به آن است.

signal میدانی اتحادیه. سیگنال گروه دارایی. signal می تواند تنها یکی از موارد زیر باشد:
audience

object ( AudienceInfo )

سیگنال مخاطب که توسط کمپین عملکرد Max مورد استفاده قرار می گیرد.

مخاطبان

معیار مخاطبان.

نمایندگی JSON 
{
  "audience": string
}
فیلدها
audience

string

نام منابع مخاطب.

assetgrouplistinggroupfilter

AssetGrouplistingGroupFilter یک گره درخت فیلتر گروه لیست را در یک گروه دارایی نشان می دهد.

نمایندگی JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
فیلدها
resource Name

string

نام منابع فیلتر گروه لیست دارایی. لیست گروه دارایی لیست منابع فیلتر گروه فرم:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

asset Group

string

گروه دارایی که این فیلتر گروه لیست دارایی گروه بخشی از آن است.

id

string ( int64 format)

شناسه ListingGroupFilter.

type

enum ( ListingGroupFilterType )

نوع گره فیلتر گروه لیست.

vertical

enum ( ListingGroupFilterVertical )

عمودی درخت گره فعلی نشان دهنده است. تمام گره های موجود در یک درخت باید متعلق به همان عمودی باشند.

case Value

object ( ListingGroupFilterDimension )

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

parent Listing Group Filter

string

نام منابع زیر مجموعه گروه لیست والدین. NULL برای گره فیلتر گروه لیست ریشه.

path

object ( ListingGroupFilterDimensionPath )

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

ListingGroupFilterType

نوع فیلتر گروه لیست.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
SUBDIVISION تقسیم محصولات در امتداد ابعاد لیست.
UNIT_INCLUDED گره برگ برگ گروه شامل لیست.
UNIT_EXCLUDED یک گره برگ فیلتر گروهی حذف شده است.

لیست groupfiltervertical

نوع فیلتر گروه لیست عمودی.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
SHOPPING نشان دهنده عمودی خرید است. عمودی فقط در عملکرد حداکثر برای کمپین های خرده فروشی مجاز است.

لیست groupfilterdimension

ابعاد لیست برای فیلتر گروه لیست دارایی.

نمایندگی JSON 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
فیلدها
dimension میدان اتحادیه بعد یکی از انواع زیر همیشه موجود است. dimension فقط می تواند یکی از موارد زیر باشد:
product Bidding Category

object ( ProductBiddingCategory )

دسته مناقصه از یک پیشنهاد محصول.

product Brand

object ( ProductBrand )

مارک یک پیشنهاد محصول.

product Channel

object ( ProductChannel )

محل پیشنهاد محصول.

product Condition

object ( ProductCondition )

شرط پیشنهاد محصول.

product Custom Attribute

object ( ProductCustomAttribute )

ویژگی سفارشی یک پیشنهاد محصول.

product Item Id

object ( ProductItemId )

شناسه مورد از یک پیشنهاد محصول.

product Type

object ( ProductType )

نوع پیشنهاد محصول.

نماد محصول

یکی از عناصر یک دسته مناقصه در سطح معینی. مقولات سطح بالا در سطح 1 ، فرزندان آنها در سطح 2 و غیره قرار دارند. ما در حال حاضر تا 5 سطح پشتیبانی می کنیم. کاربر باید یک نوع ابعاد را مشخص کند که سطح دسته را نشان می دهد. همه موارد زیر مجموعه یکسان باید از نوع ابعاد یکسان (سطح دسته) برخوردار باشند.

نمایندگی JSON 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
فیلدها
level

enum ( ListingGroupFilterBiddingCategoryLevel )

سطح دسته در طبقه بندی را نشان می دهد.

id

string ( int64 format)

شناسه دسته مناقصه محصول.

این شناسه معادل شناسه Google_Product_Category است که در این مقاله شرح داده شده است: https://support.google.com/merchants/answer/6324436

لیست

سطح دسته پیشنهادات فیلتر گروه لیست.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
LEVEL1 سطح 1.
LEVEL2 سطح 2.
LEVEL3 سطح 3.
LEVEL4 سطح 4.
LEVEL5 سطح 5.

محصول

مارک محصول.

نمایندگی JSON 
{
  "value": string
}
فیلدها
value

string

ارزش رشته برند محصول.

کانال

محل پیشنهاد محصول.

نمایندگی JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
فیلدها
channel

enum ( ListingGroupFilterProductChannel )

ارزش محل.

ListingGroupFilterProductChannel

Enum توصیف محل پیشنهاد محصول.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
ONLINE این مورد بصورت آنلاین فروخته می شود.
LOCAL این کالا در فروشگاه های محلی فروخته می شود.

شرط محصول

شرط پیشنهاد محصول.

نمایندگی JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
فیلدها
condition

enum ( ListingGroupFilterProductCondition )

ارزش شرط.

ListingGroupFilterProductCondition

Enum توصیف وضعیت یک پیشنهاد محصول.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
NEW شرایط محصول جدید است.
REFURBISHED شرایط محصول مرمت شده است.
USED از وضعیت محصول استفاده می شود.

محصول

ویژگی سفارشی یک پیشنهاد محصول.

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

enum ( ListingGroupFilterCustomAttributeIndex )

شاخص ویژگی سفارشی را نشان می دهد.

value

string

ارزش رشته ویژگی سفارشی محصول.

لیست groupfiltercustomattributeIndex

شاخص ویژگی های مشتری.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
INDEX0 اولین لیست ویژگی های فیلتر گروهی.
INDEX1 ویژگی دوم فیلتر گروهی ویژگی سفارشی.
INDEX2 لیست سومین لیست ویژگی های سفارشی فیلتر.
INDEX3 ویژگی چهارم فیلتر گروهی ویژگی سفارشی.
INDEX4 ویژگی های سفارشی فیلتر گروه پنجم.

تولید کننده

شناسه مورد از یک پیشنهاد محصول.

نمایندگی JSON 
{
  "value": string
}
فیلدها
value

string

ارزش شناسه.

نوع محصول

نوع پیشنهاد محصول.

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

enum ( ListingGroupFilterProductTypeLevel )

سطح نوع.

value

string

مقدار نوع.

لیست groupfilterproducttypelevel

enum توصیف سطح نوع یک محصول ارائه شده است.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
LEVEL1 سطح 1.
LEVEL2 سطح 2.
LEVEL3 سطح 3.
LEVEL4 سطح 4.
LEVEL5 سطح 5.

لیست groupfilterdimensionpath

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

نمایندگی JSON 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
فیلدها
dimensions[]

object ( ListingGroupFilterDimension )

مسیر کامل ابعاد از طریق سلسله مراتب فیلتر گروه لیست (به استثنای گره ریشه) به این فیلتر گروه لیست.

assetgrouptopcombinationview

دیدگاهی در مورد استفاده از ترکیب دارایی AD AD Group.

نمایندگی JSON 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
فیلدها
resource Name

string

نام منابع نمای ترکیبی بالای گروه دارایی. AssetGroup Top Combination View نام منابع دارای فرم است: `" مشتریان/{CustomerId}/AssetGrouptOpCombinationViews/{asset_group_id} {asset_combination_categration} "

asset Group Top Combinations[]

object ( AssetGroupAssetCombinationData )

ترکیب برتر دارایی هایی که با هم خدمت می کردند.

assetgroupassetcombinationdata

داده های ترکیبی دارایی گروه دارایی

نمایندگی JSON 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
فیلدها
asset Combination Served Assets[]

object ( AssetUsage )

دارایی های خدمت کرده است.

دارایی

حاوی اطلاعات استفاده از دارایی است.

نمایندگی JSON 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
فیلدها
asset

string

نام منابع دارایی.

served Asset Field Type

enum ( ServedAssetFieldType )

نوع میدان خدمت دارایی.

servalassetfieldtype

انواع میدان دارایی ممکن است.

Enums
UNSPECIFIED هیچ مقدار مشخص نشده است.
UNKNOWN

مقدار دریافت شده در این نسخه مشخص نیست.

این یک مقدار فقط پاسخ است.

HEADLINE_1 دارایی در عنوان 1 استفاده می شود.
HEADLINE_2 دارایی در عنوان 2 استفاده می شود.
HEADLINE_3 دارایی در عنوان 3 استفاده می شود.
DESCRIPTION_1 دارایی در توضیحات 1 استفاده می شود.
DESCRIPTION_2 دارایی در توضیحات 2 استفاده می شود.
HEADLINE دارایی در یک تیتر استفاده شد. از این استفاده کنید فقط در صورتی که فقط یک عنوان در تبلیغ وجود داشته باشد. در غیر این صورت ، از enums teilline_1 ، teilline_2 یا telelline_3 استفاده کنید
HEADLINE_IN_PORTRAIT دارایی به عنوان عنوان در تصویر پرتره استفاده شد.
LONG_HEADLINE دارایی در یک تیتر طولانی (که در multiassetresponsivead استفاده می شود) استفاده شد.
DESCRIPTION از دارایی در توضیحات استفاده شده است. از این استفاده کنید فقط در صورتی که فقط یک توضیحات در تبلیغ وجود داشته باشد. در غیر این صورت ، از توضیحات_1 یا توضیحات_@ enums استفاده کنید
DESCRIPTION_IN_PORTRAIT دارایی به عنوان توضیحات در تصویر پرتره استفاده شد.
BUSINESS_NAME_IN_PORTRAIT دارایی به عنوان نام تجاری در تصویر پرتره استفاده شد.
BUSINESS_NAME دارایی به عنوان نام تجاری استفاده شد.
MARKETING_IMAGE از این دارایی به عنوان یک تصویر بازاریابی استفاده می شد.
MARKETING_IMAGE_IN_PORTRAIT از این دارایی به عنوان یک تصویر بازاریابی در تصویر پرتره استفاده شد.
SQUARE_MARKETING_IMAGE از این دارایی به عنوان یک تصویر بازاریابی مربع استفاده شد.
PORTRAIT_MARKETING_IMAGE از این دارایی به عنوان یک تصویر بازاریابی پرتره استفاده شده است.
CALL_TO_ACTION از این دارایی به عنوان فراخوانی به عمل استفاده شد.
YOU_TUBE_VIDEO از این دارایی به عنوان یک فیلم YouTube استفاده شد.
CALL این دارایی به عنوان تماس استفاده می شود.
MOBILE_APP این دارایی به عنوان یک برنامه تلفن همراه استفاده می شود.
CALLOUT این دارایی به عنوان فراخوانی استفاده می شود.
STRUCTURED_SNIPPET این دارایی به عنوان یک قطعه ساختاری استفاده می شود.
PRICE این دارایی به عنوان یک قیمت استفاده می شود.
PROMOTION این دارایی به عنوان تبلیغ استفاده می شود.
AD_IMAGE این دارایی به عنوان یک تصویر استفاده می شود.
LEAD_FORM دارایی به عنوان یک فرم سرب استفاده می شود.

گروه دارایی

یک گروه دارایی AssetGroupAsset برای پیوند دارایی به گروه دارایی استفاده می شود. AssetGroupSignal برای ارتباط سیگنال به یک گروه دارایی استفاده می شود.

نمایندگی JSON 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
فیلدها
resource Name

string

نام منابع گروه دارایی. نام منابع گروه دارایی فرم دارد:

customers/{customerId}/assetGroups/{asset_group_id}

id

string ( int64 format)

شناسه گروه دارایی.

campaign

string

کمپینی که با این گروه دارایی در ارتباط است. دارایی که به گروه دارایی مرتبط است.

name

string

مورد نیاز. نام گروه دارایی. مورد نیاز. باید حداقل طول 1 و حداکثر طول 128 داشته باشد. باید تحت یک کمپین بی نظیر باشد.

final Urls[]

string

لیستی از URL های نهایی پس از تغییر مسیر دامنه صلیب. در عملکرد حداکثر ، به طور پیش فرض ، URL ها واجد شرایط برای گسترش هستند مگر اینکه انتخاب شوند.

final Mobile Urls[]

string

لیستی از URL های نهایی تلفن همراه پس از تغییر مسیر دامنه متقابل. در عملکرد حداکثر ، به طور پیش فرض ، URL ها واجد شرایط برای گسترش هستند مگر اینکه انتخاب شوند.

status

enum ( AssetGroupStatus )

وضعیت گروه دارایی.

path1

string

قسمت اول متن که ممکن است به URL نمایش داده شده در آگهی اضافه شود.

path2

string

بخش دوم متن که ممکن است به URL نمایش داده شده در آگهی اضافه شود. این قسمت فقط با تنظیم PATH1 قابل تنظیم است.

ad Strength

enum ( AdStrength )

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

گروه گروهی

وضعیت احتمالی یک گروه دارایی.

Enums
UNSPECIFIED وضعیت مشخص نشده است.
UNKNOWN مقدار دریافت شده در این نسخه مشخص نیست.
ENABLED گروه دارایی فعال است.
PAUSED گروه دارایی متوقف می شود.
REMOVED گروه دارایی برداشته می شود.

قید

لیست نقاط قوت تبلیغات احتمالی.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
PENDING قدرت تبلیغ در حال حاضر در انتظار است.
NO_ADS هیچ تبلیغی نمی تواند ایجاد شود.
POOR قدرت ضعیف
AVERAGE قدرت متوسط
GOOD قدرت خوب
EXCELLENT قدرت عالی

دارایی

AssetsetAsset پیوند بین دارایی و مجموعه دارایی است. اضافه کردن یک AssetsetAsset دارای یک دارایی با مجموعه دارایی است.

نمایندگی JSON 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
فیلدها
resource Name

string

نام منبع دارایی دارایی دارایی. دارایی مجموعه منابع دارایی فرم دارد:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

asset Set

string

مجموعه دارایی که این دارایی مجموعه دارایی به آن پیوند دارد.

asset

string

دارایی که این دارایی تنظیم شده دارایی به آن پیوند دارد.

status

enum ( AssetSetAssetStatus )

وضعیت دارایی دارایی. فقط خواندنی

دارایی

وضعیت احتمالی دارایی دارایی.

Enums
UNSPECIFIED وضعیت مشخص نشده است.
UNKNOWN مقدار دریافت شده در این نسخه مشخص نیست. این یک مقدار فقط پاسخ است.
ENABLED دارایی مجموعه دارایی فعال است.
REMOVED دارایی مجموعه دارایی برداشته می شود.

دارایی

مجموعه دارایی که مجموعه ای از دارایی ها را نشان می دهد. برای پیوند یک دارایی به مجموعه دارایی از AssetsetAsset استفاده کنید.

نمایندگی JSON 
{
  "id": string,
  "resourceName": string
}
فیلدها
id

string ( int64 format)

شناسه مجموعه دارایی.

resource Name

string

نام منبع مجموعه دارایی. دارایی تنظیمات منابع دارای فرم است:

customers/{customerId}/assetSets/{asset_set_id}

پیشنهادات

یک استراتژی مناقصه

نمایندگی JSON 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
فیلدها
resource Name

string

نام منابع استراتژی مناقصه. نام منابع استراتژی مناقصه فرم دارد:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum ( BiddingStrategyStatus )

وضعیت استراتژی مناقصه.

این قسمت فقط خواندنی است.

type

enum ( BiddingStrategyType )

نوع استراتژی مناقصه. با تنظیم طرح مناقصه ، یک استراتژی مناقصه ایجاد کنید.

این قسمت فقط خواندنی است.

currency Code

string

ارز استفاده شده توسط استراتژی مناقصه (کد سه حرف ISO 4217).

برای استراتژی های مناقصه در مشتریان مدیر ، این ارز را می توان به ایجاد و پیش فرض برای ارز مشتری مدیر تنظیم کرد. برای خدمت به مشتریان ، این زمینه قابل تنظیم نیست. کلیه استراتژی های موجود در یک سرویس دهنده به طور ضمنی از ارز مشتری سرویس دهنده استفاده می کند. در همه موارد ، میدان FactiveCurrencyCode ارز مورد استفاده استراتژی را برمی گرداند.

id

string ( int64 format)

شناسه استراتژی مناقصه.

name

string

نام استراتژی مناقصه. کلیه استراتژی های مناقصه در یک حساب باید کاملاً مشخص باشد.

طول این رشته باید بین 1 تا 255 باشد ، در بایت های UTF-8 ، (برش خورده).

effective Currency Code

string

ارز استفاده شده توسط استراتژی مناقصه (کد سه حرف ISO 4217).

برای استراتژی های مناقصه در مشتریان مدیر ، این ارز تعیین شده توسط تبلیغ کننده هنگام ایجاد استراتژی است. برای خدمت به مشتریان ، این کد ارز مشتری است.

معیارهای استراتژی مناقصه در این ارز گزارش شده است.

این قسمت فقط خواندنی است.

campaign Count

string ( int64 format)

تعداد کمپین های متصل به این استراتژی مناقصه.

این قسمت فقط خواندنی است.

non Removed Campaign Count

string ( int64 format)

تعداد کمپین های غیر ضبط شده به این استراتژی مناقصه.

این قسمت فقط خواندنی است.

scheme میدانی اتحادیه. طرح مناقصه

فقط یک نفر قابل تنظیم است. scheme فقط می تواند یکی از موارد زیر باشد:

enhanced Cpc

object ( EnhancedCpc )

یک استراتژی مناقصه که پیشنهاداتی را برای کلیک هایی که به نظر می رسد منجر به تبدیل می شود ، افزایش می دهد و آنها را برای کلیک هایی که به نظر می رسد کمتر به نظر می رسد ، پایین می آورد.

maximize Conversion Value

object ( MaximizeConversionValue )

یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین ارزش تبدیل برای کمپین های خود ضمن صرف بودجه خود.

maximize Conversions

object ( MaximizeConversions )

یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین تبدیل برای کمپین های خود ضمن صرف بودجه خود.

target Cpa

object ( TargetCpa )

یک استراتژی مناقصه که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (CPA) که تعیین کرده اید ، تعیین می کند.

target Impression Share

object ( TargetImpressionShare )

یک استراتژی مناقصه که به طور خودکار نسبت به درصد منتخب برداشت ها بهینه می شود.

target Outrank Share

object ( TargetOutrankShare )

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

target Roas

object ( TargetRoas )

یک استراتژی مناقصه که به شما کمک می کند تا ضمن میانگین بازده هدف خاص در هزینه های تبلیغاتی (ROAS) ، درآمد را به حداکثر برسانید.

target Spend

object ( TargetSpend )

یک استراتژی پیشنهادی که پیشنهادات شما را برای کمک به شما کمک می کند تا هرچه بیشتر کلیک در بودجه شما بدست آورید.

پیشنهادات

وضعیت احتمالی یک BiddingStrategy.

Enums
UNSPECIFIED هیچ مقدار مشخص نشده است.
UNKNOWN

مقدار دریافت شده در این نسخه مشخص نیست.

این یک مقدار فقط پاسخ است.

ENABLED استراتژی مناقصه فعال است.
REMOVED استراتژی مناقصه حذف می شود.

piddingStrategyType

enum توصیف انواع استراتژی پیشنهادات احتمالی.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
COMMISSION کمیسیون یک استراتژی مناقصه خودکار است که در آن تبلیغ کننده بخش خاصی از ارزش تبدیل را می پردازد.
ENHANCED_CPC پیشرفته CPC یک استراتژی مناقصه است که پیشنهاداتی را برای کلیک هایی ایجاد می کند که به نظر می رسد بیشتر منجر به تبدیل می شوند و آنها را برای کلیک هایی که به نظر می رسد کمتر است ، کاهش می دهد.
INVALID فقط برای مقدار بازگشت استفاده می شود. نشان می دهد که یک کمپین استراتژی مناقصه ای ندارد. این مانع از خدمت کمپین می شود. به عنوان مثال ، یک کمپین ممکن است به یک استراتژی مناقصه مدیر وصل شود و حساب سرویس پس از آن از حساب مدیر بدون پیوند است. در این حالت ، این کمپین به طور خودکار از استراتژی مناقصه مدیر فعلی غیرقابل دسترسی و انتقال به نوع استراتژی مناقصه نامعتبر جدا می شود.
MANUAL_CPA استراتژی مناقصه دستی که به تبلیغ کننده اجازه می دهد تا پیشنهاد را برای هر تبلیغ مشخص شده تنظیم کند.
MANUAL_CPC MANUAL کلیک بر روی مناقصه مبتنی بر جایی که کاربر در هر کلیک پرداخت می کند.
MANUAL_CPM مناقصه مبتنی بر تصور دستی که کاربر در هر هزار برداشت می پردازد.
MANUAL_CPV یک استراتژی مناقصه که مبلغ قابل تنظیم را برای هر نمای ویدیو می پردازد.
MAXIMIZE_CONVERSIONS یک استراتژی مناقصه که به طور خودکار تعداد تبدیل ها را با توجه به بودجه روزانه به حداکثر می رساند.
MAXIMIZE_CONVERSION_VALUE یک استراتژی مناقصه خودکار که به طور خودکار پیشنهاداتی را برای به حداکثر رساندن درآمد ضمن صرف بودجه خود تعیین می کند.
PAGE_ONE_PROMOTED صفحه-یکی از طرح مناقصه ، که حداکثر پیشنهادات CPC را برای هدف قرار دادن برداشت در صفحه یک یا صفحه یک اسلات تبلیغ شده در Google.com تعیین می کند. این مقدار enum کاهش می یابد.
PERCENT_CPC درصد CPC استراتژی مناقصه ای است که در آن پیشنهادات بخشی از قیمت تبلیغ شده برای برخی از خدمات خوب یا خدمات است.
TARGET_CPA CPA Target یک استراتژی پیشنهادی خودکار است که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر کسب و کار (CPA) که تعیین کرده اید ، تعیین می کند.
TARGET_CPM Target CPM یک استراتژی پیشنهادی خودکار است که پیشنهاداتی را برای کمک به بدست آوردن برداشت های هرچه بیشتر با هزینه هدف در هزار برداشت (CPM) که شما تعیین کرده اید ، تعیین می کند.
TARGET_IMPRESSION_SHARE یک استراتژی مناقصه خودکار که پیشنهادات را تعیین می کند به گونه ای که درصد مشخصی از تبلیغات جستجو در بالای صفحه اول (یا مکان هدفمند دیگر) نشان داده می شود.
TARGET_OUTRANK_SHARE Target Outrank Share یک استراتژی خودکار مناقصه است که پیشنهادات را بر اساس کسری هدف از حراج ها تعیین می کند که در آن تبلیغ کننده باید از یک رقیب خاص پیشی بگیرد. این مقدار enum کاهش می یابد.
TARGET_ROAS Target ROAS یک استراتژی پیشنهادی خودکار است که به شما کمک می کند تا ضمن میانگین بازده هدف خاص در هزینه متوسط ​​(ROAS) ، درآمد را به حداکثر برسانید.
TARGET_SPEND Target Dever یک استراتژی پیشنهاد خودکار است که پیشنهادات شما را برای کمک به دریافت هرچه بیشتر کلیک در بودجه شما تعیین می کند.

پیشرفته

این نوع هیچ فیلدی ندارد.

یک استراتژی خودکار مناقصه که پیشنهاداتی را برای کلیک هایی ایجاد می کند که به نظر می رسد بیشتر منجر به تبدیل می شوند و آنها را برای کلیک هایی که به نظر می رسد کمتر است ، پایین می آورد.

این استراتژی مناقصه مستهلک می شود و دیگر نمی توان ایجاد کرد. برای عملکرد معادل آن از manualcpc با edvancedcpcenabled تنظیم کنید.

حداکثر

یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین ارزش تبدیل برای کمپین های خود ضمن صرف بودجه خود.

نمایندگی JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
فیلدها
cpc Bid Ceiling Micros

string ( int64 format)

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

cpc Bid Floor Micros

string ( int64 format)

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

target Roas

number

گزینه Return On Ad Devent (ROAS) گزینه. در صورت تنظیم ، استراتژی پیشنهاد در حالی که میانگین بازده هدف در تبلیغات را دارد ، درآمد را به حداکثر می رساند. اگر ROAS هدف بالا باشد ، ممکن است استراتژی پیشنهاد نتواند بودجه کامل را خرج کند. اگر ROA های هدف تعیین نشده باشد ، استراتژی پیشنهاد برای دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود.

حداکثر

یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین تبدیل برای کمپین های خود ضمن صرف بودجه خود.

نمایندگی JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
فیلدها
cpc Bid Ceiling Micros

string ( int64 format)

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

cpc Bid Floor Micros

string ( int64 format)

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

target Cpa Micros

string ( int64 format)

گزینه Cost-Action Target (CPA). این میانگین مبلغی است که شما می خواهید در هر اقدام تبدیل شده در واحدهای خرد از ارز استراتژی مناقصه هزینه کنید. در صورت تنظیم ، استراتژی پیشنهاد هرچه بیشتر ممکن است در هر یا پایین تر از هزینه هر عمل در هر عمل دریافت کند. اگر CPA هدف تعیین نشده باشد ، استراتژی پیشنهاد برای دستیابی به کمترین CPA ممکن با توجه به بودجه خواهد بود.

TargetCPA

یک استراتژی پیشنهادی خودکار که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (CPA) که تعیین کرده اید ، تعیین می کند.

نمایندگی JSON 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
فیلدها
target Cpa Micros

string ( int64 format)

هدف متوسط ​​CPA. این هدف باید بر اساس ارز برای حساب بیشتر یا مساوی با حداقل واحد قابل پرداخت باشد.

cpc Bid Ceiling Micros

string ( int64 format)

حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. این فقط باید برای استراتژی های پیشنهادات نمونه کارها تنظیم شود.

cpc Bid Floor Micros

string ( int64 format)

حداقل حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. این فقط باید برای استراتژی های پیشنهادات نمونه کارها تنظیم شود.

هدف گیری

یک استراتژی مناقصه خودکار که پیشنهادات را تعیین می کند به گونه ای که درصد مشخصی از تبلیغات جستجو در بالای صفحه اول (یا مکان هدفمند دیگر) نشان داده می شود.

نمایندگی JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
فیلدها
location

enum ( TargetImpressionShareLocation )

مکان هدفمند در صفحه نتایج جستجو.

location Fraction Micros

string ( int64 format)

بخش انتخابی از تبلیغات که در مکان هدفمند در میکرو نشان داده می شود. به عنوان مثال ، 1 ٪ برابر با 10،000 است.

cpc Bid Ceiling Micros

string ( int64 format)

بالاترین پیشنهاد CPC سیستم مناقصه خودکار مجاز به مشخص کردن است. این یک زمینه مورد نیاز است که توسط تبلیغ کننده وارد شده است که سقف را تنظیم کرده و در MICRO های محلی مشخص شده است.

مکان سازی هدف

ENUM توصیف اهداف احتمالی.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
ANYWHERE_ON_PAGE هر مکان در صفحه وب.
TOP_OF_PAGE جعبه برتر تبلیغات.
ABSOLUTE_TOP_OF_PAGE شکاف بالا در جعبه بالای تبلیغات.

Targetoutrankshare

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

نمایندگی JSON 
{
  "cpcBidCeilingMicros": string
}
فیلدها
cpc Bid Ceiling Micros

string ( Int64Value format)

حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود.

عناوین هدف

یک استراتژی مناقصه خودکار که به شما کمک می کند تا ضمن میانگین بازده هدف خاص در هزینه های تبلیغاتی (ROAS) ، درآمد را به حداکثر برسانید.

نمایندگی JSON 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
فیلدها
target Roas

number

مورد نیاز. درآمد انتخاب شده (بر اساس داده های تبدیل) در هر واحد هزینه. مقدار باید بین 0.01 تا 1000.0 باشد ، فراگیر.

cpc Bid Ceiling Micros

string ( int64 format)

حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. این فقط باید برای استراتژی های پیشنهادات نمونه کارها تنظیم شود.

cpc Bid Floor Micros

string ( int64 format)

حداقل حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. این فقط باید برای استراتژی های پیشنهادات نمونه کارها تنظیم شود.

هدف

یک استراتژی پیشنهادی خودکار که پیشنهادات شما را برای کمک به دریافت هرچه بیشتر کلیک در بودجه شما تعیین می کند.

نمایندگی JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
فیلدها
targetSpendMicros
(deprecated)

string ( int64 format)

کاهش یافته: هدف هزینه ای که برای حداکثر کلیک ها در آن قرار دارد. یک پیشنهاد دهنده Targetspend سعی خواهد کرد که کوچکتر از این ارزش یا مبلغ هزینه های طبیعی را خرج کند. اگر مشخص نشده باشد ، بودجه به عنوان هدف هزینه استفاده می شود. این زمینه مستهلک می شود و دیگر نباید مورد استفاده قرار گیرد. برای جزئیات بیشتر به https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html مراجعه کنید.

cpc Bid Ceiling Micros

string ( int64 format)

حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود.

کمپین

بودجه کمپین

نمایندگی JSON 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
فیلدها
resource Name

string

نام منابع بودجه کمپین. نام منابع بودجه کمپین فرم دارد:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

delivery Method

enum ( BudgetDeliveryMethod )

روش تحویل که میزان بودجه کمپین را در آن تعیین می کند.

اگر در یک عملیات ایجاد شده نامشخص باشد ، به طور پیش فرض استاندارد است.

period

enum ( BudgetPeriod )

دوره ای که برای صرف بودجه. پیش فرض روزانه اگر مشخص نشده باشد.

amount Micros

string ( int64 format)

میزان بودجه ، در ارز محلی برای حساب. مبلغ در MICROS مشخص شده است ، جایی که یک میلیون معادل یک واحد ارز است. هزینه ماهانه در 30.4 برابر این مبلغ بسته می شود.

بودجه deliveryMethod

روشهای تحویل احتمالی بودجه.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
STANDARD سرور بودجه در کل دوره زمانی به طور مساوی دریچه خواهد شد.
ACCELERATED سرور بودجه سرویس دریچه گاز نخواهد بود و تبلیغات به همان سرعت ممکن عمل می کند.

دوره بودجه

دوره احتمالی بودجه.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
DAILY بودجه روزانه
FIXED_DAILY بودجه روزانه ثابت.
CUSTOM_PERIOD از بودجه سفارشی می توان با Total_Amount استفاده کرد تا حد بودجه طول عمر را مشخص کند.

کمپین

یک کمپین.

نمایندگی JSON 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
فیلدها
resource Name

string

نام منابع کمپین. نام منابع کمپین فرم دارد:

customers/{customerId}/campaigns/{campaign_id}

status

enum ( CampaignStatus )

وضعیت کمپین

هنگامی که یک کمپین جدید اضافه می شود ، وضعیت پیش فرض فعال می شود.

serving Status

enum ( CampaignServingStatus )

آگهی سرویس دهی کمپین.

bidding Strategy System Status

enum ( BiddingStrategySystemStatus )

وضعیت سیستم استراتژی مناقصه کمپین.

ad Serving Optimization Status

enum ( AdServingOptimizationStatus )

آگهی بهینه سازی وضعیت کمپین.

advertising Channel Type

enum ( AdvertisingChannelType )

هدف اصلی خدمت برای تبلیغات در کمپین. گزینه های هدف گذاری را می توان در networkSettings تصفیه کرد.

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

فقط در هنگام ایجاد کمپین ها قابل تنظیم است. پس از ایجاد کمپین ، این زمینه قابل تغییر نیست.

advertising Channel Sub Type

enum ( AdvertisingChannelSubType )

پالایش اختیاری به advertisingChannelType . باید یک نوع فرعی معتبر از نوع کانال والدین باشد.

Can be set only when creating campaigns. After campaign is created, the field can not be changed.

url Custom Parameters[]

object ( CustomParameter )

The list of mappings used to substitute custom parameter tags in a trackingUrlTemplate , finalUrls , or mobile_final_urls .

real Time Bidding Setting

object ( RealTimeBiddingSetting )

Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.

network Settings

object ( NetworkSettings )

The network settings for the campaign.

dynamic Search Ads Setting

object ( DynamicSearchAdsSetting )

The setting for controlling Dynamic Search Ads (DSA).

shopping Setting

object ( ShoppingSetting )

The setting for controlling Shopping campaigns.

geo Target Type Setting

object ( GeoTargetTypeSetting )

The setting for ads geotargeting.

effective Labels[]

string

The resource names of effective labels attached to this campaign. An effective label is a label inherited or directly assigned to this campaign.

labels[]

string

The resource names of labels attached to this campaign.

bidding Strategy Type

enum ( BiddingStrategyType )

The type of bidding strategy.

A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the biddingStrategy field to create a portfolio bidding strategy.

This field is read-only.

accessible Bidding Strategy

string

Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'biddingStrategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.

frequency Caps[]

object ( FrequencyCapEntry )

A list that limits how often each user will see this campaign's ads.

selective Optimization

object ( SelectiveOptimization )

Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.

optimization Goal Setting

object ( OptimizationGoalSetting )

Optimization goal setting for this campaign, which includes a set of optimization goal types.

tracking Setting

object ( TrackingSetting )

Campaign-level settings for tracking information.

engine Id

string

ID of the campaign in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "campaign.id" instead.

excluded Parent Asset Field Types[]

enum ( AssetFieldType )

The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.

create Time

string

The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. createTime will be deprecated in v1. Use creationTime instead.

creation Time

string

The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

last Modified Time

string

The datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

id

string ( int64 format)

شناسه کمپین

name

string

The name of the campaign.

This field is required and should not be empty when creating new campaigns.

It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.

tracking Url Template

string

The URL template for constructing a tracking URL.

campaign Budget

string

The resource name of the campaign budget of the campaign.

start Date

string

The date when campaign started in serving customer's timezone in YYYY-MM-DD format.

end Date

string

The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.

final Url Suffix

string

Suffix used to append query parameters to landing pages that are served with parallel tracking.

url Expansion Opt Out

boolean

Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.

Union field campaign_bidding_strategy . The bidding strategy for the campaign.

Must be either portfolio (created through BiddingStrategy service) or standard, that is embedded into the campaign. campaign_bidding_strategy can be only one of the following:

bidding Strategy

string

The resource name of the portfolio bidding strategy used by the campaign.

manual Cpa

object ( ManualCpa )

Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.

manual Cpc

object ( ManualCpc )

Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.

manual Cpm

object ( ManualCpm )

Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.

maximize Conversions

object ( MaximizeConversions )

Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions while spending your budget.

maximize Conversion Value

object ( MaximizeConversionValue )

Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.

target Cpa

object ( TargetCpa )

Standard Target CPA bidding strategy that automatically sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.

target Impression Share

object ( TargetImpressionShare )

Target Impression Share bidding strategy. An automated bidding strategy that sets bids to achieve a chosen percentage of impressions.

target Roas

object ( TargetRoas )

Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).

target Spend

object ( TargetSpend )

Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.

percent Cpc

object ( PercentCpc )

Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.

target Cpm

object ( TargetCpm )

A bidding strategy that automatically optimizes cost per thousand impressions.

CampaignStatus

Possible statuses of a campaign.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Campaign is active and can show ads.
PAUSED Campaign has been paused by the user.
REMOVED Campaign has been removed.

CampaignServingStatus

Possible serving statuses of a campaign.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

SERVING در حال خدمت کردن
NONE هیچ کدام
ENDED Ended.
PENDING در انتظار
SUSPENDED تعلیق شد.

BiddingStrategySystemStatus

The possible system statuses of a BiddingStrategy.

Enums
UNSPECIFIED Signals that an unexpected error occurred, for example, no bidding strategy type was found, or no status information was found.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED The bid strategy is active, and AdWords cannot find any specific issues with the strategy.
LEARNING_NEW The bid strategy is learning because it has been recently created or recently reactivated.
LEARNING_SETTING_CHANGE The bid strategy is learning because of a recent setting change.
LEARNING_BUDGET_CHANGE The bid strategy is learning because of a recent budget change.
LEARNING_COMPOSITION_CHANGE The bid strategy is learning because of recent change in number of campaigns, ad groups or keywords attached to it.
LEARNING_CONVERSION_TYPE_CHANGE The bid strategy depends on conversion reporting and the customer recently modified conversion types that were relevant to the bid strategy.
LEARNING_CONVERSION_SETTING_CHANGE The bid strategy depends on conversion reporting and the customer recently changed their conversion settings.
LIMITED_BY_CPC_BID_CEILING The bid strategy is limited by its bid ceiling.
LIMITED_BY_CPC_BID_FLOOR The bid strategy is limited by its bid floor.
LIMITED_BY_DATA The bid strategy is limited because there was not enough conversion traffic over the past weeks.
LIMITED_BY_BUDGET A significant fraction of keywords in this bid strategy are limited by budget.
LIMITED_BY_LOW_PRIORITY_SPEND The bid strategy cannot reach its target spend because its spend has been de-prioritized.
LIMITED_BY_LOW_QUALITY A significant fraction of keywords in this bid strategy have a low Quality Score.
LIMITED_BY_INVENTORY The bid strategy cannot fully spend its budget because of narrow targeting.
MISCONFIGURED_ZERO_ELIGIBILITY Missing conversion tracking (no pings present) and/or remarketing lists for SSC.
MISCONFIGURED_CONVERSION_TYPES The bid strategy depends on conversion reporting and the customer is lacking conversion types that might be reported against this strategy.
MISCONFIGURED_CONVERSION_SETTINGS The bid strategy depends on conversion reporting and the customer's conversion settings are misconfigured.
MISCONFIGURED_SHARED_BUDGET There are campaigns outside the bid strategy that share budgets with campaigns included in the strategy.
MISCONFIGURED_STRATEGY_TYPE The campaign has an invalid strategy type and is not serving.
PAUSED The bid strategy is not active. Either there are no active campaigns, ad groups or keywords attached to the bid strategy. Or there are no active budgets connected to the bid strategy.
UNAVAILABLE This bid strategy currently does not support status reporting.
MULTIPLE_LEARNING There were multiple LEARNING_* system statuses for this bid strategy during the time in question.
MULTIPLE_LIMITED There were multiple LIMITED_* system statuses for this bid strategy during the time in question.
MULTIPLE_MISCONFIGURED There were multiple MISCONFIGURED_* system statuses for this bid strategy during the time in question.
MULTIPLE There were multiple system statuses for this bid strategy during the time in question.

AdServingOptimizationStatus

Enum describing possible serving statuses.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

OPTIMIZE Ad serving is optimized based on CTR for the campaign.
CONVERSION_OPTIMIZE Ad serving is optimized based on CTR * Conversion for the campaign. If the campaign is not in the conversion optimizer bidding strategy, it will default to OPTIMIZED.
ROTATE Ads are rotated evenly for 90 days, then optimized for clicks.
ROTATE_INDEFINITELY Show lower performing ads more evenly with higher performing ads, and do not optimize.
UNAVAILABLE Ad serving optimization status is not available.

AdvertisingChannelType

Enum describing the various advertising channel types.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
SEARCH Search Network. Includes display bundled, and Search+ campaigns.
DISPLAY Google Display Network only.
SHOPPING Shopping campaigns serve on the shopping property and on google.com search results.
HOTEL Hotel Ads campaigns.
VIDEO Video campaigns.
MULTI_CHANNEL App Campaigns, and App Campaigns for Engagement, that run across multiple channels.
LOCAL Local ads campaigns.
SMART Smart campaigns.
PERFORMANCE_MAX Performance Max campaigns.
LOCAL_SERVICES Local services campaigns.
DISCOVERY Discovery campaigns.
TRAVEL Travel campaigns.
SOCIAL Social campaigns.

AdvertisingChannelSubType

Enum describing the different channel subtypes.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used as a return value only. Represents value unknown in this version.
SEARCH_MOBILE_APP Mobile app campaigns for Search.
DISPLAY_MOBILE_APP Mobile app campaigns for Display.
SEARCH_EXPRESS AdWords express campaigns for search.
DISPLAY_EXPRESS AdWords Express campaigns for display.
SHOPPING_SMART_ADS Smart Shopping campaigns.
DISPLAY_GMAIL_AD Gmail Ad campaigns.
DISPLAY_SMART_CAMPAIGN Smart display campaigns. New campaigns of this sub type cannot be created.
VIDEO_OUTSTREAM Video Outstream campaigns.
VIDEO_ACTION Video TrueView for Action campaigns.
VIDEO_NON_SKIPPABLE Video campaigns with non-skippable video ads.
APP_CAMPAIGN App Campaign that lets you easily promote your Android or iOS app across Google's top properties including Search, Play, YouTube, and the Google Display Network.
APP_CAMPAIGN_FOR_ENGAGEMENT App Campaign for engagement, focused on driving re-engagement with the app across several of Google's top properties including Search, YouTube, and the Google Display Network.
LOCAL_CAMPAIGN Campaigns specialized for local advertising.
SHOPPING_COMPARISON_LISTING_ADS Shopping Comparison Listing campaigns.
SMART_CAMPAIGN Standard Smart campaigns.
VIDEO_SEQUENCE Video campaigns with sequence video ads.
APP_CAMPAIGN_FOR_PRE_REGISTRATION App Campaign for pre registration, specialized for advertising mobile app pre-registration, that targets multiple advertising channels across Google Play, YouTube and Display Network.
VIDEO_REACH_TARGET_FREQUENCY Video reach campaign with Target Frequency bidding strategy.
TRAVEL_ACTIVITIES Travel Activities campaigns.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook tracking only social campaigns.

CustomParameter

A mapping that can be used by custom parameter tags in a trackingUrlTemplate , finalUrls , or mobile_final_urls .

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

string

The key matching the parameter tag name.

value

string

The value to be substituted.

RealTimeBiddingSetting

Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.

نمایندگی JSON 
{
  "optIn": boolean
}
فیلدها
opt In

boolean

Whether the campaign is opted in to real-time bidding.

تنظیمات شبکه

The network settings for the campaign.

نمایندگی JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
فیلدها
target Search Network

boolean

Whether ads will be served on partner sites in the Google Search Network (requires targetGoogleSearch to also be true ).

target Content Network

boolean

Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.

target Partner Search Network

boolean

Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.

DynamicSearchAdsSetting

The setting for controlling Dynamic Search Ads (DSA).

نمایندگی JSON 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
فیلدها
domain Name

string

مورد نیاز. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".

language Code

string

مورد نیاز. The language code specifying the language of the domain, for example, "en".

use Supplied Urls Only

boolean

Whether the campaign uses advertiser supplied URLs exclusively.

ShoppingSetting

The setting for Shopping campaigns. Defines the universe of products that can be advertised by the campaign, and how this campaign interacts with other Shopping campaigns.

نمایندگی JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
فیلدها
feed Label

string

Feed label of products to include in the campaign. Only one of feedLabel or salesCountry can be set. If used instead of salesCountry, the feedLabel field accepts country codes in the same format for example: 'XX'. Otherwise can be any string used for feed label in Google Merchant Center.

use Vehicle Inventory

boolean

Whether to target Vehicle Listing inventory.

merchant Id

string ( int64 format)

ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.

sales Country

string

Sales country of products to include in the campaign.

campaign Priority

integer

Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.

enable Local

boolean

Whether to include local products.

GeoTargetTypeSetting

Represents a collection of settings related to ads geotargeting.

نمایندگی JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
فیلدها
positive Geo Target Type

enum ( PositiveGeoTargetType )

The setting used for positive geotargeting in this particular campaign.

negative Geo Target Type

enum ( NegativeGeoTargetType )

The setting used for negative geotargeting in this particular campaign.

PositiveGeoTargetType

The possible positive geo target types.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN The value is unknown in this version.
PRESENCE_OR_INTEREST Specifies that an ad is triggered if the user is in, or shows interest in, advertiser's targeted locations.
SEARCH_INTEREST Specifies that an ad is triggered if the user searches for advertiser's targeted locations. This can only be used with Search and standard Shopping campaigns.
PRESENCE Specifies that an ad is triggered if the user is in or regularly in advertiser's targeted locations.

NegativeGeoTargetType

The possible negative geo target types.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN The value is unknown in this version.
PRESENCE_OR_INTEREST Specifies that a user is excluded from seeing the ad if they are in, or show interest in, advertiser's excluded locations.
PRESENCE Specifies that a user is excluded from seeing the ad if they are in advertiser's excluded locations.

FrequencyCapEntry

این نوع هیچ فیلدی ندارد.

A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.

SelectiveOptimization

Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.

نمایندگی JSON 
{
  "conversionActions": [
    string
  ]
}
فیلدها
conversion Actions[]

string

The selected set of resource names for conversion actions for optimizing this campaign.

OptimizationGoalSetting

Optimization goal setting for this campaign, which includes a set of optimization goal types.

نمایندگی JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
فیلدها
optimization Goal Types[]

enum ( OptimizationGoalType )

The list of optimization goal types.

OptimizationGoalType

The type of optimization goal

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used as a return value only. Represents value unknown in this version.
CALL_CLICKS Optimize for call clicks. Call click conversions are times people selected 'Call' to contact a store after viewing an ad.
DRIVING_DIRECTIONS Optimize for driving directions. Driving directions conversions are times people selected 'Get directions' to navigate to a store after viewing an ad.
APP_PRE_REGISTRATION Optimize for pre-registration. Pre-registration conversions are the number of pre-registration signups to receive a notification when the app is released.

TrackingSetting

Campaign-level settings for tracking information.

نمایندگی JSON 
{
  "trackingUrl": string
}
فیلدها
tracking Url

string

The url used for dynamic tracking.

ManualCpa

این نوع هیچ فیلدی ندارد.

Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action.

ManualCpc

Manual click-based bidding where user pays per click.

نمایندگی JSON 
{
  "enhancedCpcEnabled": boolean
}
فیلدها
enhanced Cpc Enabled

boolean

Whether bids are to be enhanced based on conversion optimizer data.

ManualCpm

این نوع هیچ فیلدی ندارد.

Manual impression-based bidding where user pays per thousand impressions.

PercentCpc

A bidding strategy where bids are a fraction of the advertised price for some good or service.

نمایندگی JSON 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
فیلدها
cpc Bid Ceiling Micros

string ( int64 format)

Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined.

enhanced Cpc Enabled

boolean

Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpcBidCeilingMicros, but the average bid amount for a campaign should not.

TargetCpm

این نوع هیچ فیلدی ندارد.

Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set.

CampaignAsset

A link between a Campaign and an Asset.

نمایندگی JSON 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
فیلدها
resource Name

string

The resource name of the campaign asset. CampaignAsset resource names have the form:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum ( AssetLinkStatus )

Status of the campaign asset.

campaign

string

The campaign to which the asset is linked.

asset

string

The asset which is linked to the campaign.

CampaignAssetSet

CampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign.

نمایندگی JSON 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
فیلدها
resource Name

string

The resource name of the campaign asset set. Asset set asset resource names have the form:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

The campaign to which this asset set is linked.

asset Set

string

The asset set which is linked to the campaign.

status

enum ( AssetSetLinkStatus )

The status of the campaign asset set asset. فقط خواندنی

CampaignAudienceView

A campaign audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated by campaign and audience criterion. This view only includes audiences attached at the campaign level.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

The resource name of the campaign audience view. Campaign audience view resource names have the form:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

A campaign criterion.

نمایندگی JSON 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
فیلدها
resource Name

string

The resource name of the campaign criterion. Campaign criterion resource names have the form:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

display Name

string

The display name of the criterion.

This field is ignored for mutates.

type

enum ( CriterionType )

The type of the criterion.

status

enum ( CampaignCriterionStatus )

The status of the criterion.

last Modified Time

string

The datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

criterion Id

string ( int64 format)

The ID of the criterion.

This field is ignored during mutate.

bid Modifier

number

The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.

negative

boolean

Whether to target ( false ) or exclude ( true ) the criterion.

Union field criterion . The campaign criterion.

Exactly one must be set. criterion can be only one of the following:

keyword

object ( KeywordInfo )

کلمه کلیدی

location

object ( LocationInfo )

مکان.

device

object ( DeviceInfo )

دستگاه

age Range

object ( AgeRangeInfo )

Age range.

gender

object ( GenderInfo )

جنسیت.

user List

object ( UserListInfo )

User List.

language

object ( LanguageInfo )

زبان.

webpage

object ( WebpageInfo )

Webpage.

location Group

object ( LocationGroupInfo )

گروه مکان

CampaignCriterionStatus

The possible statuses of a CampaignCriterion.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

ENABLED The campaign criterion is enabled.
PAUSED The campaign criterion is paused.
REMOVED The campaign criterion is removed.

LanguageInfo

A language criterion.

نمایندگی JSON 
{
  "languageConstant": string
}
فیلدها
language Constant

string

The language constant resource name.

LocationGroupInfo

A radius around a list of locations specified through a feed.

نمایندگی JSON 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
فیلدها
geo Target Constants[]

string

Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed.

radius Units

enum ( LocationGroupRadiusUnits )

Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations.

feed Item Sets[]

string

FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geoTargetConstants. This is optional and can only be set in CREATE operations.

radius

string ( int64 format)

Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations.

LocationGroupRadiusUnits

The unit of radius distance in location group (for example, MILES)

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
METERS متر
MILES مایل
MILLI_MILES Milli Miles

CampaignEffectiveLabel

Represents a relationship between a campaign and an effective label. An effective label is a label inherited or directly assigned to this campaign.

نمایندگی JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resource Name

string

Name of the resource. CampaignEffectivelabel resource names have the form: customers/{customerId}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

The campaign to which the effective label is attached.

label

string

The effective label assigned to the campaign.

owner Customer Id

string ( int64 format)

The ID of the Customer which owns the effective label.

CampaignLabel

Represents a relationship between a campaign and a label.

نمایندگی JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resource Name

string

Name of the resource. Campaign label resource names have the form: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

The campaign to which the label is attached.

label

string

The label assigned to the campaign.

owner Customer Id

string ( int64 format)

The ID of the Customer which owns the label.

CartDataSalesView

Cart data sales view.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

The resource name of the Cart data sales view. Cart data sales view resource names have the form: customers/{customerId}/cartDataSalesView

مخاطب

Audience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments.

نمایندگی JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
فیلدها
resource Name

string

The resource name of the audience. Audience names have the form:

customers/{customerId}/audiences/{audience_id}

id

string ( int64 format)

ID of the audience.

name

string

مورد نیاز. Name of the audience. It should be unique across all audiences. It must have a minimum length of 1 and maximum length of 255.

description

string

Description of this audience.

ConversionAction

A conversion action.

نمایندگی JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
فیلدها
resource Name

string

The resource name of the conversion action. Conversion action resource names have the form:

customers/{customerId}/conversionActions/{conversion_action_id}

creation Time

string

Timestamp of the Floodlight activity's creation, formatted in ISO 8601.

status

enum ( ConversionActionStatus )

The status of this conversion action for conversion event accrual.

type

enum ( ConversionActionType )

The type of this conversion action.

category

enum ( ConversionActionCategory )

The category of conversions reported for this conversion action.

value Settings

object ( ValueSettings )

Settings related to the value for conversion events associated with this conversion action.

attribution Model Settings

object ( AttributionModelSettings )

Settings related to this conversion action's attribution model.

floodlight Settings

object ( FloodlightSettings )

Floodlight settings for Floodlight conversion types.

id

string ( int64 format)

The ID of the conversion action.

name

string

The name of the conversion action.

This field is required and should not be empty when creating new conversion actions.

primary For Goal

boolean

If a conversion action's primaryForGoal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primaryForGoal, so if a campaign has a custom conversion goal configured with a primaryForGoal = false conversion action, that conversion action is still biddable. By default, primaryForGoal will be true if not set. In V9, primaryForGoal can only be set to false after creation through an 'update' operation because it's not declared as optional.

owner Customer

string

The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.

include In Client Account Conversions Metric

boolean

Whether this conversion action should be included in the "clientAccountConversions" metric.

include In Conversions Metric

boolean

Whether this conversion action should be included in the "conversions" metric.

click Through Lookback Window Days

string ( int64 format)

The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.

app Id

string

App ID for an app conversion action.

ConversionActionStatus

Possible statuses of a conversion action.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Conversions will be recorded.
REMOVED Conversions will not be recorded.
HIDDEN Conversions will not be recorded and the conversion action will not appear in the UI.

ConversionActionType

Possible types of a conversion action.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
AD_CALL Conversions that occur when a user clicks on an ad's call extension.
CLICK_TO_CALL Conversions that occur when a user on a mobile device clicks a phone number.
GOOGLE_PLAY_DOWNLOAD Conversions that occur when a user downloads a mobile app from the Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversions that occur when a user makes a purchase in an app through Android billing.
UPLOAD_CALLS Call conversions that are tracked by the advertiser and uploaded.
UPLOAD_CLICKS Conversions that are tracked by the advertiser and uploaded with attributed clicks.
WEBPAGE Conversions that occur on a webpage.
WEBSITE_CALL Conversions that occur when a user calls a dynamically-generated phone number from an advertiser's website.
STORE_SALES_DIRECT_UPLOAD Store Sales conversion based on first-party or third-party merchant data uploads. Only customers on the allowlist can use store sales direct upload types.
STORE_SALES Store Sales conversion based on first-party or third-party merchant data uploads and/or from in-store purchases using cards from payment networks. Only customers on the allowlist can use store sales types. Read only.
FIREBASE_ANDROID_FIRST_OPEN Android app first open conversions tracked through Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Android app in app purchase conversions tracked through Firebase.
FIREBASE_ANDROID_CUSTOM Android app custom conversions tracked through Firebase.
FIREBASE_IOS_FIRST_OPEN iOS app first open conversions tracked through Firebase.
FIREBASE_IOS_IN_APP_PURCHASE iOS app in app purchase conversions tracked through Firebase.
FIREBASE_IOS_CUSTOM iOS app custom conversions tracked through Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Android app first open conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Android app in app purchase conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Android app custom conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN iOS app first open conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE iOS app in app purchase conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM iOS app custom conversions tracked through Third Party App Analytics.
ANDROID_APP_PRE_REGISTRATION Conversions that occur when a user pre-registers a mobile app from the Google Play Store. Read only.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions that track all Google Play downloads which aren't tracked by an app-specific type. Read only.
FLOODLIGHT_ACTION Floodlight activity that counts the number of times that users have visited a particular webpage after seeing or clicking on one of an advertiser's ads. Read only.
FLOODLIGHT_TRANSACTION Floodlight activity that tracks the number of sales made or the number of items purchased. Can also capture the total value of each sale. Read only.
GOOGLE_HOSTED Conversions that track local actions from Google's products and services after interacting with an ad. Read only.
LEAD_FORM_SUBMIT Conversions reported when a user submits a lead form. Read only.
SALESFORCE Conversions that come from Salesforce. Read only.
SEARCH_ADS_360 Conversions imported from Search Ads 360 Floodlight data. Read only.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Call conversions that occur on Smart campaign Ads without call tracking setup, using Smart campaign custom criteria. Read only.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL The user clicks on a call element within Google Maps. Smart campaign only. Read only.
SMART_CAMPAIGN_MAP_DIRECTIONS The user requests directions to a business location within Google Maps. Smart campaign only. Read only.
SMART_CAMPAIGN_TRACKED_CALLS Call conversions that occur on Smart campaign Ads with call tracking setup, using Smart campaign custom criteria. Read only.
STORE_VISITS Conversions that occur when a user visits an advertiser's retail store. Read only.
WEBPAGE_CODELESS Conversions created from website events (such as form submissions or page loads), that don't use individually coded event snippets. Read only.
UNIVERSAL_ANALYTICS_GOAL Conversions that come from linked Universal Analytics goals.
UNIVERSAL_ANALYTICS_TRANSACTION Conversions that come from linked Universal Analytics transactions.
GOOGLE_ANALYTICS_4_CUSTOM Conversions that come from linked Google Analytics 4 custom event conversions.
GOOGLE_ANALYTICS_4_PURCHASE Conversions that come from linked Google Analytics 4 purchase conversions.

ConversionActionCategory

The category of conversions that are associated with a ConversionAction.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
DEFAULT Default category.
PAGE_VIEW User visiting a page.
PURCHASE Purchase, sales, or "order placed" event.
SIGNUP Signup user action.
LEAD Lead-generating action.
DOWNLOAD Software download action (as for an app).
ADD_TO_CART The addition of items to a shopping cart or bag on an advertiser site.
BEGIN_CHECKOUT When someone enters the checkout flow on an advertiser site.
SUBSCRIBE_PAID The start of a paid subscription for a product or service.
PHONE_CALL_LEAD A call to indicate interest in an advertiser's offering.
IMPORTED_LEAD A lead conversion imported from an external source into Google Ads.
SUBMIT_LEAD_FORM A submission of a form on an advertiser site indicating business interest.
BOOK_APPOINTMENT A booking of an appointment with an advertiser's business.
REQUEST_QUOTE A quote or price estimate request.
GET_DIRECTIONS A search for an advertiser's business location with intention to visit.
OUTBOUND_CLICK A click to an advertiser's partner's site.
CONTACT A call, SMS, email, chat or other type of contact to an advertiser.
ENGAGEMENT A website engagement event such as long site time or a Google Analytics (GA) Smart Goal. Intended to be used for GA, Firebase, GA Gold goal imports.
STORE_VISIT A visit to a physical store location.
STORE_SALE A sale occurring in a physical store.
QUALIFIED_LEAD A lead conversion imported from an external source into Google Ads, that has been further qualified by the advertiser (marketing/sales team). In the lead-to-sale journey, advertisers get leads, then act on them by reaching out to the consumer. If the consumer is interested and may end up buying their product, the advertiser marks such leads as "qualified leads".
CONVERTED_LEAD A lead conversion imported from an external source into Google Ads, that has further completed a chosen stage as defined by the lead gen advertiser.

ValueSettings

Settings related to the value for conversion events associated with this conversion action.

نمایندگی JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
فیلدها
default Value

number

The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value.

default Currency Code

string

The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value.

always Use Default Value

boolean

Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action.

AttributionModelSettings

Settings related to this conversion action's attribution model.

نمایندگی JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
فیلدها
attribution Model

enum ( AttributionModel )

The attribution model type of this conversion action.

data Driven Model Status

enum ( DataDrivenModelStatus )

The status of the data-driven attribution model for the conversion action.

AttributionModel

The attribution model that describes how to distribute credit for a particular conversion across potentially many prior interactions.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
EXTERNAL Uses external attribution.
GOOGLE_ADS_LAST_CLICK Attributes all credit for a conversion to its last click.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Attributes all credit for a conversion to its first click using Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Attributes credit for a conversion equally across all of its clicks using Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Attributes exponentially more credit for a conversion to its more recent clicks using Google Search attribution (half-life is 1 week).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attributes 40% of the credit for a conversion to its first and last clicks. Remaining 20% is evenly distributed across all other clicks. This uses Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Flexible model that uses machine learning to determine the appropriate distribution of credit among clicks using Google Search attribution.

DataDrivenModelStatus

Enumerates data driven model statuses.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
AVAILABLE The data driven model is available.
STALE The data driven model is stale. It hasn't been updated for at least 7 days. It is still being used, but will become expired if it does not get updated for 30 days.
EXPIRED The data driven model expired. It hasn't been updated for at least 30 days and cannot be used. Most commonly this is because there hasn't been the required number of events in a recent 30-day period.
NEVER_GENERATED The data driven model has never been generated. Most commonly this is because there has never been the required number of events in any 30-day period.

FloodlightSettings

Settings related to a Floodlight conversion action.

نمایندگی JSON 
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
فیلدها
activity Group Tag

string

String used to identify a Floodlight activity group when reporting conversions.

activity Tag

string

String used to identify a Floodlight activity when reporting conversions.

activity Id

string ( int64 format)

ID of the Floodlight activity in DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

A conversion custom variable. See "About custom Floodlight metrics and dimensions in the new Search Ads 360" at https://support.google.com/sa360/answer/13567857

نمایندگی JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
فیلدها
resource Name

string

The resource name of the conversion custom variable. Conversion custom variable resource names have the form:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string ( int64 format)

The ID of the conversion custom variable.

name

string

مورد نیاز. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.

tag

string

مورد نیاز. The tag of the conversion custom variable. Tag should be unique and consist of a "u" character directly followed with a number less than ormequal to 100. For example: "u4".

status

enum ( ConversionCustomVariableStatus )

The status of the conversion custom variable for conversion event accrual.

owner Customer

string

The resource name of the customer that owns the conversion custom variable.

family

enum ( ConversionCustomVariableFamily )

Family of the conversion custom variable.

cardinality

enum ( ConversionCustomVariableCardinality )

Cardinality of the conversion custom variable.

floodlight Conversion Custom Variable Info

object ( FloodlightConversionCustomVariableInfo )

Fields for Search Ads 360 floodlight conversion custom variables.

custom Column Ids[]

string ( int64 format)

The IDs of custom columns that use this conversion custom variable.

ConversionCustomVariableStatus

Possible statuses of a conversion custom variable.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVATION_NEEDED

The conversion custom variable is pending activation and will not accrue stats until set to ENABLED.

This status can't be used in CREATE and UPDATE requests.

ENABLED The conversion custom variable is enabled and will accrue stats.
PAUSED The conversion custom variable is paused and will not accrue stats until set to ENABLED again.

ConversionCustomVariableFamily

Family of a conversion custom variable.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
STANDARD The standard conversion custom variable. Customers are required to activate before use.
FLOODLIGHT The conversion custom variable imported from a custom floodlight variable.

ConversionCustomVariableCardinality

Cardinality of a conversion custom variable.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
BELOW_ALL_LIMITS The conversion custom variable has cardinality below all limits. The variable can be used for segmentation, and stats can accrue for new values if the variable is enabled.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT The conversion custom variable has cardinality that exceeds the segmentation limit, but does not exceed the stats limit. Segmentation will be disabled, but stats can accrue for new values if the variable is enabled.
APPROACHES_STATS_LIMIT The conversion custom variable has exceeded the segmentation limits, and is approaching the stats limits (> 90%). Segmentation will be disabled, but stats can accrue for new values if the variable is enabled.
EXCEEDS_STATS_LIMIT The conversion custom variable has exceeded both the segmentation limits and stats limits. Segmentation will be disabled, and stats for enabled variables can accrue only if the existing values do not increase the cardinality of the variable any further.

FloodlightConversionCustomVariableInfo

Information for Search Ads 360 Floodlight Conversion Custom Variables.

نمایندگی JSON 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
فیلدها
floodlight Variable Type

enum ( FloodlightVariableType )

Floodlight variable type defined in Search Ads 360.

floodlight Variable Data Type

enum ( FloodlightVariableDataType )

Floodlight variable data type defined in Search Ads 360.

FloodlightVariableType

Type of the floodlight variable, as defined in the Search Ads 360. See https://support.google.com/searchads/answer/4397154?hl=en to learn more.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
DIMENSION Dimension floodlight variable type.
METRIC Metric floodlight variable type.
UNSET Floodlight variable type is unset.

FloodlightVariableDataType

The data type of the floodlight variable, as defined in Search Ads 360. See https://support.google.com/searchads/answer/4397154?hl=en to learn more.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
NUMBER Represents a floodlight variable of "Number" type. This variable may be assigned to floodlight variables of DIMENSION or METRIC types.
STRING Represents a floodlight variable of "String" type. This variable may be assigned to floodlight variables of DIMENSION type.

مشتری

A customer.

نمایندگی JSON 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
فیلدها
resource Name

string

The resource name of the customer. Customer resource names have the form:

customers/{customerId}

conversion Tracking Setting

object ( ConversionTrackingSetting )

Conversion tracking setting for a customer.

account Type

enum ( AccountType )

Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.

double Click Campaign Manager Setting

object ( DoubleClickCampaignManagerSetting )

DoubleClick Campaign Manager (DCM) setting for a manager customer.

account Status

enum ( AccountStatus )

Account status, for example, Enabled, Paused, Removed, etc.

last Modified Time

string

The datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

engine Id

string

ID of the account in the external engine account.

status

enum ( CustomerStatus )

The status of the customer.

creation Time

string

The timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

id

string ( int64 format)

The ID of the customer.

descriptive Name

string

Optional, non-unique descriptive name of the customer.

currency Code

string

The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.

time Zone

string

The local timezone ID of the customer.

tracking Url Template

string

The URL template for constructing a tracking URL out of parameters.

final Url Suffix

string

The URL template for appending params to the final URL.

auto Tagging Enabled

boolean

Whether auto-tagging is enabled for the customer.

manager

boolean

Whether the customer is a manager.

ConversionTrackingSetting

A collection of customer-wide settings related to Search Ads 360 Conversion Tracking.

نمایندگی JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
فیلدها
accepted Customer Data Terms

boolean

Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709 .

conversion Tracking Status

enum ( ConversionTrackingStatus )

Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.

enhanced Conversions For Leads Enabled

boolean

Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.

google Ads Conversion Customer

string

The resource name of the customer where conversions are created and managed. This field is read-only.

conversion Tracking Id

string ( int64 format)

The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversionTrackingStatus does). This field is read-only.

google Ads Cross Account Conversion Tracking Id

string ( int64 format)

The conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversionTrackingId. This field can only be managed through the Google Ads UI. This field is read-only.

cross Account Conversion Tracking Id

string ( int64 format)

The conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversionTrackingId.

ConversionTrackingStatus

Conversion Tracking status of the customer.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
NOT_CONVERSION_TRACKED Customer does not use any conversion tracking.
CONVERSION_TRACKING_MANAGED_BY_SELF The conversion actions are created and managed by this customer.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER The conversion actions are created and managed by the manager specified in the request's login-customer-id .
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER The conversion actions are created and managed by a manager different from the customer or manager specified in the request's login-customer-id .

نوع حساب

Possible engine account types.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
BAIDU Baidu account.
ENGINE_TRACK Engine track account.
FACEBOOK حساب فیس بوک.
FACEBOOK_GATEWAY Facebook account managed through gateway.
GOOGLE_ADS Google Ads account.
MICROSOFT Microsoft Advertising account.
SEARCH_ADS_360 Search Ads 360 manager account.
YAHOO_JAPAN Yahoo Japan account.

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM) setting for a manager customer.

نمایندگی JSON 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
فیلدها
advertiser Id

string ( int64 format)

ID of the Campaign Manager advertiser associated with this customer.

network Id

string ( int64 format)

ID of the Campaign Manager network associated with this customer.

time Zone

string

Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.

AccountStatus

Possible statuses of an account.

Enums
UNSPECIFIED مقدار پیش فرض
UNKNOWN Unknown value.
ENABLED Account is able to serve ads.
PAUSED Account is deactivated by the user.
SUSPENDED Account is deactivated by an internal process.
REMOVED Account is irrevocably deactivated.
DRAFT Account is still in the process of setup, not ENABLED yet.

CustomerStatus

Possible statuses of a customer.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Indicates an active account able to serve ads.
CANCELED Indicates a canceled account unable to serve ads. Can be reactivated by an admin user.
SUSPENDED Indicates a suspended account unable to serve ads. May only be activated by Google support.
CLOSED Indicates a closed account unable to serve ads. Test account will also have CLOSED status. Status is permanent and may not be reopened.

CustomerAsset

A link between a customer and an asset.

نمایندگی JSON 
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
فیلدها
resource Name

string

The resource name of the customer asset. CustomerAsset resource names have the form:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

مورد نیاز. The asset which is linked to the customer.

status

enum ( AssetLinkStatus )

Status of the customer asset.

CustomerAssetSet

CustomerAssetSet is the linkage between a customer and an asset set. Adding a CustomerAssetSet links an asset set with a customer.

نمایندگی JSON 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
فیلدها
resource Name

string

The resource name of the customer asset set. Asset set asset resource names have the form:

customers/{customerId}/customerAssetSets/{asset_set_id}

asset Set

string

The asset set which is linked to the customer.

customer

string

The customer to which this asset set is linked.

status

enum ( AssetSetLinkStatus )

The status of the customer asset set asset. فقط خواندنی

AccessibleBiddingStrategy

نمایانگر نمایی از BiddingStrategies است که متعلق به مشتری است و با آن به اشتراک گذاشته شده است.

برخلاف BiddingStrategy، این منبع شامل استراتژی‌هایی است که متعلق به مدیران مشتری است و با این مشتری به اشتراک گذاشته می‌شود - علاوه بر استراتژی‌های متعلق به این مشتری. این منبع معیارهایی را ارائه نمی دهد و فقط زیرمجموعه محدودی از ویژگی های BiddingStrategy را نشان می دهد.

نمایندگی JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
فیلدها
resource Name

string

The resource name of the accessible bidding strategy. AccessibleBiddingStrategy resource names have the form:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string ( int64 format)

The ID of the bidding strategy.

name

string

The name of the bidding strategy.

type

enum ( BiddingStrategyType )

The type of the bidding strategy.

owner Customer Id

string ( int64 format)

The ID of the Customer which owns the bidding strategy.

owner Descriptive Name

string

descriptiveName of the Customer which owns the bidding strategy.

Union field scheme . The bidding scheme.

Only one can be set. scheme can be only one of the following:

maximize Conversion Value

object ( MaximizeConversionValue )

An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.

maximize Conversions

object ( MaximizeConversions )

An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.

target Cpa

object ( TargetCpa )

A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.

target Impression Share

object ( TargetImpressionShare )

A bidding strategy that automatically optimizes towards a chosen percentage of impressions.

target Roas

object ( TargetRoas )

A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).

target Spend

object ( TargetSpend )

A bid strategy that sets your bids to help get as many clicks as possible within your budget.

MaximizeConversionValue

An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.

نمایندگی JSON 
{
  "targetRoas": number
}
فیلدها
target Roas

number

The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget.

MaximizeConversions

An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.

نمایندگی JSON 
{
  "targetCpa": string,
  "targetCpaMicros": string
}
فیلدها
target Cpa

string ( int64 format)

The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.

target Cpa Micros

string ( int64 format)

The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.

TargetCpa

An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.

نمایندگی JSON 
{
  "targetCpaMicros": string
}
فیلدها
target Cpa Micros

string ( int64 format)

Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.

TargetImpressionShare

An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location).

نمایندگی JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
فیلدها
location

enum ( TargetImpressionShareLocation )

The targeted location on the search results page.

location Fraction Micros

string ( int64 format)

The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.

cpc Bid Ceiling Micros

string ( int64 format)

The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.

TargetRoas

An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).

نمایندگی JSON 
{
  "targetRoas": number
}
فیلدها
target Roas

number

The chosen revenue (based on conversion data) per unit of spend.

TargetSpend

An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.

نمایندگی JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
فیلدها
targetSpendMicros
(deprecated)

string ( int64 format)

The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.

cpc Bid Ceiling Micros

string ( int64 format)

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

ManagerLinkStatus

Possible statuses of a link.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVE Indicates current in-effect relationship
INACTIVE Indicates terminated relationship
PENDING Indicates relationship has been requested by manager, but the client hasn't accepted yet.
REFUSED Relationship was requested by the manager, but the client has refused.
CANCELED Indicates relationship has been requested by manager, but manager canceled it.

CustomerClient

A link between the given customer and a client customer. CustomerClients only exist for manager customers. All direct and indirect client customers are included, as well as the manager itself.

نمایندگی JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
فیلدها
resource Name

string

The resource name of the customer client. CustomerClient resource names have the form: customers/{customerId}/customerClients/{client_customer_id}

applied Labels[]

string

The resource names of the labels owned by the requesting customer that are applied to the client customer. Label resource names have the form:

customers/{customerId}/labels/{label_id}

status

enum ( CustomerStatus )

The status of the client customer. Read only.

client Customer

string

The resource name of the client-customer which is linked to the given customer. Read only.

hidden

boolean

Specifies whether this is a hidden account.

Read only.

level

string ( int64 format)

Distance between given customer and client. For self link, the level value will be 0. Read only.

time Zone

string

Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only.

test Account

boolean

Identifies if the client is a test account. Read only.

manager

boolean

Identifies if the client is a manager. Read only.

descriptive Name

string

Descriptive name for the client. Read only.

currency Code

string

Currency code (for example, 'USD', 'EUR') for the client. Read only.

id

string ( int64 format)

The ID of the client customer. Read only.

DynamicSearchAdsSearchTermView

A dynamic search ads search term view.

نمایندگی JSON 
{
  "resourceName": string,
  "landingPage": string
}
فیلدها
resource Name

string

The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing Page

string

The dynamically selected landing page URL of the impression.

This field is read-only.

GenderView

A gender view. The genderView resource reflects the effective serving state, rather than what criteria were added. An ad group without gender criteria by default shows to all genders, so all genders appear in genderView with stats.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

The resource name of the gender view. Gender view resource names have the form:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

A geo target constant.

نمایندگی JSON 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
فیلدها
resource Name

string

The resource name of the geo target constant. Geo target constant resource names have the form:

geoTargetConstants/{geo_target_constant_id}

status

enum ( GeoTargetConstantStatus )

Geo target constant status.

id

string ( int64 format)

The ID of the geo target constant.

name

string

Geo target constant English name.

country Code

string

The ISO-3166-1 alpha-2 country code that is associated with the target.

target Type

string

Geo target constant target type.

canonical Name

string

The fully qualified English name, consisting of the target's name and that of its parent and country.

parent Geo Target

string

The resource name of the parent geo target constant. Geo target constant resource names have the form:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

The possible statuses of a geo target constant.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

ENABLED The geo target constant is valid.
REMOVAL_PLANNED The geo target constant is obsolete and will be removed.

KeywordView

A keyword view.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

The resource name of the keyword view. Keyword view resource names have the form:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

برچسب بزنید

یک برچسب

نمایندگی JSON 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
فیلدها
resource Name

string

Name of the resource. Label resource names have the form: customers/{customerId}/labels/{label_id}

status

enum ( LabelStatus )

Status of the label. Read only.

text Label

object ( TextLabel )

A type of label displaying text on a colored background.

id

string ( int64 format)

ID of the label. Read only.

name

string

The name of the label.

This field is required and should not be empty when creating a new label.

The length of this string should be between 1 and 80, inclusive.

LabelStatus

Possible statuses of a label.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Label is enabled.
REMOVED Label is removed.

TextLabel

A type of label displaying text on a colored background.

نمایندگی JSON 
{
  "backgroundColor": string,
  "description": string
}
فیلدها
background Color

string

Background color of the label in HEX format. This string must match the regular expression '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.

description

string

A short description of the label. The length must be no more than 200 characters.

LanguageConstant

یک زبان

نمایندگی JSON 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
فیلدها
resource Name

string

The resource name of the language constant. Language constant resource names have the form:

languageConstants/{criterionId}

id

string ( int64 format)

The ID of the language constant.

code

string

The language code, for example, "en_US", "en_AU", "es", "fr", etc.

name

string

The full name of the language in English, for example, "English (US)", "Spanish", etc.

targetable

boolean

Whether the language is targetable.

LocationView

A location view summarizes the performance of campaigns by a Location criterion.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

The resource name of the location view. Location view resource names have the form:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

A Product Bidding Category.

نمایندگی JSON 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
فیلدها
resource Name

string

The resource name of the product bidding category. Product bidding category resource names have the form:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum ( ProductBiddingCategoryLevel )

Level of the product bidding category.

status

enum ( ProductBiddingCategoryStatus )

Status of the product bidding category.

id

string ( int64 format)

ID of the product bidding category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 .

country Code

string

Two-letter upper-case country code of the product bidding category.

product Bidding Category Constant Parent

string

Resource name of the parent product bidding category.

language Code

string

Language code of the product bidding category.

localized Name

string

Display value of the product bidding category localized according to languageCode.

ProductBiddingCategoryLevel

Enum describing the level of the product bidding category.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEVEL1 سطح 1.
LEVEL2 سطح 2.
LEVEL3 سطح 3.
LEVEL4 سطح 4.
LEVEL5 سطح 5.

ProductBiddingCategoryStatus

Enum describing the status of the product bidding category.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVE The category is active and can be used for bidding.
OBSOLETE The category is obsolete. Used only for reporting purposes.

ProductGroupView

A product group view.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

The resource name of the product group view. Product group view resource names have the form:

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

Shopping performance view. Provides Shopping campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customerId}/shoppingPerformanceView

UserList

A user list. This is a list of users a customer may target.

نمایندگی JSON 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
فیلدها
resource Name

string

The resource name of the user list. User list resource names have the form:

customers/{customerId}/userLists/{user_list_id}

type

enum ( UserListType )

Type of this list.

This field is read-only.

id

string ( int64 format)

Id of the user list.

name

string

Name of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED)

UserListType

Enum containing possible user list types.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
REMARKETING UserList represented as a collection of conversion types.
LOGICAL UserList represented as a combination of other user lists/interests.
EXTERNAL_REMARKETING UserList created in the Google Ad Manager platform.
RULE_BASED UserList associated with a rule.
SIMILAR UserList with users similar to users of another UserList.
CRM_BASED UserList of first-party CRM data provided by advertiser in the form of emails or other formats.

UserLocationView

A user location view.

User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.

نمایندگی JSON 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
فیلدها
resource Name

string

The resource name of the user location view. UserLocation view resource names have the form:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

country Criterion Id

string ( int64 format)

Criterion Id for the country.

targeting Location

boolean

Indicates whether location was targeted or not.

WebpageView

A webpage view.

نمایندگی JSON 
{
  "resourceName": string
}
فیلدها
resource Name

string

The resource name of the webpage view. Webpage view resource names have the form:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

بازدید کنید

یک بازدید

نمایندگی JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
فیلدها
resource Name

string

The resource name of the visit. Visit resource names have the form:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string ( int64 format)

The ID of the visit.

criterion Id

string ( int64 format)

Search Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed.

merchant Id

string ( int64 format)

The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.

ad Id

string ( int64 format)

Ad ID. A value of 0 indicates that the ad is unattributed.

click Id

string

A unique string for each visit that is passed to the landing page as the click id URL parameter.

visit Date Time

string

The timestamp of the visit event. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

product Id

string

The ID of the product clicked on.

product Channel

enum ( ProductChannel )

The sales channel of the product that was clicked on: Online or Local.

product Language Code

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

product Store Id

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

product Country Code

string

The country (ISO-3166 format) registered for the inventory feed that contains the product clicked on.

asset Id

string ( int64 format)

ID of the asset which was interacted with during the visit event.

asset Field Type

enum ( AssetFieldType )

Asset field type of the visit event.

ProductChannel

Enum describing the locality of a product offer.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ONLINE The item is sold online.
LOCAL The item is sold in local stores.

تبدیل

A conversion.

نمایندگی JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
فیلدها
resource Name

string

The resource name of the conversion. Conversion resource names have the form:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string ( int64 format)

The ID of the conversion

criterion Id

string ( int64 format)

Search Ads 360 criterion ID. A value of 0 indicates that the criterion is unattributed.

merchant Id

string ( int64 format)

The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.

ad Id

string ( int64 format)

Ad ID. A value of 0 indicates that the ad is unattributed.

click Id

string

A unique string, for the visit that the conversion is attributed to, that is passed to the landing page as the click id URL parameter.

visit Id

string ( int64 format)

The Search Ads 360 visit ID that the conversion is attributed to.

advertiser Conversion Id

string

For offline conversions, this is an ID provided by advertisers. If an advertiser doesn't specify such an ID, Search Ads 360 generates one. For online conversions, this is equal to the id column or the floodlightOrderId column depending on the advertiser's Floodlight instructions.

product Id

string

The ID of the product clicked on.

product Channel

enum ( ProductChannel )

The sales channel of the product that was clicked on: Online or Local.

product Language Code

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

product Store Id

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

product Country Code

string

The country (ISO-3166-format) registered for the inventory feed that contains the product clicked on.

attribution Type

enum ( AttributionType )

What the conversion is attributed to: Visit or Keyword+Ad.

conversion Date Time

string

The timestamp of the conversion event.

conversion Last Modified Date Time

string

The timestamp of the last time the conversion was modified.

conversion Visit Date Time

string

The timestamp of the visit that the conversion is attributed to.

conversion Quantity

string ( int64 format)

The quantity of items recorded by the conversion, as determined by the qty url parameter. The advertiser is responsible for dynamically populating the parameter (such as number of items sold in the conversion), otherwise it defaults to 1.

conversion Revenue Micros

string ( int64 format)

The adjusted revenue in micros for the conversion event. This will always be in the currency of the serving account.

floodlight Original Revenue

string ( int64 format)

The original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications.

floodlight Order Id

string

The Floodlight order ID provided by the advertiser for the conversion.

status

enum ( ConversionStatus )

The status of the conversion, either ENABLED or REMOVED..

asset Id

string ( int64 format)

ID of the asset which was interacted with during the conversion event.

asset Field Type

enum ( AssetFieldType )

Asset field type of the conversion event.

AttributionType

Conversion attribution type in SearchAds360

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
VISIT The conversion is attributed to a visit.
CRITERION_AD The conversion is attributed to a criterion and ad pair.

ConversionStatus

Possible statuses of a conversion.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED The conversion is enabled.
REMOVED The conversion has been removed.

معیارها

Metrics data.

نمایندگی JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
فیلدها
all Conversions Value By Conversion Date

number

The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 .

all Conversions By Conversion Date

number

The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 .

conversion Custom Metrics[]

object ( Value )

The conversion custom metrics.

conversions Value By Conversion Date

number

The sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date.

conversions By Conversion Date

number

The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column means the conversion date.

historical Creative Quality Score

enum ( QualityScoreBucket )

The creative historical quality score.

historical Landing Page Quality Score

enum ( QualityScoreBucket )

The quality of historical landing page experience.

historical Search Predicted Ctr

enum ( QualityScoreBucket )

The historical search predicted click through rate (CTR).

interaction Event Types[]

enum ( InteractionEventType )

The types of payable and free interactions.

raw Event Conversion Metrics[]

object ( Value )

The raw event conversion metrics.

absolute Top Impression Percentage

number

Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position.

all Conversions From Interactions Rate

number

All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.

all Conversions Value

number

The value of all conversions.

all Conversions

number

The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric.

all Conversions Value Per Cost

number

The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).

all Conversions From Click To Call

number

The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls.

This metric applies to feed items only.

all Conversions From Directions

number

The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad.

This metric applies to feed items only.

all Conversions From Interactions Value Per Interaction

number

The value of all conversions from interactions divided by the total number of interactions.

all Conversions From Menu

number

The number of times people clicked a link to view a store's menu after clicking an ad.

This metric applies to feed items only.

all Conversions From Order

number

The number of times people placed an order at a store after clicking an ad.

This metric applies to feed items only.

all Conversions From Other Engagement

number

The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad.

This metric applies to feed items only.

all Conversions From Store Visit

number

Estimated number of times people visited a store after clicking an ad.

This metric applies to feed items only.

visits

number

Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.

all Conversions From Store Website

number

The number of times that people were taken to a store's URL after clicking an ad.

This metric applies to feed items only.

average Cost

number

The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.

average Cpc

number

The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

average Cpm

number

Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

string ( int64 format)

تعداد کلیک ها.

content Budget Lost Impression Share

number

The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

content Impression Share

number

The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

content Rank Lost Impression Share

number

The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

conversions From Interactions Rate

number

Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion.

client Account Conversions Value

number

The value of client account conversions. This only includes conversion actions which includeInClientAccountConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

conversions Value Per Cost

number

The value of biddable conversion divided by the total cost of conversion eligible interactions.

conversions From Interactions Value Per Interaction

number

The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

client Account Conversions

number

The number of client account conversions. This only includes conversion actions which includeInClientAccountConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

cost Micros

string ( int64 format)

The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cost Per All Conversions

number

The cost of ad interactions divided by all conversions.

cost Per Conversion

number

Average conversion eligible cost per biddable conversion.

cost Per Current Model Attributed Conversion

number

The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

cross Device Conversions

number

Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in allConversions.

cross Device Conversions By Conversion Date

number

The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 .

cross Device Conversions Value

number

The sum of the value of cross-device conversions.

cross Device Conversions Value By Conversion Date

number

The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 .

ctr

number

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).

conversions

number

The number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

conversions Value

number

The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions.

average Quality Score

number

The average quality score.

historical Quality Score

string ( int64 format)

The historical quality score.

impressions

string ( int64 format)

Count of how often your ad has appeared on a search results page or website on the Google Network.

interaction Rate

number

How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.

interactions

string ( int64 format)

The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.

invalid Click Rate

number

The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.

invalid Clicks

string ( int64 format)

Number of clicks Google considers illegitimate and doesn't charge you for.

general Invalid Click Rate

number

The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details.

general Invalid Clicks

string ( int64 format)

Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details.

mobile Friendly Clicks Percentage

number

The percentage of mobile clicks that go to a mobile-friendly page.

search Absolute Top Impression Share

number

The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999.

search Budget Lost Absolute Top Impression Share

number

The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

search Budget Lost Impression Share

number

The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

search Budget Lost Top Impression Share

number

The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

search Click Share

number

The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

search Exact Match Impression Share

number

The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

search Impression Share

number

The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

search Rank Lost Absolute Top Impression Share

number

The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

search Rank Lost Impression Share

number

The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

search Rank Lost Top Impression Share

number

The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.

search Top Impression Share

number

The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.

Top ads are generally above the top organic results, although they may show below the top organic results on certain queries.

top Impression Percentage

number

The percent of your ad impressions that are shown adjacent to the top organic search results.

value Per All Conversions

number

The value of all conversions divided by the number of all conversions.

value Per All Conversions By Conversion Date

number

The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 .

value Per Conversion

number

The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth.

value Per Conversions By Conversion Date

number

Biddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date.

client Account View Through Conversions

string ( int64 format)

The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad.

client Account Cross Sell Cost Of Goods Sold Micros

string ( int64 format)

Client account cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross Sell Cost Of Goods Sold Micros

string ( int64 format)

Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client Account Cross Sell Gross Profit Micros

string ( int64 format)

Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross Sell Gross Profit Micros

string ( int64 format)

Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client Account Cross Sell Revenue Micros

string ( int64 format)

Client account cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross Sell Revenue Micros

string ( int64 format)

Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client Account Cross Sell Units Sold

number

Client account cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data.

cross Sell Units Sold

number

Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data.

client Account Lead Cost Of Goods Sold Micros

string ( int64 format)

Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead Cost Of Goods Sold Micros

string ( int64 format)

Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client Account Lead Gross Profit Micros

string ( int64 format)

Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead Gross Profit Micros

string ( int64 format)

Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client Account Lead Revenue Micros

string ( int64 format)

Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead Revenue Micros

string ( int64 format)

Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client Account Lead Units Sold

number

Client account lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data.

lead Units Sold

number

Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data.

ارزش

A generic data container.

نمایندگی JSON 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
فیلدها
Union field value . یک ارزش value can be only one of the following:
boolean Value

boolean

یک بولی

int64 Value

string ( int64 format)

An int64.

float Value

number

A float.

double Value

number

A double.

string Value

string

یک رشته

QualityScoreBucket

Enum listing the possible quality score buckets.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
BELOW_AVERAGE Quality of the creative is below average.
AVERAGE Quality of the creative is average.
ABOVE_AVERAGE Quality of the creative is above average.

InteractionEventType

Enum describing possible types of payable and free interactions.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
CLICK Click to site. In most cases, this interaction navigates to an external location, usually the advertiser's landing page. This is also the default InteractionEventType for click events.
ENGAGEMENT The user's expressed intent to engage with the ad in-place.
VIDEO_VIEW User viewed a video ad.
NONE The default InteractionEventType for ad conversion events. This is used when an ad conversion row does NOT indicate that the free interactions (for example, the ad conversions) should be 'promoted' and reported as part of the core metrics. These are simply other (ad) conversions.

بخش ها

Segment only fields.

نمایندگی JSON 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
فیلدها
ad Network Type

enum ( AdNetworkType )

Ad network type.

conversion Action Category

enum ( ConversionActionCategory )

Conversion action category.

conversion Custom Dimensions[]

object ( Value )

The conversion custom dimensions.

day Of Week

enum ( DayOfWeek )

Day of the week, for example, MONDAY.

device

enum ( Device )

Device to which metrics apply.

keyword

object ( Keyword )

Keyword criterion.

product Channel

enum ( ProductChannel )

Channel of the product.

product Channel Exclusivity

enum ( ProductChannelExclusivity )

Channel exclusivity of the product.

product Condition

enum ( ProductCondition )

Condition of the product.

product Sold Condition

enum ( ProductCondition )

Condition of the product sold.

raw Event Conversion Dimensions[]

object ( Value )

The raw event conversion dimensions.

conversion Action

string

Resource name of the conversion action.

conversion Action Name

string

Conversion action name.

date

string

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

geo Target City

string

Resource name of the geo target constant that represents a city.

geo Target Country

string

Resource name of the geo target constant that represents a country.

geo Target Metro

string

Resource name of the geo target constant that represents a metro.

geo Target Region

string

Resource name of the geo target constant that represents a region.

hour

integer

Hour of day as a number between 0 and 23, inclusive.

month

string

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

product Bidding Category Level1

string

Bidding category (level 1) of the product.

product Bidding Category Level2

string

Bidding category (level 2) of the product.

product Bidding Category Level3

string

Bidding category (level 3) of the product.

product Bidding Category Level4

string

Bidding category (level 4) of the product.

product Bidding Category Level5

string

Bidding category (level 5) of the product.

product Brand

string

Brand of the product.

product Country

string

Resource name of the geo target constant for the country of sale of the product.

product Custom Attribute0

string

Custom attribute 0 of the product.

product Custom Attribute1

string

Custom attribute 1 of the product.

product Custom Attribute2

string

Custom attribute 2 of the product.

product Custom Attribute3

string

Custom attribute 3 of the product.

product Custom Attribute4

string

Custom attribute 4 of the product.

product Item Id

string

Item ID of the product.

product Language

string

Resource name of the language constant for the language of the product.

product Sold Bidding Category Level1

string

Bidding category (level 1) of the product sold.

product Sold Bidding Category Level2

string

Bidding category (level 2) of the product sold.

product Sold Bidding Category Level3

string

Bidding category (level 3) of the product sold.

product Sold Bidding Category Level4

string

Bidding category (level 4) of the product sold.

product Sold Bidding Category Level5

string

Bidding category (level 5) of the product sold.

product Sold Brand

string

Brand of the product sold.

product Sold Custom Attribute0

string

Custom attribute 0 of the product sold.

product Sold Custom Attribute1

string

Custom attribute 1 of the product sold.

product Sold Custom Attribute2

string

Custom attribute 2 of the product sold.

product Sold Custom Attribute3

string

Custom attribute 3 of the product sold.

product Sold Custom Attribute4

string

Custom attribute 4 of the product sold.

product Sold Item Id

string

Item ID of the product sold.

product Sold Title

string

Title of the product sold.

product Sold Type L1

string

Type (level 1) of the product sold.

product Sold Type L2

string

Type (level 2) of the product sold.

product Sold Type L3

string

Type (level 3) of the product sold.

product Sold Type L4

string

Type (level 4) of the product sold.

product Sold Type L5

string

Type (level 5) of the product sold.

product Store Id

string

Store ID of the product.

product Title

string

Title of the product.

product Type L1

string

Type (level 1) of the product.

product Type L2

string

Type (level 2) of the product.

product Type L3

string

Type (level 3) of the product.

product Type L4

string

Type (level 4) of the product.

product Type L5

string

Type (level 5) of the product.

quarter

string

Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.

week

string

Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

year

integer

Year, formatted as yyyy.

asset Interaction Target

object ( AssetInteractionTarget )

Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interactionOnThisAsset is true, it means the interactions are on this specific asset and when interactionOnThisAsset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with.

AdNetworkType

Enumerates Google Ads network types.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN The value is unknown in this version.
SEARCH Google search.
SEARCH_PARTNERS Search partners.
CONTENT Display Network.
YOUTUBE_WATCH ویدیوهای یوتیوب
MIXED متقابل شبکه

کلمه کلیدی

A Keyword criterion segment.

نمایندگی JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
فیلدها
info

object ( KeywordInfo )

Keyword info.

ad Group Criterion

string

The AdGroupCriterion resource name.

ProductChannelExclusivity

Enum describing the availability of a product offer.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
SINGLE_CHANNEL The item is sold through one channel only, either local stores or online as indicated by its ProductChannel.
MULTI_CHANNEL The item is matched to its online or local stores counterpart, indicating it is available for purchase in both ShoppingProductChannels.

ProductCondition

Enum describing the condition of a product offer.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
OLD The product condition is old.
NEW The product condition is new.
REFURBISHED The product condition is refurbished.
USED The product condition is used.

AssetInteractionTarget

An AssetInteractionTarget segment.

نمایندگی JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
فیلدها
asset

string

The asset resource name.

interaction On This Asset

boolean

Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.