SearchAds360Row

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

نمایندگی JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "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)
  },
  "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)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
زمینه های
adGroup

object ( AdGroup )

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

adGroupAd

object ( AdGroupAd )

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

adGroupAdLabel

object ( AdGroupAdLabel )

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

adGroupAsset

object ( AdGroupAsset )

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

adGroupAssetSet

object ( AdGroupAssetSet )

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

adGroupAudienceView

object ( AdGroupAudienceView )

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

adGroupBidModifier

object ( AdGroupBidModifier )

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

adGroupCriterion

object ( AdGroupCriterion )

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

adGroupCriterionLabel

object ( AdGroupCriterionLabel )

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

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 )

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

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 )

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

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 )

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

webpageView

object ( WebpageView )

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

visit

object ( Visit )

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

conversion

object ( Conversion )

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

metrics

object ( Metrics )

معیارها

segments

object ( Segments )

بخش ها

customColumns[]

object ( Value )

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

AdGroup

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

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

string

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

customers/{customerId}/adGroups/{ad_group_id}

status

enum ( AdGroupStatus )

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

type

enum ( AdGroupType )

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

adRotationMode

enum ( AdGroupAdRotationMode )

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

creationTime

string

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

targetingSetting

object ( TargetingSetting )

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

labels[]

string

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

engineId

string

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

startDate

string

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

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

endDate

string

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

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

languageCode

string

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

lastModifiedTime

string

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

id

string ( int64 format)

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

name

string

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

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

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

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

cpcBidMicros

string ( int64 format)

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

engineStatus

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)
    }
  ]
}
زمینه های
targetRestrictions[]

object ( TargetRestriction )

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

محدودیت هدف

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

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

enum ( TargetingDimension )

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

bidOnly

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
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
زمینه های
resourceName

string

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

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

status

enum ( AdGroupAdStatus )

وضعیت آگهی.

ad

object ( Ad )

آگهی

creationTime

string

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

labels[]

string

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

engineId

string

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

engineStatus

enum ( AdGroupAdEngineStatus )

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

lastModifiedTime

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 تبلیغ پاسخگو ویدیوی اکتشافی.

SearchAds360TextAdInfo

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

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

string

تیتر آگهی.

description1

string

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

description2

string

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

displayUrl

string

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

displayMobileUrl

string

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

adTrackingId

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 اضافه شد.

adTrackingId

string ( int64 format)

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

SearchAds360ResponsiveSearchAdInfo

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

نمایندگی JSON
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
زمینه های
path1

string

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

path2

string

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

adTrackingId

string ( int64 format)

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

SearchAds360ProductAdInfo

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

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

SearchAds360ExpandedDynamicSearchAdInfo

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

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

string

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

description2

string

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

adTrackingId

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 خلاقیت موقتاً متوقف شده است زیرا گروه آگهی متوقف شده است.

AdGroupAdLabel

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

نمایندگی JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}
زمینه های
resourceName

string

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

adGroupAd

string

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

label

string

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

AdGroupAsset

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

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

string

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

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

adGroup

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)
}
زمینه های
resourceName

string

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

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

adGroup

string

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

assetSet

string

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

status

enum ( AssetSetLinkStatus )

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

AssetSetLinkStatus

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

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

AdGroupAudienceView

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

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

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.
}
زمینه های
resourceName

string

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

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

bidModifier

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
  ],
  "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.
}
زمینه های
resourceName

string

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

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

creationTime

string

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

status

enum ( AdGroupCriterionStatus )

وضعیت معیار.

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

qualityInfo

object ( QualityInfo )

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

type

enum ( CriterionType )

نوع معیار.

labels[]

string

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

positionEstimates

object ( PositionEstimates )

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

finalUrls[]

string

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

engineId

string

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

lastModifiedTime

string

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

criterionId

string ( int64 format)

شناسه معیار.

adGroup

string

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

negative

boolean

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

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

bidModifier

number

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

cpcBidMicros

string ( int64 format)

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

effectiveCpcBidMicros

string ( int64 format)

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

engineStatus

enum ( AdGroupCriterionEngineStatus )

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

finalUrlSuffix

string

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

trackingUrlTemplate

string

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

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

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

keyword

object ( KeywordInfo )

کلمه کلیدی.

listingGroup

object ( ListingGroupInfo )

گروه لیست.

ageRange

object ( AgeRangeInfo )

رده سنی.

gender

object ( GenderInfo )

جنسیت.

userList

object ( UserListInfo )

فهرست کاربران.

webpage

object ( WebpageInfo )

صفحه وب

location

object ( LocationInfo )

محل.

AdGroupCriterionStatus

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

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

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

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

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

QualityInfo

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

نمایندگی JSON
{
  "qualityScore": integer
}
زمینه های
qualityScore

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
}
زمینه های
topOfPageCpcMicros

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
}
زمینه های
matchType

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
}
زمینه های
userList

string

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

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

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

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

object ( WebpageConditionInfo )

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

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

coveragePercentage

number

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

criterionName

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
}
زمینه های
geoTargetConstant

string

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

AdGroupCriterionLabel

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

نمایندگی JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}
زمینه های
resourceName

string

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

adGroupCriterion

string

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

label

string

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

قصبه

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

نمایندگی JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
زمینه های
resourceName

string

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

adGroup

string

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

label

string

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

سرود

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

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

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.
}
زمینه های
resourceName

string

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

customers/{customerId}/assets/{assetId}

type

enum ( AssetType )

نوع دارایی.

finalUrls[]

string

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

status

enum ( AssetStatus )

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

creationTime

string

زمانی که این دارایی ایجاد شد. Timestamp در منطقه زمانی مشتری و در قالب "YYYYY-MM-DD HH: MM: SS" است.

lastModifiedTime

