SearchAds360Row

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

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

object ( AdGroup )

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

adGroupAd

object ( AdGroupAd )

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

adGroupAdEffectiveLabel

object ( AdGroupAdEffectiveLabel )

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

adGroupAdLabel

object ( AdGroupAdLabel )

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

adGroupAsset

object ( AdGroupAsset )

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

adGroupAssetSet

object ( AdGroupAssetSet )

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

adGroupAudienceView

object ( AdGroupAudienceView )

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

adGroupBidModifier

object ( AdGroupBidModifier )

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

adGroupCriterion

object ( AdGroupCriterion )

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

adGroupCriterionEffectiveLabel

object ( AdGroupCriterionEffectiveLabel )

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

adGroupCriterionLabel

object ( AdGroupCriterionLabel )

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

adGroupEffectiveLabel

object ( AdGroupEffectiveLabel )

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

adGroupLabel

object ( AdGroupLabel )

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

ageRangeView

object ( AgeRangeView )

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

asset

object ( Asset )

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

assetGroupAsset

object ( AssetGroupAsset )

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

assetGroupSignal

object ( AssetGroupSignal )

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

assetGroupListingGroupFilter

object ( AssetGroupListingGroupFilter )

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

assetGroupTopCombinationView

object ( AssetGroupTopCombinationView )

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

assetGroup

object ( AssetGroup )

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

assetSetAsset

object ( AssetSetAsset )

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

assetSet

object ( AssetSet )

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

biddingStrategy

object ( BiddingStrategy )

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

campaignBudget

object ( CampaignBudget )

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

campaign

object ( Campaign )

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

campaignAsset

object ( CampaignAsset )

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

campaignAssetSet

object ( CampaignAssetSet )

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

campaignAudienceView

object ( CampaignAudienceView )

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

campaignCriterion

object ( CampaignCriterion )

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

campaignEffectiveLabel

object ( CampaignEffectiveLabel )

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

campaignLabel

object ( CampaignLabel )

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

cartDataSalesView

object ( CartDataSalesView )

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

audience

object ( Audience )

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

conversionAction

object ( ConversionAction )

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

conversionCustomVariable

object ( ConversionCustomVariable )

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

customer

object ( Customer )

مشتری مورد اشاره در استعلام.

customerAsset

object ( CustomerAsset )

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

customerAssetSet

object ( CustomerAssetSet )

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

accessibleBiddingStrategy

object ( AccessibleBiddingStrategy )

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

customerClient

object ( CustomerClient )

CustomerClient که در کوئری به آن اشاره شده است.

dynamicSearchAdsSearchTermView

object ( DynamicSearchAdsSearchTermView )

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

genderView

object ( GenderView )

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

geoTargetConstant

object ( GeoTargetConstant )

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

keywordView

object ( KeywordView )

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

label

object ( Label )

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

languageConstant

object ( LanguageConstant )

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

locationView

object ( LocationView )

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

productBiddingCategoryConstant

object ( ProductBiddingCategoryConstant )

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

productGroupView

object ( ProductGroupView )

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

shoppingPerformanceView

object ( ShoppingPerformanceView )

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

userList

object ( UserList )

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

userLocationView

object ( UserLocationView )

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

webpageView

object ( WebpageView )

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

visit

object ( Visit )

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

conversion

object ( Conversion )

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

metrics

object ( Metrics )

معیارها.

segments

object ( Segments )

بخش‌ها

customColumns[]

object ( Value )

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

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

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

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

string

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

customers/{customerId}/adGroups/{ad_group_id}

status

enum ( AdGroupStatus )

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

type

enum ( AdGroupType )

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

adRotationMode

enum ( AdGroupAdRotationMode )

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

creationTime

string

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

targetingSetting

object ( TargetingSetting )

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

labels[]

string

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

effectiveLabels[]

string

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

engineId

string

شناسه گروه تبلیغاتی در حساب موتور خارجی. این فیلد فقط برای حساب‌های غیر گوگل ادز است، برای مثال، یاهو ژاپن، مایکروسافت، بایدو و غیره. برای موجودیت گوگل ادز، به جای آن از "adGroup.id" استفاده کنید.

startDate

string

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

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

endDate

string

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

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

languageCode

string

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

lastModifiedTime

string

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

id

string ( int64 format)

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

name

string

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

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

باید شامل کمتر از ۲۵۵ کاراکتر UTF-8 با عرض کامل باشد.

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

trackingUrlTemplate

string

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

cpcBidMicros

string ( int64 format)

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

engineStatus

enum ( AdGroupEngineStatus )

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

finalUrlSuffix

string

الگوی URL برای افزودن پارامترها به URL نهایی.

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

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

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

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

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

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

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

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

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

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

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

SEARCH_STANDARD نوع گروه تبلیغاتی پیش‌فرض برای کمپین‌های جستجو.
DISPLAY_STANDARD نوع گروه تبلیغاتی پیش‌فرض برای کمپین‌های نمایشی.
SHOPPING_PRODUCT_ADS نوع گروه تبلیغاتی برای کمپین‌های خرید که تبلیغات استاندارد محصولات را ارائه می‌دهند.
SHOPPING_SHOWCASE_ADS این نوع برای گروه‌های تبلیغاتی است که محدود به نمایش تبلیغات ویترینی یا تجاری در نتایج خرید هستند.
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 تبلیغات ویدیویی خارجی (Outstream)
SEARCH_DYNAMIC_ADS نوع گروه تبلیغاتی برای گروه‌های تبلیغاتی تبلیغات جستجوی پویا.
SHOPPING_COMPARISON_LISTING_ADS نوع گروه‌های تبلیغاتی در کمپین‌های مقایسه خرید.
PROMOTED_HOTEL_ADS نوع گروه تبلیغاتی برای گروه‌های تبلیغاتی هتل‌های تبلیغاتی.
VIDEO_RESPONSIVE گروه‌های تبلیغاتی واکنش‌گرا با ویدیو
VIDEO_EFFICIENT_REACH گروه‌های تبلیغاتی با دسترسی کارآمد به ویدیو.
SMART_CAMPAIGN_ADS نوع گروه تبلیغاتی برای کمپین‌های هوشمند.
TRAVEL_ADS نوع گروه تبلیغاتی برای کمپین‌های مسافرتی.

حالت چرخش تبلیغات (AdRotationMode)

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

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

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

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

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

وضعیت موتور تبلیغات

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

انوم‌ها
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 هیچ تبلیغی برای این گروه تبلیغاتی در حال اجرا نیست، زیرا حساب کاربری متوقف شده است.

تنظیمات هدف‌گیری

تنظیمات مربوط به ویژگی‌های مرتبط با هدف‌گیری، در سطوح کمپین و گروه تبلیغاتی. برای جزئیات بیشتر در مورد تنظیمات هدف‌گیری، به 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

نشان می‌دهد که آیا تبلیغات خود را فقط برای معیارهایی که برای این TargetDimension انتخاب کرده‌اید، محدود کنید یا همه مقادیر را برای این TargetDimension هدف قرار دهید و تبلیغات را بر اساس هدف‌گذاری شما در TargetingDimensionهای دیگر نشان دهید. مقدار true به این معنی است که این معیارها فقط اصلاح‌کننده‌های قیمت را اعمال می‌کنند و بر هدف‌گذاری تأثیری ندارند. مقدار false به این معنی است که این معیارها علاوه بر اعمال اصلاح‌کننده‌های قیمت، هدف‌گذاری را نیز محدود می‌کنند.

بُعد هدف‌گیری

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

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

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

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

نمایش JSON 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    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 ایجاد شده است. تاریخ و زمان در منطقه زمانی مشتری و با فرمت "yyyy-MM-dd HH:mm:ss.ssssss" است.

labels[]

string

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

effectiveLabels[]

string

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

engineId

string

شناسه تبلیغ در حساب موتور خارجی. این فیلد فقط برای حساب تبلیغات جستجو ۳۶۰ است، برای مثال، یاهو ژاپن، مایکروسافت، بایدو و غیره. برای موجودیت‌های غیر از تبلیغات جستجو ۳۶۰، به جای آن از "adGroupAd.ad.id" استفاده کنید.

engineStatus

enum ( AdGroupAdEngineStatus )

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

lastModifiedTime

string

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

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

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

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

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

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

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

FinalAppUrl

یک URL برای لینک‌دهی عمیق به یک برنامه برای سیستم عامل مورد نظر.

نمایش JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
فیلدها
osType

enum ( AppUrlOperatingSystemType )

سیستم عامل مورد نظر این URL. الزامی.

url

string

