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)
  },
  "discoveryCampaignSettings": {
    object (DiscoveryCampaignSettings)
  },
  "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)
    }
  ],
  "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)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
زمینه های
resourceName

string

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

customers/{customerId}/campaigns/{campaignId}

primaryStatus

enum ( CampaignPrimaryStatus )

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

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

primaryStatusReasons[]

enum ( CampaignPrimaryStatusReason )

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

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

status

enum ( CampaignStatus )

وضعیت کمپین

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

servingStatus

enum ( CampaignServingStatus )

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

biddingStrategySystemStatus

enum ( BiddingStrategySystemStatus )

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

adServingOptimizationStatus

enum ( AdServingOptimizationStatus )

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

advertisingChannelType

enum ( AdvertisingChannelType )

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

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

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

advertisingChannelSubType

enum ( AdvertisingChannelSubType )

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

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

urlCustomParameters[]

object ( CustomParameter )

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

localServicesCampaignSettings

object ( LocalServicesCampaignSettings )

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

travelCampaignSettings

object ( TravelCampaignSettings )

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

discoveryCampaignSettings

object ( DiscoveryCampaignSettings )

تنظیمات برای کمپین Discovery.

realTimeBiddingSetting

object ( RealTimeBiddingSetting )

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

networkSettings

object ( NetworkSettings )

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

hotelSetting

object ( HotelSettingInfo )

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

dynamicSearchAdsSetting

object ( DynamicSearchAdsSetting )

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

shoppingSetting

object ( ShoppingSetting )

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

targetingSetting

object ( TargetingSetting )

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

geoTargetTypeSetting

object ( GeoTargetTypeSetting )

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

localCampaignSetting

object ( LocalCampaignSetting )

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

appCampaignSetting

object ( AppCampaignSetting )

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

labels[]

string

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

experimentType

enum ( CampaignExperimentType )

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

biddingStrategyType

enum ( BiddingStrategyType )

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

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

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

accessibleBiddingStrategy

string

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

frequencyCaps[]

object ( FrequencyCapEntry )

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

videoBrandSafetySuitability

enum ( BrandSafetySuitability )

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

vanityPharma

object ( VanityPharma )

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

selectiveOptimization

object ( SelectiveOptimization )

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

optimizationGoalSetting

object ( OptimizationGoalSetting )

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

trackingSetting

object ( TrackingSetting )

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

paymentMode

enum ( PaymentMode )

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

excludedParentAssetFieldTypes[]

enum ( AssetFieldType )

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

excludedParentAssetSetTypes[]

enum ( AssetSetType )

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

performanceMaxUpgrade

object ( PerformanceMaxUpgrade )

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

assetAutomationSettings[]

object ( AssetAutomationSetting )

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

id

string ( int64 format)

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

name

string

نام کمپین.

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

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

trackingUrlTemplate

string

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

audienceSetting

object ( AudienceSetting )

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

baseCampaign

string

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

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

campaignBudget

string

بودجه کمپین

startDate

string

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

campaignGroup

string

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

endDate

string

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

finalUrlSuffix

string

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

optimizationScore

number

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

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

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

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

urlExpansionOptOut

boolean

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

hotelPropertyAssetSet

string

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

listingType

enum ( ListingType )

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

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

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

biddingStrategy

string

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

commission

object ( Commission )

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

manualCpa

object ( ManualCpa )

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

manualCpc

object ( ManualCpc )

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

manualCpm

object ( ManualCpm )

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

manualCpv

object ( ManualCpv )

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

maximizeConversions

object ( MaximizeConversions )

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

maximizeConversionValue

object ( MaximizeConversionValue )

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

targetCpa

object ( TargetCpa )

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

targetImpressionShare

object ( TargetImpressionShare )

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

targetRoas

object ( TargetRoas )

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

targetSpend

object ( TargetSpend )

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

percentCpc

object ( PercentCpc )

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

targetCpm

object ( TargetCpm )

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

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

object ( CategoryBid )

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

CategoryBid

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

نمایندگی JSON
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
زمینه های
categoryId

string

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

manualCpaBidMicros

string ( int64 format)

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

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

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

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

string ( int64 format)

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

DiscoveryCampaignSettings

تنظیمات برای کمپین Discovery.

نمایندگی JSON
{
  "upgradedTargeting": boolean
}
زمینه های
upgradedTargeting

boolean

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

RealTime BiddingSetting

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

نمایندگی JSON
{
  "optIn": boolean
}
زمینه های
optIn

boolean

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

تنظیمات شبکه

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

نمایندگی JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
زمینه های
targetSearchNetwork

boolean

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

targetContentNetwork

boolean

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

targetPartnerSearchNetwork

boolean

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

targetYoutube

boolean

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

targetGoogleTvNetwork

boolean

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

HotelSettingInfo

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

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

string ( int64 format)

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

DynamicSearchAdsSetting

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

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

string

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

languageCode

string

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

feeds[]

string

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

useSuppliedUrlsOnly

boolean

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

ShoppingSetting

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

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

string

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

useVehicleInventory

boolean

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

advertisingPartnerIds[]

string ( int64 format)

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

merchantId

string ( int64 format)

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

campaignPriority

integer

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

enableLocal

boolean

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

AudienceSetting

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

