Campaign

یک کمپین.

نمایندگی JSON 
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

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

string

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

customers/{customerId}/campaigns/{campaignId}

primary Status

enum ( CampaignPrimaryStatus )

فقط خروجی وضعیت اولیه کمپین.

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

primary Status Reasons[]

enum ( CampaignPrimaryStatusReason )

فقط خروجی دلایل وضعیت اولیه کمپین

بینشی در مورد اینکه چرا یک کمپین به طور مطلوب ارائه نمی شود یا ارائه نمی دهد. این دلایل برای تعیین یک CampaignPrimaryStatus کلی جمع آوری می شوند.

status

enum ( CampaignStatus )

وضعیت کمپین

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

serving Status

enum ( CampaignServingStatus )

فقط خروجی وضعیت ارائه تبلیغات کمپین.

bidding Strategy System Status

enum ( BiddingStrategySystemStatus )

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

ad Serving Optimization Status

enum ( AdServingOptimizationStatus )

وضعیت بهینه سازی سرویس تبلیغات کمپین.

advertising Channel Type

enum ( AdvertisingChannelType )

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

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

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

advertising Channel Sub Type

enum ( AdvertisingChannelSubType )

تغییرناپذیر. اصلاح اختیاری در advertisingChannelType . باید یک نوع فرعی معتبر از نوع کانال اصلی باشد.

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

url Custom Parameters[]

object ( CustomParameter )

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

local Services Campaign Settings

object ( LocalServicesCampaignSettings )

تنظیمات مربوط به کمپین خدمات محلی.

travel Campaign Settings

object ( TravelCampaignSettings )

تنظیمات برای کمپین سفر.

demand Gen Campaign Settings

object ( DemandGenCampaignSettings )

تنظیمات برای کمپین تقاضای نسل.

video Campaign Settings

object ( VideoCampaignSettings )

تنظیمات کمپین ویدیویی

real Time Bidding Setting

object ( RealTimeBiddingSetting )

تنظیمات برای مناقصه بلادرنگ، ویژگی فقط برای کمپین هایی که شبکه Ad Exchange را هدف قرار می دهند.

network Settings

object ( NetworkSettings )

تنظیمات شبکه برای کمپین

hotel Setting

object ( HotelSettingInfo )

تغییرناپذیر. تنظیمات هتل برای کمپین.

dynamic Search Ads Setting

object ( DynamicSearchAdsSetting )

تنظیم برای کنترل تبلیغات جستجوی پویا (DSA).

shopping Setting

object ( ShoppingSetting )

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

targeting Setting

object ( TargetingSetting )

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

geo Target Type Setting

object ( GeoTargetTypeSetting )

تنظیمات برای هدف‌یابی جغرافیایی تبلیغات.

local Campaign Setting

object ( LocalCampaignSetting )

تنظیم برای کمپین محلی.

app Campaign Setting

object ( AppCampaignSetting )

تنظیمات مربوط به کمپین برنامه.

labels[]

string

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

experiment Type

enum ( CampaignExperimentType )

فقط خروجی نوع کمپین: عادی، پیش‌نویس یا آزمایشی.

bidding Strategy Type

enum ( BiddingStrategyType )

فقط خروجی نوع استراتژی مناقصه.

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

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

accessible Bidding Strategy

string

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

frequency Caps[]

object ( FrequencyCapEntry )

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

video Brand Safety Suitability

enum ( BrandSafetySuitability )

تنظیم ایمنی برند در سطح کمپین فردی. امکان انتخاب نوع موجودی برای نمایش تبلیغات شما بر روی محتوایی که مناسب برند شماست. به https://support.google.com/google-ads/answer/7515513 مراجعه کنید.

vanity Pharma

object ( VanityPharma )

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

selective Optimization

object ( SelectiveOptimization )

تنظیمات بهینه‌سازی انتخابی برای این کمپین، که شامل مجموعه‌ای از اقدامات تبدیلی برای بهینه‌سازی این کمپین است. این ویژگی فقط برای کمپین های برنامه ای اعمال می شود که از MULTI_CHANNEL به عنوان AdvertisingChannelType و APP_CAMPAIGN یا APP_CAMPAIGN_FOR_ENGAGEMENT به عنوان AdvertisingChannelSubType استفاده می کنند.

optimization Goal Setting

object ( OptimizationGoalSetting )

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

tracking Setting

object ( TrackingSetting )

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

payment Mode

enum ( PaymentMode )

حالت پرداخت برای کمپین

excluded Parent Asset Field Types[]

enum ( AssetFieldType )

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

excluded Parent Asset Set Types[]

enum ( AssetSetType )

انواع مجموعه دارایی که باید از این کمپین حذف شوند. پیوندهای مجموعه دارایی با این انواع توسط این کمپین از سطح بالا به ارث نمی رسد. انواع گروه مکان (GMB_DYNAMIC_LOCATION_GROUP، CHAIN_DYNAMIC_LOCATION_GROUP، و STATIC_LOCATION_GROUP) انواع فرزند LOCATION_SYNC هستند. بنابراین، اگر LOCATION_SYNC برای این فیلد تنظیم شده باشد، همه مجموعه‌های دارایی گروه مکان مجاز به پیوند به این کمپین نیستند و همه برنامه‌های افزودنی مکان (LE) و برنامه‌های افزودنی مکان وابسته (ALE) تحت این کمپین ارائه نمی‌شوند. در حال حاضر فقط LOCATION_SYNC پشتیبانی می شود.

performance Max Upgrade

object ( PerformanceMaxUpgrade )

فقط خروجی اطلاعاتی درباره کمپین هایی که به حداکثر عملکرد ارتقا می یابند.

asset Automation Settings[]

object ( AssetAutomationSetting )

شامل وضعیت انتخاب/خروج هر AssetAutomationType است. برای رفتار پیش‌فرض انصراف/خروج کردن، به مستندات هر نوع دارایی خودکارسازی enum مراجعه کنید.