string

DateTime که آخرین بار این دارایی اصلاح شد. DateTime در منطقه زمانی مشتری و در قالب "Yyyy-MM-DD HH: MM: SSSSSSSS" است.

id

string ( int64 format)

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

name

string

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

trackingUrlTemplate

string

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

engineStatus

enum ( AssetEngineStatus )

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

Union Field asset_data . نوع خاص دارایی. asset_data می تواند تنها یکی از موارد زیر باشد:
youtubeVideoAsset

object ( YoutubeVideoAsset )

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

imageAsset

object ( ImageAsset )

یک دارایی تصویر

textAsset

object ( TextAsset )

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

calloutAsset

object ( UnifiedCalloutAsset )

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

pageFeedAsset

object ( UnifiedPageFeedAsset )

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

mobileAppAsset

object ( MobileAppAsset )

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

callAsset

object ( UnifiedCallAsset )

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

callToActionAsset

object ( CallToActionAsset )

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

locationAsset

object ( UnifiedLocationAsset )

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

دارایی

ENUM توصیف انواع احتمالی دارایی.

نماد
UNSPECIFIED مشخص نشده است
UNKNOWN فقط برای مقدار بازگشت استفاده می شود. مقدار ناشناخته در این نسخه را نشان می دهد.
YOUTUBE_VIDEO دارایی ویدیویی YouTube.
MEDIA_BUNDLE دارایی بسته نرم افزاری رسانه.
IMAGE دارایی تصویر
TEXT دارایی متن
LEAD_FORM دارایی فرم سرب.
BOOK_ON_GOOGLE کتاب در Google Asset.
PROMOTION دارایی ارتقاء
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 دارایی املاک هتل.

دارایی

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

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

دارایی

شناسه بعدی = 11

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

YouTubeVideoAsset

یک دارایی یوتیوب.

نمایندگی JSON
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
زمینه های
youtubeVideoTitle

string

عنوان ویدیوی YouTube.

youtubeVideoId

string

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

تصویر

یک دارایی تصویر

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

enum ( MimeType )

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

fullSize

object ( ImageDimension )

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

fileSize

string ( int64 format)

اندازه پرونده دارایی تصویر در بایت.

نوع تقلید

نوع تقلید

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

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

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

IMAGE_JPEG نوع MIME تصویر/jpeg.
IMAGE_GIF نوع MIME تصویر/gif.
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
}
زمینه های
heightPixels

string ( int64 format)

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

widthPixels

string ( int64 format)

عرض تصویر.

url

string

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

دارایی

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

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

string

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

یکپارچه

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

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

string

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

startDate

string

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

endDate

string

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

adScheduleTargets[]

object ( AdScheduleInfo )

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

useSearcherTimeZone

boolean

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

adscheduleinfo

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

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

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

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

enum ( MinuteOfHour )

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

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

endMinute

enum ( MinuteOfHour )

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

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

dayOfWeek

enum ( DayOfWeek )

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

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

startHour

integer

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

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

endHour

integer

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

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

دقیقه

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

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

روز هفته

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

نماد
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
}
زمینه های
description1

string

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

description2

string

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

startDate

string

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

endDate

string

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

adScheduleTargets[]

object ( AdScheduleInfo )

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

trackingId

string ( int64 format)

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

useSearcherTimeZone

boolean

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

mobilePreferred

boolean

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

یکپارچه

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

نمایندگی JSON
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
زمینه های
pageUrl

string

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

labels[]

string

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

موبایل

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

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

string

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

appStore

enum ( MobileAppVendor )

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

موبایل

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

نماد
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
}
زمینه های
countryCode

string

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

phoneNumber

string

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

callConversionReportingState

enum ( CallConversionReportingState )

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

callConversionAction

string

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

adScheduleTargets[]

object ( AdScheduleInfo )

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

callOnly

boolean

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

callTrackingEnabled

boolean

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

useSearcherTimeZone

boolean

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

startDate

string

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

endDate

string

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

CallConversionReportingState

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

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

calltoactionasset

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

نمایندگی JSON
{
  "callToAction": enum (CallToActionType)
}
زمینه های
callToAction

enum ( CallToActionType )

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

نوع calltoactiontype

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

نماد
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)
}
زمینه های
placeId

string

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

businessProfileLocations[]

object ( BusinessProfileLocation )

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

locationOwnershipType

enum ( LocationOwnershipType )

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

تجارت

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

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

string

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

storeCode

string

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

listingId

string ( int64 format)

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

موقعیت مکانی

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

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

دارایی گروه

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

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

string

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

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

assetGroup

string

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

asset

string

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

fieldType

enum ( AssetFieldType )

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

status

enum ( AssetLinkStatus )

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

نوع دارایی

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

نماد
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.
}
زمینه های
resourceName

string

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

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

assetGroup

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)
  }
}
زمینه های
resourceName

string

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

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

assetGroup

string

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

id

string ( int64 format)

شناسه ListingGroupFilter.

type

enum ( ListingGroupFilterType )

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

vertical

enum ( ListingGroupFilterVertical )

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

caseValue

object ( ListingGroupFilterDimension )

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

parentListingGroupFilter

string

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

path

object ( ListingGroupFilterDimensionPath )

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

ListingGroupFilterType

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

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

لیست groupfiltervertical

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

نماد
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 فقط می تواند یکی از موارد زیر باشد:
productBiddingCategory

object ( ProductBiddingCategory )

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

productBrand

object ( ProductBrand )

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

productChannel

object ( ProductChannel )

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

productCondition

object ( ProductCondition )

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

productCustomAttribute

object ( ProductCustomAttribute )

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

productItemId

object ( ProductItemId )

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

productType

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

لیست

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

نماد
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 توصیف محل پیشنهاد محصول.

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