آدرس اینترنتی پیوند عمیق برنامه. پیوندهای عمیق، مکانی را در برنامه مشخص می‌کنند که با محتوایی که می‌خواهید نمایش دهید مطابقت دارد و باید به شکل {scheme}://{host_path} باشد. این طرح مشخص می‌کند کدام برنامه باز شود. برای برنامه خود، می‌توانید از یک طرح سفارشی که با نام برنامه شروع می‌شود استفاده کنید. میزبان و مسیر، مکان منحصر به فردی را در برنامه که محتوای شما در آن وجود دارد، مشخص می‌کنند. مثال: "exampleapp://productid_1234". الزامی.

نوع سیستم عامل AppUrl

سیستم عامل

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می‌شود. در این نسخه، مقدار ناشناخته را نشان می‌دهد.
IOS سیستم عامل اپل آی او اس.
ANDROID سیستم عامل اندروید است.

نوع تبلیغ

انواع ممکن یک تبلیغ.

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

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

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

TEXT_AD تبلیغ به صورت متنی است.
EXPANDED_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 تبلیغ چند دارایی دیسکاوری.
TRAVEL_AD آگهی مسافرتی.
DISCOVERY_VIDEO_RESPONSIVE_AD تبلیغ واکنش‌گرای ویدیویی دیسکاوری.
MULTIMEDIA_AD تبلیغ چندرسانه‌ای.

جستجوی تبلیغات۳۶۰متناطلاعات تبلیغات

یک تبلیغ متنی ۳۶۰ درجه برای تبلیغات جستجو.

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

string

تیتر آگهی.

description1

string

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

description2

string

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

displayUrl

string

آدرس اینترنتی (URL) نمایش داده شده برای تبلیغ.

displayMobileUrl

string

آدرس اینترنتی (URL) موبایل نمایش داده شده برای تبلیغ.

adTrackingId

string ( int64 format)

شناسه ردیابی تبلیغ.

جستجوی تبلیغات۳۶۰ متن گسترده اطلاعات تبلیغات

یک تبلیغ متنی گسترش‌یافته ۳۶۰ درجه در Search Ads.

نمایش 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

متن با جداکننده به مسیر ۱ اضافه شده است.

adTrackingId

string ( int64 format)

شناسه ردیابی تبلیغ.

SearchAds360 واکنش‌گرا SearchAdInfo

یک تبلیغ جستجوی واکنش‌گرای ۳۶۰ درجه برای تبلیغات جستجو.

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

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

فهرست منابع متنی برای توضیحات. وقتی تبلیغ نمایش داده می‌شود، توضیحات از این فهرست انتخاب می‌شوند.

path1

string

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

path2

string

متن با جداکننده به مسیر ۱ اضافه شده است.

adTrackingId

string ( int64 format)

شناسه ردیابی تبلیغ.

دارایی متن تبلیغاتی

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

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

string

متن دارایی.

جستجوی تبلیغات۳۶۰محصولاطلاعات تبلیغات

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

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

جستجوی تبلیغات ۳۶۰گسترش‌یافتهجستجوی پویااطلاعات تبلیغات

یک تبلیغ جستجوی پویای توسعه‌یافته.

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

string

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

description2

string

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

adTrackingId

string ( int64 format)

شناسه ردیابی تبلیغ.

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

وضعیت‌های موتور AdGroupAd را فهرست می‌کند.

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

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

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN بایدو: خلاقیت تأیید نشد.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW بایدو: آدرس اینترنتی موبایل در حال بررسی است.
AD_GROUP_AD_PARTIALLY_INVALID بایدو: خلاقیت در دستگاه تلفن همراه نامعتبر است اما در دسکتاپ معتبر است.
AD_GROUP_AD_TO_BE_ACTIVATED بایدو: 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 خلاق در انتظار بررسی است.
AD_GROUP_AD_UNDER_REVIEW خلاق در دست بررسی است.
AD_GROUP_AD_APPROVED خلاق تایید شده است.
AD_GROUP_AD_DISAPPROVED خلاقیت رد شده است.
AD_GROUP_AD_SERVING خلاق، خدمت کردن است.
AD_GROUP_AD_ACCOUNT_PAUSED به دلیل مسدود شدن حساب، بخش خلاقیت متوقف شده است.
AD_GROUP_AD_CAMPAIGN_PAUSED بخش خلاقیت متوقف شده است زیرا کمپین متوقف شده است.
AD_GROUP_AD_AD_GROUP_PAUSED بخش خلاقیت متوقف شده است زیرا گروه تبلیغاتی متوقف شده است.

برچسب موثر تبلیغاتگروه تبلیغاتی

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

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

string

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

adGroupAd

string

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

label

string

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

ownerCustomerId

string ( int64 format)

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

گروه تبلیغاتیبرچسب تبلیغاتی

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

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

string

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

adGroupAd

string

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

label

string

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

ownerCustomerId

string ( int64 format)

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

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

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

نمایش 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 )

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

وضعیت پیوند دارایی

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

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

مجموعه دارایی‌های گروه تبلیغاتی

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 )

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

وضعیت پیوند مجموعه دارایی‌ها

وضعیت‌های ممکن ارتباط بین مجموعه دارایی‌ها و ظرف آن.

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

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

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

نمایش JSON 
{
  "resourceName": string
}
فیلدها
resourceName

string

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

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

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

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

نمایش 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 باشد. محدوده برای PreferredContent 1.0 - 6.0 است. برای انصراف از نوع دستگاه از 0 استفاده کنید.

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

در عملیات ایجاد که از نسخه ۵ شروع می‌شوند، الزامی است. criterion می‌تواند فقط یکی از موارد زیر باشد:

device

object ( DeviceInfo )

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

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

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

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

enum ( Device )

نوع دستگاه.

دستگاه

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

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

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

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

نمایش JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "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

معیار زمان ایجاد این گروه تبلیغاتی. این زمان بر اساس منطقه زمانی مشتری و با فرمت "yyyy-MM-dd HH:mm:ss" است.

status

enum ( AdGroupCriterionStatus )

وضعیت معیار.

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

qualityInfo

object ( QualityInfo )

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

type

enum ( CriterionType )

نوع معیار.

labels[]

string

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

effectiveLabels[]

string

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

positionEstimates

object ( PositionEstimates )

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

finalUrls[]

string

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

finalMobileUrls[]

string

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

urlCustomParameters[]

object ( CustomParameter )

فهرست نگاشت‌های مورد استفاده برای جایگزینی تگ‌های پارامتر سفارشی در trackingUrlTemplate ، finalUrls یا mobile_final_urls .

engineId

string

شناسه معیار گروه تبلیغاتی در حساب موتور خارجی. این فیلد فقط برای حساب‌های غیر گوگل ادز است، برای مثال، یاهو ژاپن، مایکروسافت، بایدو و غیره. برای موجودیت گوگل ادز، به جای آن از "adGroupCriterion.criterion_id" استفاده کنید.

lastModifiedTime

string

تاریخ و زمان آخرین باری که معیار این گروه تبلیغاتی تغییر کرده است. تاریخ و زمان بر اساس منطقه زمانی مشتری و با فرمت "yyyy-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 )

مکان.

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

وضعیت‌های ممکن برای یک معیار گروه تبلیغاتی (AdGroupCriterion).

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

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

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

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

اطلاعات کیفیت

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

نمایش JSON 
{
  "qualityScore": integer
}
فیلدها
qualityScore

integer

امتیاز کیفیت.

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

نوع معیار

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

انوم‌ها
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 آی‌پی‌بلاک
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) مورد نیاز برای نمایش تبلیغ در بالای صفحه اول نتایج جستجو.

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

وضعیت‌های موتور AdGroupCriterion را فهرست می‌کند.

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

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

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN بایدو: قیمت پیشنهادی یا کیفیت برای نمایش خیلی پایین است.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME بایدو: به دلیل حجم جستجوی پایین توسط بایدو متوقف شد.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW بایدو: آدرس اینترنتی موبایل در حال بررسی است.
AD_GROUP_CRITERION_PARTIALLY_INVALID بایدو: صفحه فرود برای یک دستگاه نامعتبر است، در حالی که صفحه فرود برای دستگاه دیگر معتبر است.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: کلمه کلیدی توسط مدیریت حساب 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 از زمان توقف حساب، معیار متوقف شده است.

پارامتر سفارشی

نگاشتی که می‌تواند توسط تگ‌های پارامتر سفارشی در trackingUrlTemplate ، finalUrls یا mobile_final_urls استفاده شود.

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

string

کلیدی که با نام تگ پارامتر مطابقت دارد.

value

string

مقداری که قرار است جایگزین شود.

اطلاعات کلمات کلیدی

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

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

enum ( KeywordMatchType )

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