keyword Match Type

enum ( CampaignKeywordMatchType )

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

id

string ( int64 format)

فقط خروجی شناسه کمپین

name

string

نام کمپین.

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

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

tracking Url Template

string

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

audience Setting

object ( AudienceSetting )

تغییرناپذیر. تنظیم برای ویژگی های مرتبط با مخاطب

base Campaign

string

فقط خروجی نام منبع کمپین پایه یک کمپین پیش نویس یا آزمایشی. برای کمپین های پایه، این برابر با resourceName است.

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

campaign Budget

string

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

start Date

string

تاریخ شروع کمپین در ارائه خدمات به منطقه زمانی مشتری در قالب YYYY-MM-DD.

campaign Group

string

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

end Date

string

آخرین روز از کمپین خدمات رسانی به منطقه زمانی مشتری در قالب YYYY-MM-DD. در ایجاد، پیش‌فرض 2037-12-30 است، به این معنی که کمپین به‌طور نامحدود اجرا می‌شود. برای تنظیم یک کمپین موجود برای اجرای نامحدود، این فیلد را روی 2037-12-30 تنظیم کنید.

final Url Suffix

string

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

optimization Score

number

فقط خروجی امتیاز بهینه سازی کمپین

امتیاز بهینه سازی تخمینی است از میزان عملکرد یک کمپین. از 0٪ (0.0) تا 100٪ (1.0) متغیر است که 100٪ نشان می دهد که کمپین با پتانسیل کامل کار می کند. این فیلد برای کمپین های بدون امتیاز خالی است.

به «درباره امتیاز بهینه‌سازی» در https://support.google.com/google-ads/answer/9061546 مراجعه کنید.

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

url Expansion Opt Out

boolean

نشان دهنده انصراف از گسترش URL به URL های هدفمندتر است. در صورت انصراف (درست)، فقط نشانی‌های وب نهایی در گروه دارایی یا نشانی‌های وب مشخص‌شده در مرکز تجاری Google تبلیغ‌کننده یا فیدهای داده‌های کسب‌وکار مورد هدف قرار می‌گیرند. در صورت انتخاب (نادرست)، کل دامنه هدف قرار خواهد گرفت. این فیلد را فقط می‌توان برای کمپین‌های Performance Max تنظیم کرد، جایی که مقدار پیش‌فرض نادرست است.

hotel Property Asset Set

string

تغییرناپذیر. نام منبع مجموعه‌ای از املاک هتل برای کمپین‌های Performance Max برای اهداف سفر.

listing Type

enum ( ListingType )

تغییرناپذیر. نوع لیست تبلیغات ارائه شده برای این کمپین. این فیلد برای استفاده با کمپین‌های Performance Max محدود شده است.

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

باید نمونه کارها (ایجاد شده از طریق سرویس BiddingStrategy) یا استاندارد باشد که در کمپین تعبیه شده است. campaign_bidding_strategy تنها می تواند یکی از موارد زیر باشد:

bidding Strategy

string

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

commission

object ( Commission )

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

manual Cpa

object ( ManualCpa )

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

manual Cpc

object ( ManualCpc )

استراتژی مناقصه CPC دستی استاندارد. مناقصه مبتنی بر کلیک دستی که در آن کاربر به ازای هر کلیک پرداخت می کند.

manual Cpm

object ( ManualCpm )

استراتژی مناقصه CPM دستی استاندارد. مناقصه مبتنی بر نمایش دستی که در آن کاربر به ازای هر هزار بار نمایش پرداخت می کند.

manual Cpv

object ( ManualCpv )

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

maximize Conversions

object ( MaximizeConversions )

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

maximize Conversion Value

object ( MaximizeConversionValue )

استراتژی پیشنهادی استاندارد حداکثر کردن ارزش تبدیل که به طور خودکار پیشنهادهایی را برای به حداکثر رساندن درآمد در حین خرج کردن بودجه تنظیم می کند.

target Cpa

object ( TargetCpa )

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

target Impression Share

object ( TargetImpressionShare )

استراتژی پیشنهاد اشتراک هدف. یک استراتژی مناقصه خودکار که پیشنهادات را برای دستیابی به درصد انتخابی از نمایش‌ها تنظیم می‌کند.

target Roas

object ( TargetRoas )

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

target Spend

object ( TargetSpend )

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

percent Cpc

object ( PercentCpc )

استراتژی مناقصه استاندارد درصد Cpc که در آن پیشنهادها کسری از قیمت تبلیغ شده برای برخی کالاها یا خدمات است.

target Cpm

object ( TargetCpm )

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

fixed Cpm

object ( FixedCpm )

یک استراتژی مناقصه دستی با CPM ثابت.

target Cpv

object ( TargetCpv )

یک استراتژی مناقصه خودکار که با توجه به CPV هدفی که تعیین کرده‌اید، قیمت‌ها را برای بهینه‌سازی عملکرد تنظیم می‌کند.

CampaignPrimaryStatus

Enum وضعیت اولیه کمپین احتمالی را توصیف می کند. بینشی در مورد اینکه چرا یک کمپین به طور مطلوب ارائه نمی شود یا ارائه نمی دهد. تغییر در کمپین و نهادهای مرتبط با آن ممکن است مدتی طول بکشد تا در این وضعیت منعکس شود.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ELIGIBLE کمپین واجد شرایط خدمت است.
PAUSED وضعیت کمپین مشخص شده توسط کاربر متوقف شده است.
REMOVED وضعیت کمپین مشخص شده توسط کاربر حذف شده است.
ENDED زمان مشخص شده توسط کاربر برای پایان این کمپین گذشته است.
PENDING این کمپین ممکن است در آینده خدمت کند.
MISCONFIGURED کمپین یا نهادهای مرتبط با آن تنظیمات مشخص شده توسط کاربر نادرست است.
LIMITED کمپین یا نهادهای مرتبط با آن توسط تنظیمات مشخص شده توسط کاربر محدود شده است.
LEARNING سیستم مناقصه خودکار با تغییرات مشخص شده توسط کاربر در کمپین یا نهادهای مرتبط تنظیم می شود.
NOT_ELIGIBLE کمپین واجد شرایط ارائه خدمات نیست.