شرط محصول

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

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

enum ( ListingGroupFilterProductCondition )

ارزش شرط.

ListingGroupFilterProductCondition

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

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

محصول

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

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

enum ( ListingGroupFilterCustomAttributeIndex )

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

value

string

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

لیست groupfiltercustomattributeIndex

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

نماد
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 توصیف سطح نوع یک محصول ارائه شده است.

نماد
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)
    }
  ]
}
زمینه های
resourceName

string

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

assetGroupTopCombinations[]

object ( AssetGroupAssetCombinationData )

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

assetgroupassetcombinationdata

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

نمایندگی JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
زمینه های
assetCombinationServedAssets[]

object ( AssetUsage )

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

دارایی

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

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

string

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

servedAssetFieldType

enum ( ServedAssetFieldType )

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

servalassetfieldtype

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

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

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

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

HEADLINE_1 دارایی در عنوان 1 استفاده می شود.
HEADLINE_2 دارایی در عنوان 2 استفاده می شود.
HEADLINE_3 دارایی در عنوان 3 استفاده می شود.
DESCRIPTION_1 دارایی در توضیحات 1 استفاده می شود.
DESCRIPTION_2 دارایی در توضیحات 2 استفاده می شود.
HEADLINE دارایی در یک تیتر استفاده شد. از این استفاده کنید فقط در صورتی که فقط یک عنوان در تبلیغ وجود داشته باشد. در غیر این صورت ، از enums teilline_1 ، teilline_2 یا عنوان_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)
}
زمینه های
resourceName

string

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

customers/{customerId}/assetGroups/{asset_group_id}

id

string ( int64 format)

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

campaign

string

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

name

string

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

finalUrls[]

string

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

finalMobileUrls[]

string

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

status

enum ( AssetGroupStatus )

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

path1

string

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

path2

string

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

adStrength

enum ( AdStrength )

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

گروه گروهی

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

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

قید

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

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

دارایی

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

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

string

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

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

assetSet

string

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

asset

string

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

status

enum ( AssetSetAssetStatus )

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

دارایی

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

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

دارایی

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

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

string ( int64 format)

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

resourceName

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.
}
زمینه های
resourceName

string

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

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum ( BiddingStrategyStatus )

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

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

type

enum ( BiddingStrategyType )

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

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

currencyCode

string

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

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

id

string ( int64 format)

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

name

string

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

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

effectiveCurrencyCode

string

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

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

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

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

campaignCount

string ( int64 format)

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

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

nonRemovedCampaignCount

string ( int64 format)

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

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

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

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

enhancedCpc

object ( EnhancedCpc )

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

maximizeConversionValue

object ( MaximizeConversionValue )

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

maximizeConversions

object ( MaximizeConversions )

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

targetCpa

object ( TargetCpa )

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

targetImpressionShare

object ( TargetImpressionShare )

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

targetOutrankShare

object ( TargetOutrankShare )

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

targetRoas

object ( TargetRoas )

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

targetSpend

object ( TargetSpend )

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

پیشنهادات

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

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

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

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

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

piddingStrategyType

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

نماد
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 Target CPA یک استراتژی پیشنهاد خودکار است که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (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
}
زمینه های
cpcBidCeilingMicros

string ( int64 format)

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

cpcBidFloorMicros

string ( int64 format)

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

targetRoas

number

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

حداکثر

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

نمایندگی JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
زمینه های
cpcBidCeilingMicros

string ( int64 format)

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

cpcBidFloorMicros

string ( int64 format)

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

targetCpaMicros

string ( int64 format)

گزینه Cost-Action Target (CPA). این میانگین مبلغی است که شما می خواهید در هر اقدام تبدیل شده در واحدهای خرد از ارز استراتژی مناقصه هزینه کنید. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget.

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 representation
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
زمینه های
targetCpaMicros

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.

cpcBidCeilingMicros

string ( int64 format)

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.

cpcBidFloorMicros

string ( int64 format)

Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.

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 representation
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
زمینه های
location

enum ( TargetImpressionShareLocation )

The targeted location on the search results page.

locationFractionMicros

string ( int64 format)

The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.

cpcBidCeilingMicros

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.

TargetImpressionShareLocation

Enum describing possible goals.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
ANYWHERE_ON_PAGE Any location on the web page.
TOP_OF_PAGE Top box of ads.
ABSOLUTE_TOP_OF_PAGE Top slot in the top box of ads.

TargetOutrankShare

An automated bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This strategy is deprecated.

JSON representation
{
  "cpcBidCeilingMicros": string
}
زمینه های
cpcBidCeilingMicros

string ( Int64Value format)

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

TargetRoas

An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).

JSON representation
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
زمینه های
targetRoas

number

ضروری. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.

cpcBidCeilingMicros

string ( int64 format)

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.

cpcBidFloorMicros

string ( int64 format)

Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.

TargetSpend

An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.

JSON representation
{
  "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.

cpcBidCeilingMicros

string ( int64 format)

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

CampaignBudget

A campaign budget.

JSON representation
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
زمینه های
resourceName

string

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

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum ( BudgetDeliveryMethod )

The delivery method that determines the rate at which the campaign budget is spent.

Defaults to STANDARD if unspecified in a create operation.

period

enum ( BudgetPeriod )

Period over which to spend the budget. Defaults to DAILY if not specified.

amountMicros

string ( int64 format)

The amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. Monthly spend is capped at 30.4 times this amount.

BudgetDeliveryMethod

Possible delivery methods of a Budget.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
STANDARD The budget server will throttle serving evenly across the entire time period.
ACCELERATED The budget server will not throttle serving, and ads will serve as fast as possible.

BudgetPeriod

Possible period of a Budget.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
DAILY بودجه روزانه.
FIXED_DAILY Fixed daily budget.
CUSTOM_PERIOD Custom budget can be used with total_amount to specify lifetime budget limit.

پویش

کمپین.

JSON representation
{
  "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)
  },
  "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.
}
زمینه های
resourceName