text

string

متن کلمه کلیدی (حداکثر ۸۰ کاراکتر و ۱۰ کلمه).

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

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

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

اطلاعات گروه آگهی

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

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

enum ( ListingGroupType )

نوع گروه فهرست‌بندی.

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

نوع گروه فهرست‌بندی شده.

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

اطلاعات محدوده سنی

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

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

enum ( AgeRangeType )

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

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

نوع محدوده سنی جمعیت‌شناختی (برای مثال، بین ۱۸ تا ۲۴ سال).

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می‌شود. در این نسخه، مقدار ناشناخته را نشان می‌دهد.
AGE_RANGE_18_24 بین ۱۸ تا ۲۴ سال سن.
AGE_RANGE_25_34 بین ۲۵ تا ۳۴ سال سن داشته باشد.
AGE_RANGE_35_44 بین ۳۵ تا ۴۴ سال سن داشته باشد.
AGE_RANGE_45_54 بین ۴۵ تا ۵۴ سال سن دارند.
AGE_RANGE_55_64 بین ۵۵ تا ۶۴ سال سن دارند.
AGE_RANGE_65_UP ۶۵ سال به بالا.
AGE_RANGE_UNDETERMINED محدوده سنی نامشخص.

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

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

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

enum ( GenderType )

نوع جنسیت.

نوع جنسیت

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

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

اطلاعات لیست کاربران

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

نمایش JSON 
{
  "userList": string
}
فیلدها
userList

string

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

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

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

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

object ( WebpageConditionInfo )

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

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

coveragePercentage

number

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

criterionName

string

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

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

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

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

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

enum ( WebpageConditionOperand )

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

operator

enum ( WebpageConditionOperator )

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

argument

string

آرگومان شرط هدف‌گیری صفحه وب.

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

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

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
URL Operand denoting a webpage URL targeting condition.
CATEGORY Operand denoting a webpage category targeting condition.
PAGE_TITLE Operand denoting a webpage title targeting condition.
PAGE_CONTENT Operand denoting a webpage content targeting condition.
CUSTOM_LABEL Operand denoting a webpage custom label targeting condition.

WebpageConditionOperator

The webpage condition operator in webpage criterion.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
EQUALS The argument web condition is equal to the compared web condition.
CONTAINS The argument web condition is part of the compared web condition.

LocationInfo

A location criterion.

JSON representation 
{
  "geoTargetConstant": string
}
فیلدها
geoTargetConstant

string

The geo target constant resource name.

AdGroupCriterionEffectiveLabel

A relationship between an ad group criterion and an effective label. An effective label is a label inherited or directly assigned to this ad group criterion.

JSON representation 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resourceName

string

The resource name of the ad group criterion effective label. Ad group criterion effective label resource names have the form: customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

The ad group criterion to which the effective label is attached.

label

string

The effective label assigned to the ad group criterion.

ownerCustomerId

string ( int64 format)

The ID of the Customer which owns the effective label.

AdGroupCriterionLabel

A relationship between an ad group criterion and a label.

JSON representation 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resourceName

string