CampaignPrimaryStatusReason

فهرستی که دلایل احتمالی وضعیت اولیه کمپین را توضیح می دهد. بینشی در مورد اینکه چرا یک کمپین به طور مطلوب ارائه نمی شود یا ارائه نمی دهد. این دلایل برای تعیین وضعیت اصلی کمپین جمع آوری می شوند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
CAMPAIGN_REMOVED وضعیت کمپین مشخص شده توسط کاربر حذف شده است.
CAMPAIGN_PAUSED وضعیت کمپین مشخص شده توسط کاربر متوقف شده است.
CAMPAIGN_PENDING زمان مشخص شده توسط کاربر برای شروع این کمپین در آینده است.
CAMPAIGN_ENDED زمان مشخص شده توسط کاربر برای پایان این کمپین گذشته است.
CAMPAIGN_DRAFT کمپین یک پیش نویس است.
BIDDING_STRATEGY_MISCONFIGURED استراتژی مناقصه تنظیمات مشخص شده توسط کاربر نادرست است.
BIDDING_STRATEGY_LIMITED استراتژی مناقصه توسط تنظیمات مشخص شده توسط کاربر مانند کمبود داده یا موارد مشابه محدود شده است.
BIDDING_STRATEGY_LEARNING سیستم مناقصه خودکار با تغییرات مشخص شده توسط کاربر در استراتژی مناقصه تنظیم می شود.
BIDDING_STRATEGY_CONSTRAINED کمپین می‌تواند با تنظیم اهداف CPA/ROAS، ارزش تبدیل بیشتری را جذب کند.
BUDGET_CONSTRAINED بودجه توانایی کمپین را برای ارائه خدمات محدود می کند.
BUDGET_MISCONFIGURED بودجه تنظیمات مشخص شده توسط کاربر نادرست است.
SEARCH_VOLUME_LIMITED کمپین همه پرس و جوهای مرتبط را هدف قرار نمی دهد.
AD_GROUPS_PAUSED وضعیت های گروه تبلیغاتی مشخص شده توسط کاربر همگی متوقف می شوند.
NO_AD_GROUPS هیچ گروه تبلیغاتی واجد شرایطی در این کمپین وجود ندارد.
KEYWORDS_PAUSED وضعیت های کلمه کلیدی مشخص شده توسط کاربر همگی متوقف شده اند.
NO_KEYWORDS هیچ کلمه کلیدی واجد شرایطی در این کمپین وجود ندارد.
AD_GROUP_ADS_PAUSED وضعیت های تبلیغات گروه تبلیغاتی مشخص شده توسط کاربر، همه متوقف شده اند.
NO_AD_GROUP_ADS هیچ آگهی گروه تبلیغاتی واجد شرایطی در این کمپین وجود ندارد.
HAS_ADS_LIMITED_BY_POLICY حداقل یک تبلیغ در این کمپین توسط خط مشی محدود شده است.
HAS_ADS_DISAPPROVED حداقل یک تبلیغ در این کمپین تایید نشده است.
MOST_ADS_UNDER_REVIEW اکثر تبلیغات در این کمپین در حال بررسی هستند.
MISSING_LEAD_FORM_EXTENSION این کمپین دارای یک هدف فرم سرب است و پسوند فرم سرنخ وجود ندارد.
MISSING_CALL_EXTENSION این کمپین دارای یک هدف تماس است و افزونه تماس موجود نیست.
LEAD_FORM_EXTENSION_UNDER_REVIEW پسوند فرم سرنخ در دست بررسی است.
LEAD_FORM_EXTENSION_DISAPPROVED پسوند سرنخ تأیید نشده است.
CALL_EXTENSION_UNDER_REVIEW تمدید تماس در دست بررسی است.
CALL_EXTENSION_DISAPPROVED تمدید تماس تایید نشد.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA هیچ معیار واجد شرایطی برای گروه تبلیغات برنامه تلفن همراه در این کمپین وجود ندارد.
CAMPAIGN_GROUP_PAUSED وضعیت گروه کمپین مشخص شده توسط کاربر متوقف شده است.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED زمان‌های مشخص شده توسط کاربر برای همه بودجه‌های گروه مرتبط با گروه کمپین والد به پایان رسیده است.
APP_NOT_RELEASED برنامه مرتبط با این کمپین ACi در کشورهای هدف کمپین منتشر نشده است.
APP_PARTIALLY_RELEASED برنامه مرتبط با این کمپین ACi تا حدی در کشورهای هدف کمپین منتشر شده است.
HAS_ASSET_GROUPS_DISAPPROVED حداقل یک گروه دارایی در این کمپین تایید نشده است.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY حداقل یک گروه دارایی در این کمپین توسط خط‌مشی محدود شده است.
MOST_ASSET_GROUPS_UNDER_REVIEW اکثر گروه‌های دارایی در این کمپین در انتظار بررسی هستند.
NO_ASSET_GROUPS هیچ گروه دارایی واجد شرایطی در این کمپین وجود ندارد.
ASSET_GROUPS_PAUSED همه گروه‌های دارایی در این کمپین موقتاً متوقف شده‌اند.

وضعیت کمپین

وضعیت های احتمالی یک کمپین

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

CampaignServingStatus

وضعیت های احتمالی ارائه یک کمپین.

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

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

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

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

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

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