string

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

customers/{customerId}/campaigns/{campaign_id}

status

enum ( CampaignStatus )

The status of the campaign.

When a new campaign is added, the status defaults to ENABLED.

servingStatus

enum ( CampaignServingStatus )

The ad serving status of the campaign.

biddingStrategySystemStatus

enum ( BiddingStrategySystemStatus )

The system status of the campaign's bidding strategy.

adServingOptimizationStatus

enum ( AdServingOptimizationStatus )

The ad serving optimization status of the campaign.

advertisingChannelType

enum ( AdvertisingChannelType )

The primary serving target for ads within the campaign. The targeting options can be refined in networkSettings .

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

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

advertisingChannelSubType

enum ( AdvertisingChannelSubType )

Optional refinement to advertisingChannelType . Must be a valid sub-type of the parent channel type.

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

urlCustomParameters[]

object ( CustomParameter )

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

realTimeBiddingSetting

object ( RealTimeBiddingSetting )

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

networkSettings

object ( NetworkSettings )

The network settings for the campaign.

dynamicSearchAdsSetting

object ( DynamicSearchAdsSetting )

The setting for controlling Dynamic Search Ads (DSA).

shoppingSetting

object ( ShoppingSetting )

The setting for controlling Shopping campaigns.

geoTargetTypeSetting

object ( GeoTargetTypeSetting )

The setting for ads geotargeting.

labels[]

string

The resource names of labels attached to this campaign.

biddingStrategyType

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.

accessibleBiddingStrategy

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.

frequencyCaps[]

object ( FrequencyCapEntry )

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

selectiveOptimization

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.

optimizationGoalSetting

object ( OptimizationGoalSetting )

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

trackingSetting

object ( TrackingSetting )

Campaign-level settings for tracking information.

engineId

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.

excludedParentAssetFieldTypes[]

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.

createTime

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.

creationTime

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.

lastModifiedTime

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)

The ID of the campaign.

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.

trackingUrlTemplate

string

The URL template for constructing a tracking URL.

campaignBudget

string

The budget of the campaign.

startDate

string

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

endDate

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.

finalUrlSuffix

string

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

urlExpansionOptOut

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:

biddingStrategy

string

Portfolio bidding strategy used by campaign.

manualCpa

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.

manualCpc

object ( ManualCpc )

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

manualCpm

object ( ManualCpm )

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

maximizeConversions

object ( MaximizeConversions )

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

maximizeConversionValue

object ( MaximizeConversionValue )

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

targetCpa

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.

targetImpressionShare

object ( TargetImpressionShare )

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

targetRoas

object ( TargetRoas )

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

targetSpend

object ( TargetSpend )

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

percentCpc

object ( PercentCpc )

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

targetCpm

object ( TargetCpm )

A bidding strategy that automatically optimizes cost per thousand impressions.

CampaignStatus

Possible statuses of a campaign.

Enums
UNSPECIFIED Not specified.
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 به پایان رسید.
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 Not specified.
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.

AdvertisingChannelSubType

Enum describing the different channel subtypes.

Enums
UNSPECIFIED Not specified.
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.

CustomParameter

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

JSON representation
{
  "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 representation
{
  "optIn": boolean
}
زمینه های
optIn

boolean

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

تنظیمات شبکه

The network settings for the campaign.

JSON representation
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
زمینه های
targetSearchNetwork

boolean

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

targetContentNetwork

boolean

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

targetPartnerSearchNetwork

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 representation
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
زمینه های
domainName

string

ضروری. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".

languageCode

string

ضروری. The language code specifying the language of the domain, for example, "en".

useSuppliedUrlsOnly

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 representation
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
زمینه های
feedLabel

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.

useVehicleInventory

boolean

Whether to target Vehicle Listing inventory.

merchantId

string ( int64 format)

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

salesCountry

string

Sales country of products to include in the campaign.

campaignPriority

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.

enableLocal

boolean

Whether to include local products.

GeoTargetTypeSetting

Represents a collection of settings related to ads geotargeting.

JSON representation
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
زمینه های
positiveGeoTargetType

enum ( PositiveGeoTargetType )

The setting used for positive geotargeting in this particular campaign.

negativeGeoTargetType

enum ( NegativeGeoTargetType )

The setting used for negative geotargeting in this particular campaign.

PositiveGeoTargetType

The possible positive geo target types.

Enums
UNSPECIFIED Not specified.
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 Not specified.
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

This type has no fields.

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 representation
{
  "conversionActions": [
    string
  ]
}
زمینه های
conversionActions[]

string

The selected set of conversion actions for optimizing this campaign.

OptimizationGoalSetting

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

JSON representation
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
زمینه های
optimizationGoalTypes[]

enum ( OptimizationGoalType )

The list of optimization goal types.

OptimizationGoalType

The type of optimization goal

Enums
UNSPECIFIED Not specified.
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 representation
{
  "trackingUrl": string
}
زمینه های
trackingUrl

string

The url used for dynamic tracking.

ManualCpa

This type has no fields.

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 representation
{
  "enhancedCpcEnabled": boolean
}
زمینه های
enhancedCpcEnabled

boolean

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

ManualCpm

This type has no fields.

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 representation
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
زمینه های
cpcBidCeilingMicros

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.

enhancedCpcEnabled

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

This type has no fields.

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 representation
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
زمینه های
resourceName

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 representation
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
زمینه های
resourceName

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.

assetSet

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 representation
{
  "resourceName": string
}
زمینه های
resourceName

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 representation
{
  "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.
}
زمینه های
resourceName

string

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

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

displayName

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.

lastModifiedTime

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.

criterionId

string ( int64 format)

The ID of the criterion.

This field is ignored during mutate.

bidModifier

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 )