نمایندگی JSON
{
  "useAudienceGrouped": boolean
}
زمینه های
useAudienceGrouped

boolean

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

GeoTargetTypeSetting

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

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

enum ( PositiveGeoTargetType )

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

negativeGeoTargetType

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

enum ( LocationSourceType )

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

LocationSourceType

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

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

AppCampaignSetting

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

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

enum ( AppCampaignBiddingStrategyGoalType )

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

appStore

enum ( AppCampaignAppStore )

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

appId

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 )

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

eventType

enum ( FrequencyCapEventType )

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

timeUnit

enum ( FrequencyCapTimeUnit )

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

timeLength

integer

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

FrequencyCapLevel

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

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

FrequencyCapEventType

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

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

ایمنی نام تجاری مناسب بودن

کنترل مناسب ایمنی برند 3-لایه.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
EXPANDED_INVENTORY این گزینه به شما امکان می‌دهد تبلیغات را در تمام موجودی موجود در YouTube و شرکای ویدیویی نشان دهید که با استانداردهای ما برای کسب درآمد مطابقت دارند. این گزینه ممکن است انتخاب مناسبی برای مارک‌هایی باشد که خواهان حداکثر دسترسی به وسعت کامل ویدیوهای واجد شرایط برای تبلیغات هستند، از جمله، برای مثال، ویدیوهایی که دارای ناسزای شدید در زمینه کمدی یا مستند هستند، یا خشونت بیش از حد که در بازی‌های ویدیویی نشان داده می‌شود. .
STANDARD_INVENTORY این گزینه به شما امکان می‌دهد تبلیغات را در طیف گسترده‌ای از محتوا که برای اکثر برندها مناسب است، مانند موزیک ویدیوهای محبوب، مستندها و تریلرهای فیلم، نشان دهید. محتوایی که می‌توانید روی آن تبلیغات نشان دهید براساس دستورالعمل‌های محتوای آگهی‌دهنده YouTube است که به‌عنوان مثال، شدت یا فراوانی ناسزاگویی یا مناسب بودن موضوعی مانند رویدادهای حساس را در نظر می‌گیرد. برای مثال، تبلیغات در محتوایی با فحاشی شدید مکرر، محتوای جنسی شدید یا خشونت تصویری نشان داده نمی‌شود.
LIMITED_INVENTORY این گزینه به شما امکان می‌دهد تبلیغاتی را در محدوده‌ای از محتوا نشان دهید که برای مارک‌ها مناسب است و دستورالعمل‌های سختگیرانه‌ای در مورد زبان نامناسب و وسوسه‌های جنسی دارد. بالاتر و فراتر از آنچه دستورالعمل محتوای آگهی‌دهنده YouTube به آن اشاره می‌کند. ویدئوهایی که در این دسته حساس قابل دسترسی هستند، نیازهای شدیدتری دارند، به ویژه برای زبان نامناسب و تلقین جنسی. به عنوان مثال، تبلیغات شما از نمایش در برخی از محبوب ترین ویدیوهای موسیقی YouTube و سایر محتوای فرهنگ پاپ در سراسر YouTube و شرکای ویدیویی Google حذف می شود.

VanityPharma

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

نمایندگی JSON
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
زمینه های
vanityPharmaDisplayUrlMode

enum ( VanityPharmaDisplayUrlMode )

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

vanityPharmaText

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

string

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

OptimizationGoalSetting

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

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

enum ( OptimizationGoalType )

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

OptimizationGoalType

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

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

TrackingSetting

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

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

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

string

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

preUpgradeCampaign

string

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

status

enum ( PerformanceMaxUpgradeStatus )

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

PerformanceMaxUpgradeStatus

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

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

فهرست لیست

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

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

دارایی

تنظیم اتوماسیون دارایی شامل جفت AssetAutomationType و وضعیت Opt-in/Out Asset Automation است

نمایندگی JSON
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
زمینه های
assetAutomationType

enum ( AssetAutomationType )

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

assetAutomationStatus

enum ( AssetAutomationStatus )

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

دارایی

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

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

دارایی

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

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

کمیسیون

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

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

string ( int64 format)

نرخ کمیسیون بخشی از ارزش تبدیل را که تبلیغ کننده صورتحساب می شود ، تعریف می کند. نرخ کمیسیون X باید به عنوان (X * 1،000،000) به این زمینه منتقل شود. به عنوان مثال ، 106،000 نشان دهنده نرخ کمیسیون 0.106 (10.6 ٪) است.

manualcpa

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

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

manualcpc

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

نمایندگی JSON
{
  "enhancedCpcEnabled": boolean
}
زمینه های
enhancedCpcEnabled

boolean

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

manualcpm

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

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

manualcpv

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

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

درصد درصد

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

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

string ( int64 format)

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

enhancedCpcEnabled

boolean

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

TargetCPM

CPM Target (هزینه در هر هزار برداشت) یک استراتژی پیشنهادی خودکار است که با توجه به 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 فقط می تواند یکی از موارد زیر باشد:
targetFrequencyGoal

object ( TargetCpmTargetFrequencyGoal )

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

TargetCPMTargetFrequencyGoal

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

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

string ( int64 format)

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

timeUnit

enum ( TargetFrequencyTimeUnit )

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