Enums
UNSPECIFIED سیگنال هایی مبنی بر اینکه یک خطای غیرمنتظره رخ داده است، به عنوان مثال، هیچ نوع استراتژی پیشنهادی یافت نشد، یا هیچ اطلاعات وضعیتی یافت نشد.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ENABLED استراتژی پیشنهاد فعال است و AdWords نمی تواند مشکل خاصی را در مورد استراتژی پیدا کند.
LEARNING_NEW استراتژی پیشنهادی یادگیری است زیرا اخیرا ایجاد شده یا اخیراً مجدداً فعال شده است.
LEARNING_SETTING_CHANGE استراتژی پیشنهاد به دلیل تغییر تنظیمات اخیر در حال یادگیری است.
LEARNING_BUDGET_CHANGE استراتژی پیشنهاد به دلیل تغییر بودجه اخیر در حال یادگیری است.
LEARNING_COMPOSITION_CHANGE استراتژی پیشنهادی به دلیل تغییر اخیر در تعداد کمپین ها، گروه های تبلیغاتی یا کلمات کلیدی متصل به آن، یادگیری است.
LEARNING_CONVERSION_TYPE_CHANGE استراتژی پیشنهاد به گزارش تبدیل بستگی دارد و مشتری اخیراً انواع تبدیل را که مربوط به استراتژی پیشنهاد است تغییر داده است.
LEARNING_CONVERSION_SETTING_CHANGE استراتژی پیشنهاد به گزارش تبدیل بستگی دارد و مشتری اخیراً تنظیمات تبدیل خود را تغییر داده است.
LIMITED_BY_CPC_BID_CEILING استراتژی پیشنهاد با سقف پیشنهادی آن محدود می شود.
LIMITED_BY_CPC_BID_FLOOR استراتژی پیشنهادی با کف قیمت آن محدود می شود.
LIMITED_BY_DATA استراتژی پیشنهاد محدود است زیرا در هفته‌های گذشته ترافیک تبدیل کافی وجود نداشت.
LIMITED_BY_BUDGET بخش قابل توجهی از کلمات کلیدی در این استراتژی پیشنهادی توسط بودجه محدود شده است.
LIMITED_BY_LOW_PRIORITY_SPEND استراتژی پیشنهاد نمی تواند به هزینه مورد نظر خود برسد زیرا هزینه آن از اولویت خارج شده است.
LIMITED_BY_LOW_QUALITY بخش قابل توجهی از کلمات کلیدی در این استراتژی پیشنهادی دارای امتیاز کیفیت پایینی هستند.
LIMITED_BY_INVENTORY استراتژی پیشنهاد به دلیل هدف گذاری محدود نمی تواند بودجه خود را به طور کامل خرج کند.
MISCONFIGURED_ZERO_ELIGIBILITY ردیابی تبدیل (بدون پینگ) و/یا لیست های بازاریابی مجدد برای SSC وجود ندارد.
MISCONFIGURED_CONVERSION_TYPES استراتژی پیشنهاد به گزارش تبدیل بستگی دارد و مشتری فاقد انواع تبدیلی است که ممکن است در مقابل این استراتژی گزارش شود.
MISCONFIGURED_CONVERSION_SETTINGS استراتژی پیشنهاد به گزارش تبدیل بستگی دارد و تنظیمات تبدیل مشتری به اشتباه پیکربندی شده است.
MISCONFIGURED_SHARED_BUDGET کمپین هایی خارج از استراتژی پیشنهادی وجود دارند که بودجه را با کمپین های موجود در استراتژی به اشتراک می گذارند.
MISCONFIGURED_STRATEGY_TYPE این کمپین دارای نوع استراتژی نامعتبر است و در حال ارائه نیست.
PAUSED استراتژی پیشنهاد فعال نیست. یا هیچ کمپین فعال، گروه تبلیغاتی یا کلیدواژه‌ای به استراتژی پیشنهادی متصل نیست. یا هیچ بودجه فعال مرتبط با استراتژی پیشنهاد وجود ندارد.
UNAVAILABLE این استراتژی پیشنهاد در حال حاضر از گزارش وضعیت پشتیبانی نمی کند.
MULTIPLE_LEARNING چندین وضعیت سیستم LEARNING_* برای این استراتژی پیشنهادی در طول زمان مورد بحث وجود داشت.
MULTIPLE_LIMITED در طول زمان مورد بحث، چندین وضعیت سیستم LIMITED_* برای این استراتژی پیشنهادی وجود داشت.
MULTIPLE_MISCONFIGURED چندین وضعیت سیستم MISCONFIGURED_* برای این استراتژی پیشنهادی در طول زمان مورد بحث وجود داشت.
MULTIPLE در طول زمان مورد بحث، چندین وضعیت سیستم برای این استراتژی پیشنهادی وجود داشت.

AdServingOptimization Status

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

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

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

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

OPTIMIZE ارائه تبلیغات بر اساس CTR برای کمپین بهینه شده است.
CONVERSION_OPTIMIZE ارائه تبلیغات بر اساس CTR * تبدیل برای کمپین بهینه شده است. اگر کمپین در استراتژی مناقصه بهینه‌ساز تبدیل نباشد، پیش‌فرض روی OPTIMIZED خواهد بود.
ROTATE تبلیغات به مدت 90 روز به طور یکنواخت چرخانده می شوند، سپس برای کلیک ها بهینه می شوند.
ROTATE_INDEFINITELY تبلیغات با عملکرد پایین تر را با تبلیغات با عملکرد بالاتر به طور یکنواخت نشان دهید و بهینه سازی نکنید.
UNAVAILABLE وضعیت بهینه سازی سرویس تبلیغات در دسترس نیست.

LocalServicesCampaignSettings

تنظیمات برای منبع فرعی LocalServicesCampaign.

نمایندگی JSON 
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
فیلدها
category Bids[]

object ( CategoryBid )

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

CategoryBid

پیشنهادهای دسته‌بندی در LocalServicesReportingCampaignSettings.

نمایندگی JSON 
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
فیلدها
category Id

string

مقوله ای که مناقصه با آن همراه خواهد بود. به عنوان مثال، xcat:service_area_business_plumber.

manual Cpa Bid Micros

string ( int64 format)