دستگاه

ageRange

object ( AgeRangeInfo )

رده سنی.

gender

object ( GenderInfo )

جنسیت.

userList

object ( UserListInfo )

فهرست کاربران.

language

object ( LanguageInfo )

زبان.

webpage

object ( WebpageInfo )

صفحه وب.

locationGroup

object ( LocationGroupInfo )

Location Group

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 representation
{
  "languageConstant": string
}
زمینه های
languageConstant

string

The language constant resource name.

LocationGroupInfo

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

JSON representation
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
زمینه های
geoTargetConstants[]

string

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

radiusUnits

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.

feedItemSets[]

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 Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
METERS متر
MILES مایل
MILLI_MILES Milli Miles

CampaignLabel

Represents a relationship between a campaign and a label.

JSON representation
{
  "resourceName": string,
  "campaign": string,
  "label": string
}
زمینه های
resourceName

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.

CartDataSalesView

Cart data sales view.

JSON representation
{
  "resourceName": string
}
زمینه های
resourceName

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 representation
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
زمینه های
resourceName

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 representation
{
  "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
}
زمینه های
resourceName

string

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

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

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.

valueSettings

object ( ValueSettings )

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

attributionModelSettings

object ( AttributionModelSettings )

Settings related to this conversion action's attribution model.

floodlightSettings

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.

primaryForGoal

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.

ownerCustomer

string

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

includeInClientAccountConversionsMetric

boolean

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

includeInConversionsMetric

boolean

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

clickThroughLookbackWindowDays

string ( int64 format)

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

appId

string

App ID for an app conversion action.

ConversionActionStatus

Possible statuses of a conversion action.

Enums
UNSPECIFIED Not specified.
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 Not specified.
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. فقط خواندنی.
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. فقط خواندنی.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions that track all Google Play downloads which aren't tracked by an app-specific type. فقط خواندنی.
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. فقط خواندنی.
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. فقط خواندنی.
GOOGLE_HOSTED Conversions that track local actions from Google's products and services after interacting with an ad. فقط خواندنی.
LEAD_FORM_SUBMIT Conversions reported when a user submits a lead form. فقط خواندنی.
SALESFORCE Conversions that come from Salesforce. فقط خواندنی.
SEARCH_ADS_360 Conversions imported from Search Ads 360 Floodlight data. فقط خواندنی.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Call conversions that occur on Smart campaign Ads without call tracking setup, using Smart campaign custom criteria. فقط خواندنی.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL The user clicks on a call element within Google Maps. Smart campaign only. فقط خواندنی.
SMART_CAMPAIGN_MAP_DIRECTIONS The user requests directions to a business location within Google Maps. Smart campaign only. فقط خواندنی.
SMART_CAMPAIGN_TRACKED_CALLS Call conversions that occur on Smart campaign Ads with call tracking setup, using Smart campaign custom criteria. فقط خواندنی.
STORE_VISITS Conversions that occur when a user visits an advertiser's retail store. فقط خواندنی.
WEBPAGE_CODELESS Conversions created from website events (such as form submissions or page loads), that don't use individually coded event snippets. فقط خواندنی.
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 Not specified.
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 representation
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
زمینه های
defaultValue

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.

defaultCurrencyCode

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.

alwaysUseDefaultValue

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 representation
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
زمینه های
attributionModel

enum ( AttributionModel )

The attribution model type of this conversion action.

dataDrivenModelStatus

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 Not specified.
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 Not specified.
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 representation
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
زمینه های
activityGroupTag

string

String used to identify a Floodlight activity group when reporting conversions.

activityTag

string

String used to identify a Floodlight activity when reporting conversions.

activityId

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 representation
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
زمینه های
resourceName

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.

ownerCustomer

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.

floodlightConversionCustomVariableInfo

object ( FloodlightConversionCustomVariableInfo )

Fields for Search Ads 360 floodlight conversion custom variables.

customColumnIds[]

string ( int64 format)

The IDs of custom columns that use this conversion custom variable.

ConversionCustomVariableStatus

Possible statuses of a conversion custom variable.

Enums
UNSPECIFIED Not specified.
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 Not specified.
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 Not specified.
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 representation
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
زمینه های
floodlightVariableType

enum ( FloodlightVariableType )

Floodlight variable type defined in Search Ads 360.

floodlightVariableDataType

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 Not specified.
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 Not specified.
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.

مشتری

یک مشتری.

JSON representation
{
  "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
}
زمینه های
resourceName

string

The resource name of the customer. Customer resource names have the form:

customers/{customerId}

conversionTrackingSetting

object ( ConversionTrackingSetting )

Conversion tracking setting for a customer.

accountType

enum ( AccountType )

Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.

doubleClickCampaignManagerSetting

object ( DoubleClickCampaignManagerSetting )

DoubleClick Campaign Manager (DCM) setting for a manager customer.

accountStatus

enum ( AccountStatus )

Account status, for example, Enabled, Paused, Removed, etc.

lastModifiedTime

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.

engineId

string

ID of the account in the external engine account.

status

enum ( CustomerStatus )

The status of the customer.

creationTime

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.

descriptiveName

string

Optional, non-unique descriptive name of the customer.

currencyCode

string

The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.

timeZone

string

The local timezone ID of the customer.

trackingUrlTemplate

string

The URL template for constructing a tracking URL out of parameters.

finalUrlSuffix

string

The URL template for appending params to the final URL.

autoTaggingEnabled

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 representation
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
زمینه های
acceptedCustomerDataTerms

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 .

conversionTrackingStatus

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.