The resource name of the ad group criterion label. Ad group criterion label resource names have the form: customers/{ownerCustomerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

The ad group criterion to which the label is attached.

label

string

The label assigned to the ad group criterion.

ownerCustomerId

string ( int64 format)

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

AdGroupEffectiveLabel

A relationship between an ad group and an effective label. An effective label is a label inherited or directly assigned to this ad group.

JSON representation 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resourceName

string

The resource name of the ad group effective label. Ad group effective label resource names have the form: customers/{ownerCustomerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

adGroup

string

The ad group to which the effective label is attached.

label

string

The effective label assigned to the ad group.

ownerCustomerId

string ( int64 format)

The ID of the Customer which owns the effective label.

AdGroupLabel

A relationship between an ad group and a label.

JSON representation 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resourceName

string

The resource name of the ad group label. Ad group label resource names have the form: customers/{ownerCustomerId}/adGroupLabels/{ad_group_id}~{label_id}

adGroup

string

The ad group to which the label is attached.

label

string

The label assigned to the ad group.

ownerCustomerId

string ( int64 format)

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

AgeRangeView

An age range view.

JSON representation 
{
  "resourceName": string
}
فیلدها
resourceName

string

The resource name of the age range view. Age range view resource names have the form:

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

دارایی

Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it.

JSON representation 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": 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

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

customers/{customerId}/assets/{assetId}

type

enum ( AssetType )

Type of the asset.

finalUrls[]

string

A list of possible final URLs after all cross domain redirects.

finalMobileUrls[]

string

A list of possible final mobile URLs after all cross domain redirects.

urlCustomParameters[]

object ( CustomParameter )

A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls.

status

enum ( AssetStatus )

The status of the asset.

creationTime

string

The timestamp when this asset 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 asset 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 asset.

name

string

Optional name of the asset.

trackingUrlTemplate

string

URL template for constructing a tracking URL.

finalUrlSuffix

string

URL template for appending params to landing page URLs served with parallel tracking.

engineStatus

enum ( AssetEngineStatus )

The Engine Status for an asset.

Union field asset_data . The specific type of the asset. asset_data can be only one of the following:
youtubeVideoAsset

object ( YoutubeVideoAsset )

A YouTube video asset.

imageAsset

object ( ImageAsset )

An image asset.

textAsset

object ( TextAsset )

A text asset.

calloutAsset

object ( UnifiedCalloutAsset )

A unified callout asset.

pageFeedAsset

object ( UnifiedPageFeedAsset )

A unified page feed asset.

mobileAppAsset

object ( MobileAppAsset )

A mobile app asset.

callAsset

object ( UnifiedCallAsset )

A unified call asset.

callToActionAsset

object ( CallToActionAsset )

A call to action asset.

locationAsset

object ( UnifiedLocationAsset )

A unified location asset.

AssetType

Enum describing possible types of asset.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
YOUTUBE_VIDEO YouTube video asset.
MEDIA_BUNDLE Media bundle asset.
IMAGE Image asset.
TEXT Text asset.
LEAD_FORM Lead form asset.
BOOK_ON_GOOGLE Book on Google asset.
PROMOTION Promotion asset.
CALLOUT Callout asset.
STRUCTURED_SNIPPET Structured Snippet asset.
PAGE_FEED Page Feed asset.
DYNAMIC_EDUCATION Dynamic Education asset.
MOBILE_APP Mobile app asset.
HOTEL_CALLOUT Hotel callout asset.
CALL Call asset.
PRICE Price asset.
CALL_TO_ACTION Call to action asset.
DYNAMIC_REAL_ESTATE Dynamic real estate asset.
DYNAMIC_CUSTOM Dynamic custom asset.
DYNAMIC_HOTELS_AND_RENTALS Dynamic hotels and rentals asset.
DYNAMIC_FLIGHTS Dynamic flights asset.
DYNAMIC_TRAVEL Dynamic travel asset.
DYNAMIC_LOCAL Dynamic local asset.
DYNAMIC_JOBS Dynamic jobs asset.
LOCATION Location asset.
HOTEL_PROPERTY Hotel property asset.

AssetStatus

The possible statuses of an asset.

انوم‌ها
UNSPECIFIED The status has not been specified.
UNKNOWN The received value is not known in this version. This is a response-only value.
ENABLED The asset is enabled.
REMOVED The asset is removed.
ARCHIVED The asset is archived.
PENDING_SYSTEM_GENERATED The asset is system generated pending user review.

AssetEngineStatus

Enum describing possible Asset engine statuses.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
SERVING The asset is active.
SERVING_LIMITED The asset is active limited.
DISAPPROVED The asset is disapproved (not eligible).
DISABLED The asset is inactive (pending).
REMOVED The asset has been removed.

YoutubeVideoAsset

A YouTube asset.

JSON representation 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
فیلدها
youtubeVideoTitle

string

YouTube video title.

youtubeVideoId

string

YouTube video id. This is the 11 character string value used in the YouTube video URL.

ImageAsset

An Image asset.

JSON representation 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
فیلدها
mimeType

enum ( MimeType )

MIME type of the image asset.

fullSize

object ( ImageDimension )

Metadata for this image at its original size.

fileSize

string ( int64 format)

File size of the image asset in bytes.

MimeType

The mime type

انوم‌ها
UNSPECIFIED The mime type has not been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

IMAGE_JPEG MIME type of image/jpeg.
IMAGE_GIF MIME type of image/gif.
IMAGE_PNG MIME type of image/png.
FLASH MIME type of application/x-shockwave-flash.
TEXT_HTML MIME type of text/html.
PDF MIME type of application/pdf.
MSWORD MIME type of application/msword.
MSEXCEL MIME type of application/vnd.ms-excel.
RTF MIME type of application/rtf.
AUDIO_WAV MIME type of audio/wav.
AUDIO_MP3 MIME type of audio/mp3.
HTML5_AD_ZIP MIME type of application/x-html5-ad-zip.

ImageDimension

Metadata for an image at a certain size, either original or resized.

JSON representation 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
فیلدها
heightPixels

string ( int64 format)

Height of the image.

widthPixels

string ( int64 format)

Width of the image.

url

string

A URL that returns the image with this height and width.

TextAsset

A Text asset.

JSON representation 
{
  "text": string
}
فیلدها
text

string

Text content of the text asset.

UnifiedCalloutAsset

A unified callout asset.

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

string

The callout text. The length of this string should be between 1 and 25, inclusive.

startDate

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

endDate

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

adScheduleTargets[]

object ( AdScheduleInfo )

List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.

useSearcherTimeZone

boolean

Whether to show the asset in search user's time zone. Applies to Microsoft Ads.

AdScheduleInfo

Represents an AdSchedule criterion.

AdSchedule is specified as the day of the week and a time interval within which ads will be shown.

No more than six AdSchedules can be added for the same day.

JSON representation 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
فیلدها
startMinute

enum ( MinuteOfHour )

Minutes after the start hour at which this schedule starts.

This field is required for CREATE operations and is prohibited on UPDATE operations.

endMinute

enum ( MinuteOfHour )

Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute.

This field is required for CREATE operations and is prohibited on UPDATE operations.

dayOfWeek

enum ( DayOfWeek )

Day of the week the schedule applies to.

This field is required for CREATE operations and is prohibited on UPDATE operations.

startHour

integer

Starting hour in 24 hour time. This field must be between 0 and 23, inclusive.

This field is required for CREATE operations and is prohibited on UPDATE operations.

endHour

integer

Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive.

This field is required for CREATE operations and is prohibited on UPDATE operations.

MinuteOfHour

Enumerates of quarter-hours. For example, "FIFTEEN"

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN The value is unknown in this version.
ZERO Zero minutes past the hour.
FIFTEEN Fifteen minutes past the hour.
THIRTY Thirty minutes past the hour.
FORTY_FIVE Forty-five minutes past the hour.

DayOfWeek

Enumerates days of the week, for example, "Monday".

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN The value is unknown in this version.
MONDAY دوشنبه.
TUESDAY سه‌شنبه
WEDNESDAY چهارشنبه.
THURSDAY پنجشنبه.
FRIDAY جمعه.
SATURDAY شنبه.
SUNDAY یکشنبه.

UnifiedSitelinkAsset

A unified sitelink asset.

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

string

URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.

description1

string

First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.

description2

string

Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.

startDate

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

endDate

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

adScheduleTargets[]

object ( AdScheduleInfo )

List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.

trackingId

string ( int64 format)

ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.

useSearcherTimeZone

boolean

Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.

mobilePreferred

boolean

Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads.

UnifiedPageFeedAsset

A Unified Page Feed asset.

JSON representation 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
فیلدها
pageUrl

string

The webpage that advertisers want to target.

labels[]

string

Labels used to group the page urls.

MobileAppAsset

An asset representing a mobile app.

JSON representation 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
فیلدها
appId

string

Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.

appStore

enum ( MobileAppVendor )

Required. The application store that distributes this specific app.

MobileAppVendor

The type of mobile app vendor

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
APPLE_APP_STORE Mobile app vendor for Apple app store.
GOOGLE_APP_STORE Mobile app vendor for Google app store.

UnifiedCallAsset

A unified call asset.

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

string

Two-letter country code of the phone number. Examples: 'US', 'us'.

phoneNumber

string

The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'

callConversionReportingState

enum ( CallConversionReportingState )

Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.

callConversionAction

string

The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if callConversionReportingState is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object ( AdScheduleInfo )

List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.

callOnly

boolean

Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.

callTrackingEnabled

boolean

Whether the call should be enabled on call tracking. Applies to Microsoft Ads.

useSearcherTimeZone

boolean

Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.

startDate

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

endDate

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

CallConversionReportingState

Possible data types for a call conversion action state.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
DISABLED Call conversion action is disabled.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Call conversion action will use call conversion type set at the account level.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Call conversion action will use call conversion type set at the resource (call only ads/call extensions) level.

CallToActionAsset

A call to action asset.

JSON representation 
{
  "callToAction": enum (CallToActionType)
}
فیلدها
callToAction

enum ( CallToActionType )

Call to action.

CallToActionType

Enum describing possible types of call to action.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEARN_MORE The call to action type is learn more.
GET_QUOTE The call to action type is get quote.
APPLY_NOW The call to action type is apply now.
SIGN_UP The call to action type is sign up.
CONTACT_US The call to action type is contact us.
SUBSCRIBE The call to action type is subscribe.
DOWNLOAD The call to action type is download.
BOOK_NOW The call to action type is book now.
SHOP_NOW The call to action type is shop now.
BUY_NOW The call to action type is buy now.
DONATE_NOW The call to action type is donate now.
ORDER_NOW The call to action type is order now.
PLAY_NOW The call to action type is play now.
SEE_MORE The call to action type is see more.
START_NOW The call to action type is start now.
VISIT_SITE The call to action type is visit site.
WATCH_NOW The call to action type is watch now.

UnifiedLocationAsset

A unified location asset.

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

string

Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.

businessProfileLocations[]

object ( BusinessProfileLocation )

The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.

locationOwnershipType

enum ( LocationOwnershipType )

The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.

BusinessProfileLocation

Business Profile location data synced from the linked Business Profile account.

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

string

Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.

storeCode

string

Business Profile store code of this location. This is synced from the Business Profile account.

listingId

string ( int64 format)

Listing ID of this Business Profile location. This is synced from the linked Business Profile account.

LocationOwnershipType

Possible types of a location ownership.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
BUSINESS_OWNER Business Owner of location(legacy location extension - LE).
AFFILIATE Affiliate location(Third party location extension - ALE).

AssetGroupAsset

AssetGroupAsset is the link between an asset and an asset group. Adding an AssetGroupAsset links an asset with an asset group.

JSON representation 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
فیلدها
resourceName

string

The resource name of the asset group asset. Asset group asset resource name have the form:

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

assetGroup

string

The asset group which this asset group asset is linking.

asset

string

The asset which this asset group asset is linking.

fieldType

enum ( AssetFieldType )

The description of the placement of the asset within the asset group. For example: HEADLINE, YOUTUBE_VIDEO etc

status

enum ( AssetLinkStatus )

The status of the link between an asset and asset group.

AssetFieldType

Enum describing the possible placements of an asset.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
HEADLINE The asset is linked for use as a headline.
DESCRIPTION The asset is linked for use as a description.
MANDATORY_AD_TEXT The asset is linked for use as mandatory ad text.
MARKETING_IMAGE The asset is linked for use as a marketing image.
MEDIA_BUNDLE The asset is linked for use as a media bundle.
YOUTUBE_VIDEO The asset is linked for use as a YouTube video.
BOOK_ON_GOOGLE The asset is linked to indicate that a hotels campaign is "Book on Google" enabled.
LEAD_FORM The asset is linked for use as a Lead Form extension.
PROMOTION The asset is linked for use as a Promotion extension.
CALLOUT The asset is linked for use as a Callout extension.
STRUCTURED_SNIPPET The asset is linked for use as a Structured Snippet extension.
MOBILE_APP The asset is linked for use as a Mobile App extension.
HOTEL_CALLOUT The asset is linked for use as a Hotel Callout extension.
CALL The asset is linked for use as a Call extension.
PRICE The asset is linked for use as a Price extension.
LONG_HEADLINE The asset is linked for use as a long headline.
BUSINESS_NAME The asset is linked for use as a business name.
SQUARE_MARKETING_IMAGE The asset is linked for use as a square marketing image.
PORTRAIT_MARKETING_IMAGE The asset is linked for use as a portrait marketing image.
VIDEO The asset is linked for use as a non YouTube logo.
CALL_TO_ACTION_SELECTION The asset is linked for use to select a call-to-action.
AD_IMAGE The asset is linked for use to select an ad image.
HOTEL_PROPERTY The asset is linked for use as a hotel property in a Performance Max for travel goals campaign.
LONG_DESCRIPTION The asset is linked for use as a long description.
CALL_TO_ACTION The asset is linked for use as a call-to-action.

AssetGroupSignal

AssetGroupSignal represents a signal in an asset group. The existence of a signal tells the performance max campaign who's most likely to convert. Performance Max uses the signal to look for new people with similar or stronger intent to find conversions across Search, Display, Video, and more.

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

The resource name of the asset group signal. Asset group signal resource name have the form:

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

assetGroup

string

The asset group which this asset group signal belongs to.

Union field signal . The signal of the asset group. signal can be only one of the following:
audience

object ( AudienceInfo )

The audience signal to be used by the performance max campaign.

AudienceInfo

An audience criterion.

JSON representation 
{
  "audience": string
}
فیلدها
audience

string

The Audience resource name.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter represents a listing group filter tree node in an asset group.

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

string

The resource name of the asset group listing group filter. Asset group listing group filter resource name have the form:

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

assetGroup

string

The asset group which this asset group listing group filter is part of.

id

string ( int64 format)

The ID of the ListingGroupFilter.

type

enum ( ListingGroupFilterType )

Type of a listing group filter node.

vertical

enum ( ListingGroupFilterVertical )

The vertical the current node tree represents. All nodes in the same tree must belong to the same vertical.

caseValue

object ( ListingGroupFilterDimension )

Dimension value with which this listing group is refining its parent. Undefined for the root group.

parentListingGroupFilter

string

Resource name of the parent listing group subdivision. Null for the root listing group filter node.

path

object ( ListingGroupFilterDimensionPath )

The path of dimensions defining this listing group filter.

ListingGroupFilterType

The type of the listing group filter.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
SUBDIVISION Subdivision of products along some listing dimensions.
UNIT_INCLUDED An included listing group filter leaf node.
UNIT_EXCLUDED An excluded listing group filter leaf node.

ListingGroupFilterVertical

The type of the listing group filter vertical.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
SHOPPING Represents the shopping vertical. The vertical is allowed only in Performance Max for Retail campaigns.

ListingGroupFilterDimension

Listing dimensions for the asset group listing group filter.

JSON representation 
{

  // 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.
}
فیلدها
Union field dimension . Dimension of one of the types below is always present. dimension can be only one of the following:
productBiddingCategory

object ( ProductBiddingCategory )

Bidding category of a product offer.

productBrand

object ( ProductBrand )

Brand of a product offer.

productChannel

object ( ProductChannel )

Locality of a product offer.

productCondition

object ( ProductCondition )

Condition of a product offer.

productCustomAttribute

object ( ProductCustomAttribute )

Custom attribute of a product offer.

productItemId

object ( ProductItemId )

Item id of a product offer.

productType

object ( ProductType )

Type of a product offer.

ProductBiddingCategory

One element of a bidding category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level).

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

enum ( ListingGroupFilterBiddingCategoryLevel )

Indicates the level of the category in the taxonomy.

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

ListingGroupFilterBiddingCategoryLevel

The level of the listing group filter bidding category.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEVEL1 Level 1.
LEVEL2 Level 2.
LEVEL3 سطح ۳.
LEVEL4 Level 4.
LEVEL5 سطح ۵.

ProductBrand

Brand of the product.

JSON representation 
{
  "value": string
}
فیلدها
value

string

String value of the product brand.

ProductChannel

Locality of a product offer.

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

enum ( ListingGroupFilterProductChannel )

Value of the locality.

ListingGroupFilterProductChannel

Enum describing the locality of a product offer.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ONLINE The item is sold online.
LOCAL The item is sold in local stores.

ProductCondition

Condition of a product offer.

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

enum ( ListingGroupFilterProductCondition )

Value of the condition.

ListingGroupFilterProductCondition

Enum describing the condition of a product offer.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
NEW The product condition is new.
REFURBISHED The product condition is refurbished.
USED The product condition is used.

ProductCustomAttribute

Custom attribute of a product offer.

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

enum ( ListingGroupFilterCustomAttributeIndex )

Indicates the index of the custom attribute.

value

string

String value of the product custom attribute.

ListingGroupFilterCustomAttributeIndex

The index of customer attributes.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
INDEX0 First listing group filter custom attribute.
INDEX1 Second listing group filter custom attribute.
INDEX2 Third listing group filter custom attribute.
INDEX3 Fourth listing group filter custom attribute.
INDEX4 Fifth listing group filter custom attribute.

ProductItemId

Item id of a product offer.

JSON representation 
{
  "value": string
}
فیلدها
value

string

Value of the id.

ProductType

Type of a product offer.

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

enum ( ListingGroupFilterProductTypeLevel )

Level of the type.

value

string

Value of the type.

ListingGroupFilterProductTypeLevel

Enum describing the level of the type of a product offer.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEVEL1 Level 1.
LEVEL2 Level 2.
LEVEL3 سطح ۳.
LEVEL4 Level 4.
LEVEL5 سطح ۵.

ListingGroupFilterDimensionPath

The path defining of dimensions defining a listing group filter.

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

object ( ListingGroupFilterDimension )

The complete path of dimensions through the listing group filter hierarchy (excluding the root node) to this listing group filter.

AssetGroupTopCombinationView

A view on the usage of asset group asset top combinations.

JSON representation 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
فیلدها
resourceName

string

The resource name of the asset group top combination view. AssetGroup Top Combination view resource names have the form: `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object ( AssetGroupAssetCombinationData )

The top combinations of assets that served together.

AssetGroupAssetCombinationData

Asset group asset combination data

JSON representation 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
فیلدها
assetCombinationServedAssets[]

object ( AssetUsage )

Served assets.

AssetUsage

Contains the usage information of the asset.

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

string

Resource name of the asset.

servedAssetFieldType

enum ( ServedAssetFieldType )

The served field type of the asset.

ServedAssetFieldType

The possible asset field types.

انوم‌ها
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

HEADLINE_1 The asset is used in headline 1.
HEADLINE_2 The asset is used in headline 2.
HEADLINE_3 The asset is used in headline 3.
DESCRIPTION_1 The asset is used in description 1.
DESCRIPTION_2 The asset is used in description 2.
HEADLINE The asset was used in a headline. Use this only if there is only one headline in the ad. Otherwise, use the HEADLINE_1, HEADLINE_2 or HEADLINE_3 enums
HEADLINE_IN_PORTRAIT The asset was used as a headline in portrait image.
LONG_HEADLINE The asset was used in a long headline (used in MultiAssetResponsiveAd).
DESCRIPTION The asset was used in a description. Use this only if there is only one description in the ad. Otherwise, use the DESCRIPTION_1 or DESCRIPTION_@ enums
DESCRIPTION_IN_PORTRAIT The asset was used as description in portrait image.
BUSINESS_NAME_IN_PORTRAIT The asset was used as business name in portrait image.
BUSINESS_NAME The asset was used as business name.
MARKETING_IMAGE The asset was used as a marketing image.
MARKETING_IMAGE_IN_PORTRAIT The asset was used as a marketing image in portrait image.
SQUARE_MARKETING_IMAGE The asset was used as a square marketing image.
PORTRAIT_MARKETING_IMAGE The asset was used as a portrait marketing image.
CALL_TO_ACTION The asset was used as a call-to-action.
YOU_TUBE_VIDEO The asset was used as a YouTube video.
CALL This asset is used as a call.
MOBILE_APP This asset is used as a mobile app.
CALLOUT This asset is used as a callout.
STRUCTURED_SNIPPET This asset is used as a structured snippet.
PRICE This asset is used as a price.
PROMOTION This asset is used as a promotion.
AD_IMAGE This asset is used as an image.
LEAD_FORM The asset is used as a lead form.
DESCRIPTION_PREFIX The asset is used as a description prefix.

AssetGroup

An asset group. AssetGroupAsset is used to link an asset to the asset group. AssetGroupSignal is used to associate a signal to an asset group.

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

string

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

customers/{customerId}/assetGroups/{asset_group_id}

id

string ( int64 format)

The ID of the asset group.

campaign

string

The campaign with which this asset group is associated. The asset which is linked to the asset group.

name

string

Required. Name of the asset group. Required. It must have a minimum length of 1 and maximum length of 128. It must be unique under a campaign.

finalUrls[]

string

A list of final URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.

finalMobileUrls[]

string

A list of final mobile URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.

status

enum ( AssetGroupStatus )

The status of the asset group.

path1

string

First part of text that may appear appended to the url displayed in the ad.

path2

string

Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set.

adStrength

enum ( AdStrength )

Overall ad strength of this asset group.

AssetGroupStatus

The possible statuses of an asset group.

انوم‌ها
UNSPECIFIED The status has not been specified.
UNKNOWN The received value is not known in this version.
ENABLED The asset group is enabled.
PAUSED The asset group is paused.
REMOVED The asset group is removed.

AdStrength

Enum listing the possible ad strengths.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
PENDING The ad strength is currently pending.
NO_ADS No ads could be generated.
POOR Poor strength.
AVERAGE Average strength.
GOOD Good strength.
EXCELLENT Excellent strength.

AssetSetAsset

AssetSetAsset is the link between an asset and an asset set. Adding an AssetSetAsset links an asset with an asset set.

JSON representation 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
فیلدها
resourceName

string

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

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

assetSet

string

The asset set which this asset set asset is linking to.

asset

string

The asset which this asset set asset is linking to.

status

enum ( AssetSetAssetStatus )

The status of the asset set asset. Read-only.

AssetSetAssetStatus

The possible statuses of an asset set asset.

انوم‌ها
UNSPECIFIED The status has not been specified.
UNKNOWN The received value is not known in this version. This is a response-only value.
ENABLED The asset set asset is enabled.
REMOVED The asset set asset is removed.

AssetSet

An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set.

JSON representation 
{
  "id": string,
  "resourceName": string
}
فیلدها
id

string ( int64 format)

The ID of the asset set.

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

A bidding strategy.

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

The resource name of the bidding strategy. Bidding strategy resource names have the form:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum ( BiddingStrategyStatus )

The status of the bidding strategy.

This field is read-only.

type

enum ( BiddingStrategyType )

The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme.

This field is read-only.

currencyCode

string

The currency used by the bidding strategy (ISO 4217 three-letter code).

For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effectiveCurrencyCode field returns the currency used by the strategy.

id

string ( int64 format)

The ID of the bidding strategy.

name

string

The name of the bidding strategy. All bidding strategies within an account must be named distinctly.

The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).

effectiveCurrencyCode

string

The currency used by the bidding strategy (ISO 4217 three-letter code).

For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currencyCode.

Bidding strategy metrics are reported in this currency.

This field is read-only.

campaignCount

string ( int64 format)

The number of campaigns attached to this bidding strategy.

This field is read-only.

nonRemovedCampaignCount

string ( int64 format)

The number of non-removed campaigns attached to this bidding strategy.

This field is read-only.

Union field scheme . The bidding scheme.

Only one can be set. scheme can be only one of the following:

enhancedCpc

object ( EnhancedCpc )

A bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.

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.

targetOutrankShare

object ( TargetOutrankShare )

A bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This field is deprecated. Creating a new bidding strategy with this field or attaching bidding strategies with this field to a campaign will fail. Mutates to strategies that already have this scheme populated are allowed.

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.

BiddingStrategyStatus

The possible statuses of a BiddingStrategy.

انوم‌ها
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

ENABLED The bidding strategy is enabled.
REMOVED The bidding strategy is removed.

BiddingStrategyType

Enum describing possible bidding strategy types.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
COMMISSION Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value.
ENHANCED_CPC Enhanced CPC is a bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
INVALID Used for return value only. Indicates that a campaign does not have a bidding strategy. This prevents the campaign from serving. For example, a campaign may be attached to a manager bidding strategy and the serving account is subsequently unlinked from the manager account. In this case the campaign will automatically be detached from the now inaccessible manager bidding strategy and transition to the INVALID bidding strategy type.
MANUAL_CPA Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action.
MANUAL_CPC Manual click based bidding where user pays per click.
MANUAL_CPM Manual impression based bidding where user pays per thousand impressions.
MANUAL_CPV A bidding strategy that pays a configurable amount per video view.
MAXIMIZE_CONVERSIONS A bidding strategy that automatically maximizes number of conversions given a daily budget.
MAXIMIZE_CONVERSION_VALUE An automated bidding strategy that automatically sets bids to maximize revenue while spending your budget.
PAGE_ONE_PROMOTED Page-One Promoted bidding scheme, which sets max cpc bids to target impressions on page one or page one promoted slots on google.com. This enum value is deprecated.
PERCENT_CPC Percent Cpc is bidding strategy where bids are a fraction of the advertised price for some good or service.
TARGET_CPA Target CPA is an automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
TARGET_CPM Target CPM is an automated bid strategy that sets bids to help get as many impressions as possible at the target cost per one thousand impressions (CPM) you set.
TARGET_IMPRESSION_SHARE 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).
TARGET_OUTRANK_SHARE Target Outrank Share is an automated bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This enum value is deprecated.
TARGET_ROAS Target ROAS is an automated bidding strategy that helps you maximize revenue while averaging a specific target Return On Average Spend (ROAS).
TARGET_SPEND Target Spend is an automated bid strategy that sets your bids to help get as many clicks as possible within your budget.

EnhancedCpc

This type has no fields.

An automated bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.

This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhancedCpcEnabled set to true for equivalent functionality.

MaximizeConversionValue

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

JSON representation 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
فیلدها
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. Mutable for portfolio bidding strategies only.

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. Mutable for portfolio bidding strategies only.

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 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
فیلدها
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. Mutable for portfolio bidding strategies only.

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. Mutable for portfolio bidding strategies only.

targetCpaMicros

string ( int64 format)

The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. 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 
{
  "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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
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

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

Deprecated: 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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
DAILY Daily budget.
FIXED_DAILY Fixed daily budget.
CUSTOM_PERIOD Custom budget can be used with total_amount to specify lifetime budget limit.

کمپین

A campaign.

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)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "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.

effectiveLabels[]

string

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

labels[]

string

The resource names of labels attached to this campaign.

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.

feedTypes[]

enum ( AssetSetType )

Types of feeds that are attached directly to this campaign.

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 resource name of the campaign 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

The resource name of the portfolio bidding strategy used by the 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.

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

CampaignServingStatus

Possible serving statuses of a campaign.

انوم‌ها
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 Pending.
SUSPENDED Suspended.

BiddingStrategySystemStatus

The possible system statuses of a BiddingStrategy.

انوم‌ها
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.

انوم‌ها
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.

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

AdvertisingChannelSubType

Enum describing the different channel subtypes.

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

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.

NetworkSettings

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

Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".

languageCode

string

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

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

NegativeGeoTargetType

The possible negative geo target types.

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

FrequencyCapEntry

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 resource names for conversion actions for optimizing this campaign.

OptimizationGoalSetting

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

JSON representation 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
فیلدها
optimizationGoalTypes[]

enum ( OptimizationGoalType )

The list of optimization goal types.

OptimizationGoalType

The type of optimization goal

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

TrackingSetting

Campaign-level settings for tracking information.

JSON representation 
{
  "trackingUrl": string
}
فیلدها
trackingUrl

string

The url used for dynamic tracking.

AssetSetType

Possible types of an asset set.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
PAGE_FEED Page asset set.
DYNAMIC_EDUCATION Dynamic education asset set.
MERCHANT_CENTER_FEED Google Merchant Center asset set.
DYNAMIC_REAL_ESTATE Dynamic real estate asset set.
DYNAMIC_CUSTOM Dynamic custom asset set.
DYNAMIC_HOTELS_AND_RENTALS Dynamic hotels and rentals asset set.
DYNAMIC_FLIGHTS Dynamic flights asset set.
DYNAMIC_TRAVEL Dynamic travel asset set.
DYNAMIC_LOCAL Dynamic local asset set.
DYNAMIC_JOBS Dynamic jobs asset set.
LOCATION_SYNC Location sync level asset set.
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP Business Profile location group asset set.
CHAIN_DYNAMIC_LOCATION_GROUP Chain location group asset set which can be used for both owned locations and affiliate locations.
STATIC_LOCATION_GROUP Static location group asset set which can be used for both owned locations and affiliate locations.
HOTEL_PROPERTY Hotel Property asset set which is used to link a hotel property feed to Performance Max for travel goals campaigns.
TRAVEL_FEED Travel Feed asset set type. Can represent either a Hotel feed or a Things to Do (activities) feed.

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. Read-only.

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 )

Keyword.

location

object ( LocationInfo )

Location.

device

object ( DeviceInfo )

Device.

ageRange

object ( AgeRangeInfo )

Age range.

gender

object ( GenderInfo )

Gender.

userList

object ( UserListInfo )

User List.

language

object ( LanguageInfo )

زبان.

webpage

object ( WebpageInfo )

Webpage.

locationGroup

object ( LocationGroupInfo )

Location Group

CampaignCriterionStatus

The possible statuses of a CampaignCriterion.

انوم‌ها
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)

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

CampaignEffectiveLabel

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

JSON representation 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resourceName

string

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

campaign

string

The campaign to which the effective label is attached.

label

string

The effective label assigned to the campaign.

ownerCustomerId

string ( int64 format)

The ID of the Customer which owns the effective label.

CampaignLabel

نشان‌دهنده رابطه بین یک کمپین و یک برچسب است.

JSON representation 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
فیلدها
resourceName

string

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

campaign

string

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

label

string

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

ownerCustomerId

string ( int64 format)

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

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

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

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

ConversionActionType

Possible types of a conversion action.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
AD_CALL Conversions that occur when a user clicks on an ad's call extension.
CLICK_TO_CALL Conversions that occur when a user on a mobile device clicks a phone number.
GOOGLE_PLAY_DOWNLOAD Conversions that occur when a user downloads a mobile app from the Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversions that occur when a user makes a purchase in an app through Android billing.
UPLOAD_CALLS Call conversions that are tracked by the advertiser and uploaded.
UPLOAD_CLICKS Conversions that are tracked by the advertiser and uploaded with attributed clicks.
WEBPAGE Conversions that occur on a webpage.
WEBSITE_CALL Conversions that occur when a user calls a dynamically-generated phone number from an advertiser's website.
STORE_SALES_DIRECT_UPLOAD Store Sales conversion based on first-party or third-party merchant data uploads. Only customers on the allowlist can use store sales direct upload types.
STORE_SALES Store Sales conversion based on first-party or third-party merchant data uploads and/or from in-store purchases using cards from payment networks. Only customers on the allowlist can use store sales types. Read only.
FIREBASE_ANDROID_FIRST_OPEN Android app first open conversions tracked through Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Android app in app purchase conversions tracked through Firebase.
FIREBASE_ANDROID_CUSTOM Android app custom conversions tracked through Firebase.
FIREBASE_IOS_FIRST_OPEN iOS app first open conversions tracked through Firebase.
FIREBASE_IOS_IN_APP_PURCHASE iOS app in app purchase conversions tracked through Firebase.
FIREBASE_IOS_CUSTOM iOS app custom conversions tracked through Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Android app first open conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Android app in app purchase conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Android app custom conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN iOS app first open conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE iOS app in app purchase conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM iOS app custom conversions tracked through Third Party App Analytics.
ANDROID_APP_PRE_REGISTRATION Conversions that occur when a user pre-registers a mobile app from the Google Play Store. Read only.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions that track all Google Play downloads which aren't tracked by an app-specific type. Read only.
FLOODLIGHT_ACTION Floodlight activity that counts the number of times that users have visited a particular webpage after seeing or clicking on one of an advertiser's ads. Read only.
FLOODLIGHT_TRANSACTION Floodlight activity that tracks the number of sales made or the number of items purchased. Can also capture the total value of each sale. Read only.
GOOGLE_HOSTED Conversions that track local actions from Google's products and services after interacting with an ad. Read only.
LEAD_FORM_SUBMIT Conversions reported when a user submits a lead form. Read only.
SALESFORCE

Deprecated: The Salesforce integration will be going away and replaced with an improved way to import your conversions from Salesforce. - see https://support.google.com/google-ads/answer/14728349

SEARCH_ADS_360 Conversions imported from Search Ads 360 Floodlight data. Read only.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Call conversions that occur on Smart campaign Ads without call tracking setup, using Smart campaign custom criteria. Read only.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL The user clicks on a call element within Google Maps. Smart campaign only. Read only.
SMART_CAMPAIGN_MAP_DIRECTIONS The user requests directions to a business location within Google Maps. Smart campaign only. Read only.
SMART_CAMPAIGN_TRACKED_CALLS Call conversions that occur on Smart campaign Ads with call tracking setup, using Smart campaign custom criteria. Read only.
STORE_VISITS Conversions that occur when a user visits an advertiser's retail store. Read only.
WEBPAGE_CODELESS Conversions created from website events (such as form submissions or page loads), that don't use individually coded event snippets. Read only.
UNIVERSAL_ANALYTICS_GOAL Conversions that come from linked Universal Analytics goals.
UNIVERSAL_ANALYTICS_TRANSACTION Conversions that come from linked Universal Analytics transactions.
GOOGLE_ANALYTICS_4_CUSTOM Conversions that come from linked Google Analytics 4 custom event conversions.
GOOGLE_ANALYTICS_4_PURCHASE Conversions that come from linked Google Analytics 4 purchase conversions.

ConversionActionCategory

The category of conversions that are associated with a ConversionAction.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
DEFAULT Default category.
PAGE_VIEW User visiting a page.
PURCHASE Purchase, sales, or "order placed" event.
SIGNUP Signup user action.
LEAD Lead-generating action.
DOWNLOAD Software download action (as for an app).
ADD_TO_CART The addition of items to a shopping cart or bag on an advertiser site.
BEGIN_CHECKOUT When someone enters the checkout flow on an advertiser site.
SUBSCRIBE_PAID The start of a paid subscription for a product or service.
PHONE_CALL_LEAD A call to indicate interest in an advertiser's offering.
IMPORTED_LEAD A lead conversion imported from an external source into Google Ads.
SUBMIT_LEAD_FORM A submission of a form on an advertiser site indicating business interest.
BOOK_APPOINTMENT A booking of an appointment with an advertiser's business.
REQUEST_QUOTE A quote or price estimate request.
GET_DIRECTIONS A search for an advertiser's business location with intention to visit.
OUTBOUND_CLICK A click to an advertiser's partner's site.
CONTACT A call, SMS, email, chat or other type of contact to an advertiser.
ENGAGEMENT A website engagement event such as long site time or a Google Analytics (GA) Smart Goal. Intended to be used for GA, Firebase, GA Gold goal imports.
STORE_VISIT A visit to a physical store location.
STORE_SALE A sale occurring in a physical store.
QUALIFIED_LEAD A lead conversion imported from an external source into Google Ads, that has been further qualified by the advertiser (marketing/sales team). In the lead-to-sale journey, advertisers get leads, then act on them by reaching out to the consumer. If the consumer is interested and may end up buying their product, the advertiser marks such leads as "qualified leads".
CONVERTED_LEAD A lead conversion imported from an external source into Google Ads, that has further completed a chosen stage as defined by the lead gen advertiser.

ValueSettings

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

نمایش JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
فیلدها
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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
EXTERNAL Uses external attribution.
GOOGLE_ADS_LAST_CLICK Attributes all credit for a conversion to its last click.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Attributes all credit for a conversion to its first click using Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Attributes credit for a conversion equally across all of its clicks using Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Attributes exponentially more credit for a conversion to its more recent clicks using Google Search attribution (half-life is 1 week).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attributes 40% of the credit for a conversion to its first and last clicks. Remaining 20% is evenly distributed across all other clicks. This uses Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Flexible model that uses machine learning to determine the appropriate distribution of credit among clicks using Google Search attribution.

DataDrivenModelStatus

Enumerates data driven model statuses.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
AVAILABLE The data driven model is available.
STALE The data driven model is stale. It hasn't been updated for at least 7 days. It is still being used, but will become expired if it does not get updated for 30 days.
EXPIRED The data driven model expired. It hasn't been updated for at least 30 days and cannot be used. Most commonly this is because there hasn't been the required number of events in a recent 30-day period.
NEVER_GENERATED The data driven model has never been generated. Most commonly this is because there has never been the required number of events in any 30-day period.

FloodlightSettings

Settings related to a Floodlight conversion action.

JSON 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

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

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

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVATION_NEEDED

The conversion custom variable is pending activation and will not accrue stats until set to ENABLED.

This status can't be used in CREATE and UPDATE requests.

ENABLED The conversion custom variable is enabled and will accrue stats.
PAUSED The conversion custom variable is paused and will not accrue stats until set to ENABLED again.

ConversionCustomVariableFamily

Family of a conversion custom variable.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
STANDARD The standard conversion custom variable. Customers are required to activate before use.
FLOODLIGHT The conversion custom variable imported from a custom floodlight variable.

ConversionCustomVariableCardinality

Cardinality of a conversion custom variable.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
BELOW_ALL_LIMITS The conversion custom variable has cardinality below all limits. The variable can be used for segmentation, and stats can accrue for new values if the variable is enabled.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT The conversion custom variable has cardinality that exceeds the segmentation limit, but does not exceed the stats limit. Segmentation will be disabled, but stats can accrue for new values if the variable is enabled.
APPROACHES_STATS_LIMIT The conversion custom variable has exceeded the segmentation limits, and is approaching the stats limits (> 90%). Segmentation will be disabled, but stats can accrue for new values if the variable is enabled.
EXCEEDS_STATS_LIMIT The conversion custom variable has exceeded both the segmentation limits and stats limits. Segmentation will be disabled, and stats for enabled variables can accrue only if the existing values do not increase the cardinality of the variable any further.

FloodlightConversionCustomVariableInfo

Information for Search Ads 360 Floodlight Conversion Custom Variables.

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

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
DIMENSION Dimension floodlight variable type.
METRIC Metric floodlight variable type.
UNSET Floodlight variable type is unset.

FloodlightVariableDataType

The data type of the floodlight variable, as defined in Search Ads 360. See https://support.google.com/searchads/answer/4397154?hl=en to learn more.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
NUMBER Represents a floodlight variable of "Number" type. This variable may be assigned to floodlight variables of DIMENSION or METRIC types.
STRING Represents a floodlight variable of "String" type. This variable may be assigned to floodlight variables of DIMENSION type.

مشتری

A customer.

JSON representation 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "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.

managerId

string ( int64 format)

The customer ID of the manager. A 0 value indicates that the customer has no SA360 manager.

managerDescriptiveName

string

The descriptive name of the manager.

subManagerId

string ( int64 format)

The customer ID of the sub manager. A 0 value indicates that the customer has no sub SA360 manager.

subManagerDescriptiveName

string

The descriptive name of the sub manager.

associateManagerId

string ( int64 format)

The customer ID of the associate manager. A 0 value indicates that the customer has no SA360 associate manager.

associateManagerDescriptiveName

string

The descriptive name of the associate manager.

accountLevel

enum ( AccountLevelType )

The account level of the customer: Manager, Sub-manager, Associate manager, Service account.

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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
NOT_CONVERSION_TRACKED Customer does not use any conversion tracking.
CONVERSION_TRACKING_MANAGED_BY_SELF The conversion actions are created and managed by this customer.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER The conversion actions are created and managed by the manager specified in the request's login-customer-id .
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER The conversion actions are created and managed by a manager different from the customer or manager specified in the request's login-customer-id .

AccountType

Possible engine account types.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
BAIDU Baidu account.
ENGINE_TRACK Engine track account.
FACEBOOK Facebook account.
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.

AccountStatus

Possible statuses of an account.

انوم‌ها
UNSPECIFIED Default value.
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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Indicates an active account able to serve ads.
CANCELED Indicates a canceled account unable to serve ads. Can be reactivated by an admin user.
SUSPENDED Indicates a suspended account unable to serve ads. May only be activated by Google support.
CLOSED Indicates a closed account unable to serve ads. Test account will also have CLOSED status. Status is permanent and may not be reopened.

AccountLevelType

Enum describing possible account levels.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
CLIENT_ACCOUNT_FACEBOOK Client account (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS Client account (Google Ads)
CLIENT_ACCOUNT_MICROSOFT Client account (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN Client account (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK Client account (Engine Track)
MANAGER Top-level manager.
SUB_MANAGER Sub manager.
ASSOCIATE_MANAGER Associate manager.

CustomerAsset

A link between a customer and an asset.

نمایش JSON 
{
  "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

Required. 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. Read-only.

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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVE Indicates current in-effect relationship
INACTIVE Indicates terminated relationship
PENDING Indicates relationship has been requested by manager, but the client hasn't accepted yet.
REFUSED Relationship was requested by the manager, but the client has refused.
CANCELED Indicates relationship has been requested by manager, but manager canceled it.

CustomerClient

A link between the given customer and a client customer. CustomerClients only exist for manager customers. All direct and indirect client customers are included, as well as the manager itself.

JSON 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. Read only.

clientCustomer

string

The resource name of the client-customer which is linked to the given customer. Read only.

hidden

boolean

Specifies whether this is a hidden account.

Read only.

level

string ( int64 format)

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

timeZone

string

Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only.

testAccount

boolean

Identifies if the client is a test account. Read only.

manager

boolean

Identifies if the client is a manager. Read only.

descriptiveName

string

Descriptive name for the client. Read only.

currencyCode

string

Currency code (for example, 'USD', 'EUR') for the client. Read only.

id

string ( int64 format)

The ID of the client customer. Read only.

DynamicSearchAdsSearchTermView

A dynamic search ads search term view.

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

انوم‌ها
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}

برچسب

A label.

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/{ownerCustomerId}/labels/{label_id}

status

enum ( LabelStatus )

Status of the label. Read only.

textLabel

object ( TextLabel )

A type of label displaying text on a colored background.

id

string ( int64 format)

ID of the label. Read only.

name

string

The name of the label.

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

The length of this string should be between 1 and 80, inclusive.

LabelStatus

Possible statuses of a label.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Label is enabled.
REMOVED Label is removed.

TextLabel

A type of label displaying text on a colored background.

JSON representation 
{
  "backgroundColor": string,
  "description": string
}
فیلدها
backgroundColor

string

Background color of the label in HEX format. This string must match the regular expression '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.

description

string

A short description of the label. The length must be no more than 200 characters.

LanguageConstant

A language.

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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEVEL1 Level 1.
LEVEL2 Level 2.
LEVEL3 سطح ۳.
LEVEL4 Level 4.
LEVEL5 سطح ۵.

ProductBiddingCategoryStatus

Enum describing the status of the product bidding category.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVE The category is active and can be used for bidding.
OBSOLETE The category is obsolete. Used only for reporting purposes.

ProductGroupView

A product group view.

نمایش JSON 
{
  "resourceName": string
}
فیلدها
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

UserList

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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
REMARKETING UserList represented as a collection of conversion types.
LOGICAL UserList represented as a combination of other user lists/interests.
EXTERNAL_REMARKETING UserList created in the Google Ad Manager platform.
RULE_BASED UserList associated with a rule.
SIMILAR UserList with users similar to users of another UserList.
CRM_BASED UserList of first-party CRM data provided by advertiser in the form of emails or other formats.

UserLocationView

A user location view.

User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.

JSON representation 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
فیلدها
resourceName

string

The resource name of the user location view. UserLocation view resource names have the form:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string ( int64 format)

Criterion Id for the country.

targetingLocation

boolean

Indicates whether location was targeted or not.

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}

بازدید

A visit.

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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ONLINE The item is sold online.
LOCAL The item is sold in local stores.

تبدیل

A conversion.

JSON 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

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
VISIT The conversion is attributed to a visit.
CRITERION_AD The conversion is attributed to a criterion and ad pair.

ConversionStatus

Possible statuses of a conversion.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED The conversion is enabled.
REMOVED The conversion has been removed.

معیارها

Metrics data.

JSON 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,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": 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.

crossDeviceConversionsByConversionDate

number

The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 .

crossDeviceConversionsValue

number

The sum of the value of cross-device conversions.

crossDeviceConversionsValueByConversionDate

number

The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 .

ctr

number

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).

conversions

number

The number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

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.

averageQualityScore

number

The average quality score.

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.

generalInvalidClickRate

number

The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details.

generalInvalidClicks

string ( int64 format)

Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details.

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.

uniqueUsers

string ( int64 format)

The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App.

averageImpressionFrequencyPerUser

number

The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App.

ارزش

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

یک مقدار بولی.

int64Value

string ( int64 format)

An int64.

floatValue

number

A float.

doubleValue

number

A double.

stringValue

string

یک رشته.

QualityScoreBucket

Enum listing the possible quality score buckets.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
BELOW_AVERAGE Quality of the creative is below average.
AVERAGE Quality of the creative is average.
ABOVE_AVERAGE Quality of the creative is above average.

InteractionEventType

Enum describing possible types of payable and free interactions.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
CLICK Click to site. In most cases, this interaction navigates to an external location, usually the advertiser's landing page. This is also the default InteractionEventType for click events.
ENGAGEMENT The user's expressed intent to engage with the ad in-place.
VIDEO_VIEW User viewed a video ad.
NONE The default InteractionEventType for ad conversion events. This is used when an ad conversion row does NOT indicate that the free interactions (for example, the ad conversions) should be 'promoted' and reported as part of the core metrics. These are simply other (ad) conversions.

بخش‌ها

Segment only fields.

JSON 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,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
فیلدها
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.

geoTargetCity

string

Resource name of the geo target constant that represents a city.

geoTargetCountry

string

Resource name of the geo target constant that represents a country.

geoTargetMetro

string

Resource name of the geo target constant that represents a metro.

geoTargetRegion

string

Resource name of the geo target constant that represents a region.

hour

integer

Hour of day as a number between 0 and 23, inclusive.

month

string

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

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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN The value is unknown in this version.
SEARCH Google 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.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
SINGLE_CHANNEL The item is sold through one channel only, either local stores or online as indicated by its ProductChannel.
MULTI_CHANNEL The item is matched to its online or local stores counterpart, indicating it is available for purchase in both ShoppingProductChannels.

ProductCondition

Enum describing the condition of a product offer.

انوم‌ها
UNSPECIFIED مشخص نشده است.
UNKNOWN Used for return value only. Represents value unknown in this version.
OLD The product condition is old.
NEW The product condition is new.
REFURBISHED The product condition is refurbished.
USED The product condition is used.

AssetInteractionTarget

An AssetInteractionTarget segment.

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