پیشنهاد CPA دستی برای دسته. پیشنهاد باید بیشتر از قیمت رزرو مربوط به آن دسته باشد. ارزش بر حسب میکرو و واحد پول تبلیغ‌کننده است.

تنظیمات کمپین سفر

تنظیمات برای کمپین سفر.

نمایندگی JSON 
{
  "travelAccountId": string
}
فیلدها
travel Account Id

string ( int64 format)

تغییرناپذیر. شناسه حساب سفر مرتبط با کمپین سفر.

DemandGenCampaignSettings

تنظیمات برای کمپین تقاضای نسل.

نمایندگی JSON 
{
  "upgradedTargeting": boolean
}
فیلدها
upgraded Targeting

boolean

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

VideoCampaignSettings

تنظیمات کمپین ویدیویی

نمایندگی JSON 
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
فیلدها
video Ad Inventory Control

object ( VideoAdInventoryControl )

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

VideoAdInventoryControl

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

نمایندگی JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
فیلدها
allow In Stream

boolean

تعیین کنید که آیا VideoResponsiveAds را می توان برای تبلیغات ویدیویی در جریان استفاده کرد یا خیر.

allow In Feed

boolean

تعیین کنید که آیا VideoResponsiveAds را می توان برای تبلیغات ویدیویی درون فید استفاده کرد یا خیر.

allow Shorts

boolean

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

RealTime BiddingSetting

تنظیمات برای مناقصه بلادرنگ، ویژگی فقط برای کمپین هایی که شبکه Ad Exchange را هدف قرار می دهند.

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

boolean

اینکه آیا کمپین در مناقصه بی‌درنگ شرکت می‌کند یا خیر.

تنظیمات شبکه

تنظیمات شبکه برای کمپین

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

boolean

اینکه آیا تبلیغات در سایت‌های شریک در شبکه جستجوی Google ارائه می‌شوند یا نه (نیاز دارد تا targetGoogleSearch نیز true باشد).

target Content Network

boolean

اینکه آیا تبلیغات در مکان‌های مشخص شده در Google Display Network ارائه می‌شوند یا خیر. مکان ها با استفاده از معیار Placement مشخص می شوند.

target Partner Search Network

boolean

آیا تبلیغات در Google Partner Network ارائه خواهد شد یا خیر. این فقط برای برخی از حساب های منتخب شریک Google در دسترس است.

target Youtube

boolean

اینکه آیا تبلیغات در یوتیوب ارائه خواهد شد یا خیر.

target Google Tv Network

boolean

آیا تبلیغات در شبکه Google TV ارائه می شود یا خیر.

HotelSettingInfo

تنظیمات در سطح کمپین برای تبلیغات هتل.

نمایندگی JSON 
{
  "hotelCenterId": string
}
فیلدها
hotel Center Id

string ( int64 format)

تغییرناپذیر. حساب مرکز هتل پیوند شده.

DynamicSearchAdsSetting

تنظیم برای کنترل تبلیغات جستجوی پویا (DSA).

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

string

مورد نیاز. نام دامنه اینترنتی که این تنظیم نشان دهنده آن است، به عنوان مثال، "google.com" یا "www.google.com".

language Code

string

مورد نیاز. کد زبانی که زبان دامنه را مشخص می کند، به عنوان مثال، "en".

feeds[]

string

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

use Supplied Urls Only

boolean

اینکه آیا کمپین به طور انحصاری از URL های ارائه شده توسط تبلیغ کننده استفاده می کند.

ShoppingSetting

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

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

string

برچسب خوراک محصولات برای درج در کمپین. فقط یکی از feedLabel یا sales_country را می توان تنظیم کرد. اگر به جای sales_country استفاده شود، قسمت feedLabel کدهای کشور را در قالب یکسان می‌پذیرد، به عنوان مثال: «XX». در غیر این صورت می تواند هر رشته ای باشد که برای برچسب فید در Google Merchant Center استفاده می شود.

use Vehicle Inventory

boolean

تغییرناپذیر. آیا باید موجودی فهرست خودرو را هدف قرار دهیم. این فیلد فقط در کمپین های خرید هوشمند پشتیبانی می شود. برای تنظیم موجودی فهرست خودرو در کمپین‌های Performance Max، به جای آن از listingType استفاده کنید.

advertising Partner Ids[]

string ( int64 format)

تغییرناپذیر. شناسه حساب های تبلیغاتی شرکای تبلیغاتی که در کمپین همکاری می کنند.

merchant Id

string ( int64 format)

شناسه حساب Merchant Center. این فیلد برای ایجاد عملیات لازم است. این فیلد برای کمپین های خرید تغییرناپذیر است.

campaign Priority

integer

اولویت کمپین کمپین هایی با اولویت های عددی بالاتر بر کمپین هایی که اولویت های کمتری دارند اولویت دارند. این فیلد برای کمپین های خرید، با مقادیر بین 0 تا 2، شامل می شود. این فیلد برای کمپین های خرید هوشمند اختیاری است، اما در صورت تنظیم باید برابر با 3 باشد.

enable Local

boolean

آیا شامل محصولات محلی می شود.

disable Product Feed

boolean

فید محصول اختیاری را غیرفعال کنید. این فیلد در حال حاضر فقط برای کمپین‌های Demand Gen پشتیبانی می‌شود. برای کسب اطلاعات بیشتر در مورد این ویژگی به https://support.google.com/google-ads/answer/13721750 مراجعه کنید.

AudienceSetting

تنظیمات برای هدف گیری مخاطب

نمایندگی JSON 
{
  "useAudienceGrouped": boolean
}
فیلدها
use Audience Grouped

boolean

تغییرناپذیر. اگر درست باشد، این کمپین از یک منبع مخاطب برای هدف‌یابی مخاطبان استفاده می‌کند. اگر نادرست باشد، این کمپین ممکن است به جای آن از معیارهای بخش مخاطب استفاده کند.

GeoTargetTypeSetting