enhancedConversionsForLeadsEnabled

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.

googleAdsConversionCustomer

string

The resource name of the customer where conversions are created and managed. This field is read-only.

conversionTrackingId

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.

googleAdsCrossAccountConversionTrackingId

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.

crossAccountConversionTrackingId

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 Not specified.
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 Not specified.
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 representation
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
زمینه های
advertiserId

string ( int64 format)

ID of the Campaign Manager advertiser associated with this customer.

networkId

string ( int64 format)

ID of the Campaign Manager network associated with this customer.

timeZone

string

Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.

وضعیت حساب

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 Not specified.
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 representation
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
زمینه های
resourceName

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 representation
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
زمینه های
resourceName

string

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

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

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

Represents a view of BiddingStrategies owned by and shared with the customer.

In contrast to BiddingStrategy, this resource includes strategies owned by managers of the customer and shared with this customer - in addition to strategies owned by this customer. This resource does not provide metrics and only exposes a limited subset of the BiddingStrategy attributes.

JSON representation
{
  "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.
}
زمینه های
resourceName

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.

ownerCustomerId

string ( int64 format)

The ID of the Customer which owns the bidding strategy.

ownerDescriptiveName

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:

maximizeConversionValue

object ( MaximizeConversionValue )

An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.

maximizeConversions

object ( MaximizeConversions )

An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.

targetCpa

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.

targetImpressionShare

object ( TargetImpressionShare )

A bidding strategy that automatically optimizes towards a chosen percentage of impressions.

targetRoas

object ( TargetRoas )

A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).

targetSpend

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 representation
{
  "targetRoas": number
}
زمینه های
targetRoas

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 representation
{
  "targetCpa": string,
  "targetCpaMicros": string
}
زمینه های
targetCpa

string ( int64 format)

The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.

targetCpaMicros

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 representation
{
  "targetCpaMicros": string
}
زمینه های
targetCpaMicros

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 representation
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
زمینه های
location

enum ( TargetImpressionShareLocation )

The targeted location on the search results page.

locationFractionMicros

string ( int64 format)

The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.

cpcBidCeilingMicros

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 representation
{
  "targetRoas": number
}
زمینه های
targetRoas

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 representation
{
  "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.

cpcBidCeilingMicros

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 Not specified.
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 representation
{
  "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
}
زمینه های
resourceName

string

The resource name of the customer client. CustomerClient resource names have the form: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

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. فقط خواندنی.

clientCustomer

string

The resource name of the client-customer which is linked to the given customer. فقط خواندنی.

hidden

boolean

Specifies whether this is a hidden account.

فقط خواندنی.

level

string ( int64 format)

Distance between given customer and client. For self link, the level value will be 0. Read only.

timeZone

string

Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. فقط خواندنی.

testAccount

boolean

Identifies if the client is a test account. فقط خواندنی.

manager

boolean

Identifies if the client is a manager. فقط خواندنی.

descriptiveName

string

Descriptive name for the client. فقط خواندنی.

currencyCode

string

Currency code (for example, 'USD', 'EUR') for the client. فقط خواندنی.

id

string ( int64 format)

The ID of the client customer. فقط خواندنی.

DynamicSearchAdsSearchTermView

A dynamic search ads search term view.

JSON representation
{
  "resourceName": string,
  "landingPage": string
}
زمینه های
resourceName

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}

landingPage

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 representation
{
  "resourceName": string
}
زمینه های
resourceName

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 representation
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
زمینه های
resourceName

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.

countryCode

string

The ISO-3166-1 alpha-2 country code that is associated with the target.

targetType

string

Geo target constant target type.

canonicalName

string

The fully qualified English name, consisting of the target's name and that of its parent and country.

parentGeoTarget

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 representation
{
  "resourceName": string
}
زمینه های
resourceName

string

The resource name of the keyword view. Keyword view resource names have the form:

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

برچسب

یک برچسب.

JSON representation
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
زمینه های
resourceName

string

Name of the resource. Label resource names have the form: customers/{customerId}/labels/{label_id}

status

enum ( LabelStatus )

Status of the label. فقط خواندنی.

textLabel

object ( TextLabel )

A type of label displaying text on a colored background.

id

string ( int64 format)

ID of the label. فقط خواندنی.

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 Not specified.
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 representation
{
  "backgroundColor": string,
  "description": string
}
زمینه های
backgroundColor

string

Background color of the label in RGB 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 representation
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
زمینه های
resourceName

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 representation
{
  "resourceName": string
}
زمینه های
resourceName

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 representation
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
زمینه های
resourceName

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 .

countryCode

string

Two-letter upper-case country code of the product bidding category.

productBiddingCategoryConstantParent

string

Resource name of the parent product bidding category.

languageCode

string

Language code of the product bidding category.

localizedName

string

Display value of the product bidding category localized according to languageCode.

ProductBiddingCategoryLevel

Enum describing the level of the product bidding category.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEVEL1 سطح 1.
LEVEL2 سطح 2.
LEVEL3 سطح 3.
LEVEL4 Level 4.
LEVEL5 Level 5.

ProductBiddingCategoryStatus

Enum describing the status of the product bidding category.

Enums
UNSPECIFIED Not specified.
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 representation
{
  "resourceName": string
}
زمینه های
resourceName

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 representation
{
  "resourceName": string
}
زمینه های
resourceName

string

The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customerId}/shoppingPerformanceView

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

A user list. This is a list of users a customer may target.

JSON representation
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
زمینه های
resourceName

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 Not specified.
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.

WebpageView

A webpage view.

JSON representation
{
  "resourceName": string
}
زمینه های
resourceName

string

The resource name of the webpage view. Webpage view resource names have the form:

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

بازدید کنید

یک دیدار.

JSON representation
{
  "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)
}
زمینه های
resourceName

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.