مجموعه ای از تنظیمات مربوط به هدف گذاری جغرافیایی تبلیغات را نشان می دهد.

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

enum ( PositiveGeoTargetType )

تنظیمات مورد استفاده برای هدف‌یابی جغرافیایی مثبت در این کمپین خاص.

negative Geo Target Type

enum ( NegativeGeoTargetType )

تنظیماتی که برای هدف‌گیری جغرافیایی منفی در این کمپین خاص استفاده می‌شود.

PositiveGeoTargetType

انواع هدف جغرافیایی مثبت احتمالی

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
PRESENCE_OR_INTEREST مشخص می‌کند که اگر کاربر در مکان‌های هدف تبلیغ‌کننده باشد، یا به آن علاقه نشان دهد، یک تبلیغ راه‌اندازی می‌شود.
SEARCH_INTEREST مشخص می‌کند که اگر کاربر مکان‌های هدف تبلیغ‌کننده را جستجو کند، یک تبلیغ فعال می‌شود. این فقط با کمپین‌های جستجو و خرید استاندارد قابل استفاده است.
PRESENCE مشخص می‌کند که اگر کاربر در مکان‌های هدف تبلیغ‌کننده باشد یا به طور مرتب در آن باشد، یک تبلیغ راه‌اندازی می‌شود.

NegativeGeoTargetType

انواع هدف جغرافیایی منفی احتمالی

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
PRESENCE_OR_INTEREST مشخص می‌کند که اگر کاربر در مکان‌های مستثنی شده تبلیغ‌کننده باشد یا به آن علاقه نشان دهد، از دیدن آگهی محروم می‌شود.
PRESENCE مشخص می‌کند که اگر کاربر در مکان‌های مستثنی شده تبلیغ‌کننده باشد، از دیدن آگهی محروم می‌شود.

LocalCampaignSetting

تنظیم کمپین برای کمپین های محلی.

نمایندگی JSON 
{
  "locationSourceType": enum (LocationSourceType)
}
فیلدها
location Source Type

enum ( LocationSourceType )

نوع منبع مکان برای این کمپین محلی.

LocationSourceType

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

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
GOOGLE_MY_BUSINESS مکان‌های مرتبط با نمایه کسب‌وکار مرتبط مشتری.
AFFILIATE مکان های فروشگاه های وابسته (زنجیره ای). به عنوان مثال، مکان های فروشگاه Best Buy.

AppCampaignSetting

تنظیمات سطح کمپین برای کمپین های برنامه.

نمایندگی JSON 
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
فیلدها
bidding Strategy Goal Type

enum ( AppCampaignBiddingStrategyGoalType )

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

app Store

enum ( AppCampaignAppStore )

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

app Id

string

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

AppCampaignBiddingStrategyGoalType

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST هدف خود را به حداکثر رساندن تعداد نصب برنامه. پیشنهاد cpa هزینه هدف در هر نصب است.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST به حداکثر رساندن تعداد بلندمدت تبدیل‌های درون‌برنامه‌ای انتخابی از نصب‌های برنامه بپردازید. پیشنهاد cpa هزینه هدف در هر نصب است.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST به حداکثر رساندن تعداد بلندمدت تبدیل‌های درون‌برنامه‌ای انتخابی از نصب‌های برنامه بپردازید. پیشنهاد cpa هزینه هدف برای هر تبدیل درون برنامه ای است. توجه داشته باشید که cpa واقعی ممکن است در ابتدا بالاتر از cpa هدف به نظر برسد، زیرا تبدیل‌های طولانی مدت هنوز اتفاق نیفتاده است.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND سعی کنید ارزش تمام تبدیل‌ها را به حداکثر برسانید، برای مثال، نصب + تبدیل‌های انتخابی درون برنامه‌ای را در حین دستیابی یا فراتر از بازده هدف در هزینه‌های تبلیغاتی نصب کنید.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME هدف این است که پیش ثبت نام برنامه را به حداکثر برسانید.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST به حداکثر رساندن نصب برنامه بدون هدف هزینه در هر نصب.

AppCampaignAppStore

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

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

CampaignExperimentType

نشان می دهد که آیا این کمپین یک کمپین معمولی، یک کمپین پیش نویس یا یک کمپین آزمایشی است.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
BASE این یک کمپین معمولی است.
DRAFT این نسخه پیش نویس یک کمپین است. تغییراتی از یک کمپین پایه دارد، اما معیارهایی را ارائه نمی دهد یا جمع آوری نمی کند.
EXPERIMENT این یک نسخه آزمایشی از یک کمپین است. تغییراتی از یک کمپین پایه دارد و درصدی از ترافیک از کمپین BASE به این کمپین آزمایشی منحرف می‌شود.

FrequencyCapEntry

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

نمایندگی JSON 
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
فیلدها
key

object ( FrequencyCapKey )

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

cap

integer

حداکثر تعداد رویدادهای مجاز در بازه زمانی توسط این سقف.

FrequencyCapKey

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

نمایندگی JSON 
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
فیلدها
level

enum ( FrequencyCapLevel )

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

event Type

enum ( FrequencyCapEventType )

نوع رویدادی که درپوش روی آن اعمال می‌شود (مثلاً تأثیرگذاری).

time Unit

enum ( FrequencyCapTimeUnit )

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

time Length

integer

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

FrequencyCapLevel

سطحی که قرار است سقف در آن اعمال شود (مثلاً آگهی گروه آگهی، گروه آگهی). Cap برای تمام منابع این سطح اعمال می شود.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AD_GROUP_AD این سقف در سطح تبلیغات گروه تبلیغاتی اعمال می شود.
AD_GROUP این سقف در سطح گروه تبلیغاتی اعمال می شود.
CAMPAIGN کلاهک در سطح کمپین اعمال می شود.

FrequencyCapEventType