criterionId

string ( int64 format)

Search Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed.

merchantId

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.

adId

string ( int64 format)

Ad ID. A value of 0 indicates that the ad is unattributed.

clickId

string

A unique string for each visit that is passed to the landing page as the click id URL parameter.

visitDateTime

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.

productId

string

The ID of the product clicked on.

productChannel

enum ( ProductChannel )

The sales channel of the product that was clicked on: Online or Local.

productLanguageCode

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

productStoreId

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

productCountryCode

string

The country (ISO-3166 format) registered for the inventory feed that contains the product clicked on.

assetId

string ( int64 format)

ID of the asset which was interacted with during the visit event.

assetFieldType

enum ( AssetFieldType )

Asset field type of the visit event.

ProductChannel

Enum describing the locality of a product offer.

Enums
UNSPECIFIED Not specified.
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 representation
{
  "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)
}
زمینه های
resourceName

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

criterionId

string ( int64 format)

Search Ads 360 criterion ID. A value of 0 indicates that the criterion is unattributed.

merchantId

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.

adId

string ( int64 format)

Ad ID. A value of 0 indicates that the ad is unattributed.

clickId

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.

visitId

string ( int64 format)

The Search Ads 360 visit ID that the conversion is attributed to.

advertiserConversionId

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.

productId

string

The ID of the product clicked on.

productChannel

enum ( ProductChannel )

The sales channel of the product that was clicked on: Online or Local.

productLanguageCode

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

productStoreId

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

productCountryCode

string

The country (ISO-3166-format) registered for the inventory feed that contains the product clicked on.

attributionType

enum ( AttributionType )

What the conversion is attributed to: Visit or Keyword+Ad.

conversionDateTime

string

The timestamp of the conversion event.

conversionLastModifiedDateTime

string

The timestamp of the last time the conversion was modified.

conversionVisitDateTime

string

The timestamp of the visit that the conversion is attributed to.

conversionQuantity

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.

conversionRevenueMicros

string ( int64 format)

The adjusted revenue in micros for the conversion event. This will always be in the currency of the serving account.

floodlightOriginalRevenue

string ( int64 format)

The original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications.

floodlightOrderId

string

The Floodlight order ID provided by the advertiser for the conversion.

status

enum ( ConversionStatus )

The status of the conversion, either ENABLED or REMOVED..

assetId

string ( int64 format)

ID of the asset which was interacted with during the conversion event.

assetFieldType

enum ( AssetFieldType )

Asset field type of the conversion event.

AttributionType

Conversion attribution type in SearchAds360

Enums
UNSPECIFIED Not specified.
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 Not specified.
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 representation
{
  "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,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": 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
}
زمینه های
allConversionsValueByConversionDate

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 .

allConversionsByConversionDate

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 .

conversionCustomMetrics[]

object ( Value )

The conversion custom metrics.

conversionsValueByConversionDate

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.

conversionsByConversionDate

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.

historicalCreativeQualityScore

enum ( QualityScoreBucket )

The creative historical quality score.

historicalLandingPageQualityScore

enum ( QualityScoreBucket )

The quality of historical landing page experience.

historicalSearchPredictedCtr

enum ( QualityScoreBucket )

The historical search predicted click through rate (CTR).

interactionEventTypes[]

enum ( InteractionEventType )

The types of payable and free interactions.

rawEventConversionMetrics[]

object ( Value )

The raw event conversion metrics.

absoluteTopImpressionPercentage

number

Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position.

allConversionsFromInteractionsRate

number

All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.

allConversionsValue

number

The value of all conversions.

allConversions

number

The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric.

allConversionsValuePerCost

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).

allConversionsFromClickToCall

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.

allConversionsFromDirections

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.

allConversionsFromInteractionsValuePerInteraction

number

The value of all conversions from interactions divided by the total number of interactions.

allConversionsFromMenu

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.

allConversionsFromOrder

number

The number of times people placed an order at a store after clicking an ad.

This metric applies to feed items only.

allConversionsFromOtherEngagement

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.

allConversionsFromStoreVisit

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.

allConversionsFromStoreWebsite

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.

averageCost

number

The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.

averageCpc

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

averageCpm

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)

The number of clicks.

contentBudgetLostImpressionShare

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.

contentImpressionShare

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.

contentRankLostImpressionShare

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.

conversionsFromInteractionsRate

number

Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion.

clientAccountConversionsValue

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.

conversionsValuePerCost

number

The value of biddable conversion divided by the total cost of conversion eligible interactions.

conversionsFromInteractionsValuePerInteraction

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.

clientAccountConversions

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.

costMicros

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

costPerAllConversions

number

The cost of ad interactions divided by all conversions.

costPerConversion

number

Average conversion eligible cost per biddable conversion.

costPerCurrentModelAttributedConversion

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.

crossDeviceConversions

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.

crossDeviceConversionsValue

number

The sum of the value of cross-device conversions.

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.

conversionsValue

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.

historicalQualityScore

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.

interactionRate

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.

invalidClickRate

number

The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.

invalidClicks

string ( int64 format)

Number of clicks Google considers illegitimate and doesn't charge you for.

mobileFriendlyClicksPercentage

number

The percentage of mobile clicks that go to a mobile-friendly page.

searchAbsoluteTopImpressionShare

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.

searchBudgetLostAbsoluteTopImpressionShare

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.

searchBudgetLostImpressionShare

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.

searchBudgetLostTopImpressionShare

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.

searchClickShare

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.

searchExactMatchImpressionShare

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.

searchImpressionShare

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.

searchRankLostAbsoluteTopImpressionShare

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.

searchRankLostImpressionShare

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.

searchRankLostTopImpressionShare

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.

searchTopImpressionShare

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.