نوع رویدادی که درپوش روی آن اعمال می‌شود (مثلاً تأثیرگذاری).

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
IMPRESSION این سقف روی نمایش تبلیغات اعمال می‌شود.
VIDEO_VIEW این سقف روی بازدیدهای تبلیغات ویدیویی اعمال می شود.

VanityPharma

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

نمایندگی JSON 
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
فیلدها
vanity Pharma Display Url Mode

enum ( VanityPharmaDisplayUrlMode )

حالت نمایش برای آدرس‌های اینترنتی داروی vanity.

vanity Pharma Text

enum ( VanityPharmaText )

متنی که در URL نمایشی آگهی متنی نمایش داده می‌شود، زمانی که توضیحات وب‌سایت حالت نمایش انتخاب‌شده برای نشانی‌های اینترنتی دارویی vanity باشد.

VanityPharmaDisplayUrlMode

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
MANUFACTURER_WEBSITE_URL آدرس اینترنتی داروسازی vanity را با آدرس وب سایت سازنده جایگزین کنید.
WEBSITE_DESCRIPTION آدرس اینترنتی داروسازی vanity را با توضیحات وب سایت جایگزین کنید.

VanityPharmaText

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
PRESCRIPTION_TREATMENT_WEBSITE_EN وب سایت نسخه درمانی با محتوای وب سایت به زبان انگلیسی.
PRESCRIPTION_TREATMENT_WEBSITE_ES وب سایت درمان نسخه با محتوای وب سایت به زبان اسپانیایی (Sitio de tratamientos con receta).
PRESCRIPTION_DEVICE_WEBSITE_EN وب سایت دستگاه نسخه با محتوای وب سایت به زبان انگلیسی.
PRESCRIPTION_DEVICE_WEBSITE_ES وب سایت دستگاه نسخه با محتوای وب سایت به زبان اسپانیایی (Sitio de dispositivos con receta).
MEDICAL_DEVICE_WEBSITE_EN وب سایت تجهیزات پزشکی با محتوای وب سایت به زبان انگلیسی.
MEDICAL_DEVICE_WEBSITE_ES وب سایت دستگاه های پزشکی با محتوای وب سایت به زبان اسپانیایی (Sitio de dispositivos médicos).
PREVENTATIVE_TREATMENT_WEBSITE_EN وب سایت درمان پیشگیرانه با محتوای وب سایت به زبان انگلیسی.
PREVENTATIVE_TREATMENT_WEBSITE_ES وب سایت درمان پیشگیرانه با محتوای وب سایت به زبان اسپانیایی (Sitio de tratamientos preventivos).
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN وب سایت پیشگیری از بارداری نسخه با محتوای وب سایت به زبان انگلیسی.
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES وب سایت پیشگیری از بارداری نسخه با محتوای وب سایت به زبان اسپانیایی (Sitio de anticonceptivos con receta).
PRESCRIPTION_VACCINE_WEBSITE_EN وب سایت نسخه واکسن با محتوای وب سایت به زبان انگلیسی.
PRESCRIPTION_VACCINE_WEBSITE_ES وب سایت واکسن نسخه ای با محتوای وب سایت به زبان اسپانیایی (Sitio de vacunas con receta).

بهینه سازی انتخابی

تنظیمات بهینه‌سازی انتخابی برای این کمپین، که شامل مجموعه‌ای از اقدامات تبدیلی برای بهینه‌سازی این کمپین است. این ویژگی فقط برای کمپین های برنامه ای اعمال می شود که از MULTI_CHANNEL به عنوان AdvertisingChannelType و APP_CAMPAIGN یا APP_CAMPAIGN_FOR_ENGAGEMENT به عنوان AdvertisingChannelSubType استفاده می کنند.

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

string

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

OptimizationGoalSetting

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

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

enum ( OptimizationGoalType )

فهرست انواع اهداف بهینه سازی

OptimizationGoalType

نوع هدف بهینه سازی

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط به عنوان مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
CALL_CLICKS بهینه سازی برای کلیک های تماس تبدیل کلیک بر تماس زمانی است که افراد پس از مشاهده آگهی، «تماس» را برای تماس با فروشگاه انتخاب می‌کنند.
DRIVING_DIRECTIONS برای مسیرهای رانندگی بهینه سازی کنید. تبدیل مسیرهای رانندگی زمانی است که افراد پس از مشاهده آگهی، «دریافت مسیرها» را برای رفتن به فروشگاه انتخاب می‌کنند.
APP_PRE_REGISTRATION بهینه سازی برای پیش ثبت نام. تبدیل های پیش ثبت نام تعداد ثبت نام های پیش ثبت نام برای دریافت اعلان هنگام انتشار برنامه است.

TrackingSetting

تنظیمات در سطح کمپین برای ردیابی اطلاعات.

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

string

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

حالت پرداخت

Enum که حالت‌های پرداخت احتمالی را توصیف می‌کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
CLICKS پرداخت به ازای هر تعامل
CONVERSION_VALUE پرداخت به ازای ارزش تبدیل این حالت فقط توسط کمپین هایی با AdvertisingChannelType.HOTEL، BiddingStrategyType.COMMISSION، و BudgetType.STANDARD پشتیبانی می شود.
CONVERSIONS پرداخت به ازای هر تبدیل این حالت فقط توسط کمپین هایی با AdvertisingChannelType.DISPLAY (به استثنای AdvertisingChannelSubType.DISPLAY_GMAIL)، BiddingStrategyType.TARGET_CPA و BudgetType.FIXED_CPA پشتیبانی می شود. مشتری نیز باید واجد شرایط این حالت باشد. برای جزئیات به Customer.eligibility_failure_reasons مراجعه کنید.
GUEST_STAY پرداخت به ازای ارزش اقامت مهمان این حالت فقط توسط کمپین هایی با AdvertisingChannelType.HOTEL، BiddingStrategyType.COMMISSION، و BudgetType.STANDARD پشتیبانی می شود.

PerformanceMaxUpgrade

اطلاعاتی درباره کمپین در حال ارتقاء به Performance Max.

نمایندگی JSON 
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
فیلدها
performance Max Campaign

string

فقط خروجی نام منبع کمپین Performance Max که کمپین به آن ارتقا یافته است.

pre Upgrade Campaign

string

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

status

enum ( PerformanceMaxUpgradeStatus )

فقط خروجی وضعیت ارتقاء کمپین درخواستی برای ارتقاء به حداکثر عملکرد.

PerformanceMaxUpgradeStatus

حداکثر عملکرد شماره وضعیت ارتقاء برای کمپین.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
UPGRADE_IN_PROGRESS ارتقاء به کمپین Performance Max در حال انجام است.
UPGRADE_COMPLETE ارتقاء به کمپین Performance Max کامل شده است.
UPGRADE_FAILED ارتقاء به کمپین Performance Max ناموفق بود. کمپین همچنان مانند قبل از انجام ارتقاء عمل خواهد کرد.
UPGRADE_ELIGIBLE این کمپین واجد شرایط ارتقاء به کمپین حداکثر عملکرد است.

نوع لیست

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
VEHICLES این کمپین تبلیغات وسایل نقلیه را ارائه می دهد.

AssetAutomationSetting

تنظیمات اتوماسیون دارایی شامل یک جفت AssetAutomationType و وضعیت انتخاب و خروج اتوماسیون دارایی است.

نمایندگی JSON 
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
فیلدها
asset Automation Type

enum ( AssetAutomationType )

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

asset Automation Status

enum ( AssetAutomationStatus )

وضعیت انتخاب و خروج از نوع اتوماسیون دارایی.

AssetAutomationType

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

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

AssetAutomationStatus

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط به عنوان مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
OPTED_IN انتخاب کردن، تولید و ارائه یک نوع اتوماسیون دارایی را فعال می کند.
OPTED_OUT انصراف، تولید و ارائه یک نوع اتوماسیون دارایی را متوقف می کند.

CampaignKeywordMatchType

Enum که نوع تطبیق کلمه کلیدی کمپین را توصیف می کند.

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

کمیسیون

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

نمایندگی JSON 
{
  "commissionRateMicros": string
}
فیلدها
commission Rate Micros

string ( int64 format)

نرخ کمیسیون، بخشی از ارزش تبدیلی را که آگهی‌دهنده برای آن صورت‌حساب می‌شود، مشخص می‌کند. نرخ کمیسیون x باید به عنوان (x * 1,000,000) به این قسمت منتقل شود. به عنوان مثال، 106000 نشان دهنده نرخ کمیسیون 0.106 (10.6٪) است.

ManualCpa

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

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

ManualCpc

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

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

boolean

اینکه آیا پیشنهادها قرار است بر اساس داده‌های بهینه‌ساز تبدیل افزایش یابد یا خیر.

ManualCpm

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

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

ManualCpv

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

مناقصه مبتنی بر مشاهده که در آن کاربر به ازای هر مشاهده ویدیو هزینه می‌پردازد.

درصد Cpc

یک استراتژی مناقصه که در آن پیشنهادها کسری از قیمت آگهی شده برای برخی کالاها یا خدمات است.

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

string ( int64 format)

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

enhanced Cpc Enabled

boolean

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

TargetCpm

CPM هدف (هزینه به ازای هر هزار نمایش) یک استراتژی مناقصه خودکار است که با توجه به CPM هدفی که تعیین کرده‌اید، قیمت‌ها را برای بهینه‌سازی عملکرد تنظیم می‌کند.

نمایندگی JSON 
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
فیلدها
goal زمین اتحادیه . اطلاعات اضافی مربوط به هدف مناقصه. goal فقط می تواند یکی از موارد زیر باشد:
target Frequency Goal

object ( TargetCpmTargetFrequencyGoal )

جزئیات هدف مناقصه فرکانس هدف.

TargetCpmTargetFrequencyGoal

جزئیات هدف مناقصه فرکانس هدف.

نمایندگی JSON 
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
فیلدها
target Count

string ( int64 format)

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

time Unit

enum ( TargetFrequencyTimeUnit )

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

ثابت Cpm

استراتژی مناقصه CPM ثابت (هزینه در هزار نمایش). یک استراتژی مناقصه دستی با CPM ثابت.

نمایندگی JSON 
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
فیلدها
goal

enum ( FixedCpmGoal )

هدف پیشنهادی CPM ثابت. پارامترهای بهینه سازی قیمت پیشنهادی دقیق را تعیین می کند.

goal_info زمین اتحادیه . اطلاعات اضافی مربوط به هدف مناقصه. goal_info می تواند تنها یکی از موارد زیر باشد:
target Frequency Info

object ( FixedCpmTargetFrequencyGoalInfo )

جزئیات هدف پیشنهادی فرکانس هدف.

ثابت

enum توصیف هدف استراتژی پیشنهادی CPM ثابت.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
REACH حداکثر دسترسی ، این تعداد کاربرانی است که در این کمپین تبلیغات را دیدند.
TARGET_FREQUENCY پیشنهاد دهنده CPM فرکانس هدف. مناقصه را برای رسیدن به یک کاربر واحد با فرکانس درخواست شده بهینه کنید.

fixtioncpmtargetFrequencyGoalInfo

جزئیات پیشنهادی فرکانس هدف برای استراتژی پیشنهادی CPM ثابت. فقط اگر هدف از استراتژی مناقصه TARGET_FREQUENCY باشد ، مرتبط است.

نمایندگی JSON 
{
  "targetCount": string,
  "timeUnit": enum (FixedCpmTargetFrequencyTimeUnit)
}
فیلدها
target Count

string ( int64 format)

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

time Unit

enum ( FixedCpmTargetFrequencyTimeUnit )

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

fixedcpmtargetFrequencyTimeUnit

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
MONTHLY برای رسیدن به فرکانس هدف در 30 روز ، مناقصه را بهینه کنید.

TargetCPV

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

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