topImpressionPercentage

number

The percent of your ad impressions that are shown adjacent to the top organic search results.

valuePerAllConversions

number

The value of all conversions divided by the number of all conversions.

valuePerAllConversionsByConversionDate

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 .

valuePerConversion

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.

valuePerConversionsByConversionDate

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.

clientAccountViewThroughConversions

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.

clientAccountCrossSellCostOfGoodsSoldMicros

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

crossSellCostOfGoodsSoldMicros

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

clientAccountCrossSellGrossProfitMicros

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

crossSellGrossProfitMicros

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

clientAccountCrossSellRevenueMicros

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

crossSellRevenueMicros

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

clientAccountCrossSellUnitsSold

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.

crossSellUnitsSold

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.

clientAccountLeadCostOfGoodsSoldMicros

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

leadCostOfGoodsSoldMicros

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

clientAccountLeadGrossProfitMicros

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

leadGrossProfitMicros

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

clientAccountLeadRevenueMicros

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

leadRevenueMicros

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

clientAccountLeadUnitsSold

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.

leadUnitsSold

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 representation
{

  // 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 . A value. value can be only one of the following:
booleanValue

boolean

A boolean.

int64Value

string ( int64 format)

An int64.

floatValue

number

یک شناور

doubleValue

number

A double.

stringValue

string

یک رشته.

QualityScoreBucket

Enum listing the possible quality score buckets.

Enums
UNSPECIFIED Not specified.
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 Not specified.
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 representation
{
  "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,
  "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)
  }
}
زمینه های
adNetworkType

enum ( AdNetworkType )

Ad network type.

conversionActionCategory

enum ( ConversionActionCategory )

Conversion action category.

conversionCustomDimensions[]

object ( Value )

The conversion custom dimensions.

dayOfWeek

enum ( DayOfWeek )

Day of the week, for example, MONDAY.

device

enum ( Device )

Device to which metrics apply.

keyword

object ( Keyword )

Keyword criterion.

productChannel

enum ( ProductChannel )

Channel of the product.

productChannelExclusivity

enum ( ProductChannelExclusivity )

Channel exclusivity of the product.

productCondition

enum ( ProductCondition )

Condition of the product.

productSoldCondition

enum ( ProductCondition )

Condition of the product sold.

rawEventConversionDimensions[]

object ( Value )

The raw event conversion dimensions.

conversionAction

string

Resource name of the conversion action.

conversionActionName

string

Conversion action name.

date

string

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

month

string

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

productBiddingCategoryLevel1

string

Bidding category (level 1) of the product.

productBiddingCategoryLevel2

string

Bidding category (level 2) of the product.

productBiddingCategoryLevel3

string

Bidding category (level 3) of the product.

productBiddingCategoryLevel4

string

Bidding category (level 4) of the product.

productBiddingCategoryLevel5

string

Bidding category (level 5) of the product.

productBrand

string

Brand of the product.

productCountry

string

Resource name of the geo target constant for the country of sale of the product.

productCustomAttribute0

string

Custom attribute 0 of the product.

productCustomAttribute1

string

Custom attribute 1 of the product.

productCustomAttribute2

string

Custom attribute 2 of the product.

productCustomAttribute3

string

Custom attribute 3 of the product.

productCustomAttribute4

string

Custom attribute 4 of the product.

productItemId

string

Item ID of the product.

productLanguage

string

Resource name of the language constant for the language of the product.

productSoldBiddingCategoryLevel1

string

Bidding category (level 1) of the product sold.

productSoldBiddingCategoryLevel2

string

Bidding category (level 2) of the product sold.

productSoldBiddingCategoryLevel3

string

Bidding category (level 3) of the product sold.

productSoldBiddingCategoryLevel4

string

Bidding category (level 4) of the product sold.

productSoldBiddingCategoryLevel5

string

Bidding category (level 5) of the product sold.

productSoldBrand

string

Brand of the product sold.

productSoldCustomAttribute0

string

Custom attribute 0 of the product sold.

productSoldCustomAttribute1

string

Custom attribute 1 of the product sold.

productSoldCustomAttribute2

string

Custom attribute 2 of the product sold.

productSoldCustomAttribute3

string

Custom attribute 3 of the product sold.

productSoldCustomAttribute4

string

Custom attribute 4 of the product sold.

productSoldItemId

string

Item ID of the product sold.

productSoldTitle

string

Title of the product sold.

productSoldTypeL1

string

Type (level 1) of the product sold.

productSoldTypeL2

string

Type (level 2) of the product sold.

productSoldTypeL3

string

Type (level 3) of the product sold.

productSoldTypeL4

string

Type (level 4) of the product sold.

productSoldTypeL5

string

Type (level 5) of the product sold.

productStoreId

string

Store ID of the product.

productTitle

string

Title of the product.

productTypeL1

string

Type (level 1) of the product.

productTypeL2

string

Type (level 2) of the product.

productTypeL3

string

Type (level 3) of the product.

productTypeL4

string

Type (level 4) of the product.

productTypeL5

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.

assetInteractionTarget

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 Not specified.
UNKNOWN The value is unknown in this version.
SEARCH جستجوی گوگل.
SEARCH_PARTNERS Search partners.
CONTENT Display Network.
YOUTUBE_WATCH ویدئوهای یوتیوب
MIXED Cross-network.

کلمه کلیدی

A Keyword criterion segment.

JSON representation
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
زمینه های
info

object ( KeywordInfo )

Keyword info.

adGroupCriterion

string

The AdGroupCriterion resource name.

ProductChannelExclusivity

Enum describing the availability of a product offer.

Enums
UNSPECIFIED Not specified.
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 Not specified.
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 representation
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
زمینه های
asset

string

The asset resource name.

interactionOnThisAsset

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.