BiddingStrategy

تنظیماتی که استراتژی پیشنهاد قیمت را کنترل می‌کنند. استراتژی پیشنهاد قیمت، قیمت پیشنهادی را تعیین می‌کند.

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of mutually exclusive fields.
}
فیلدها
الزامی. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
fixedBid

object (FixedBidStrategy)

استراتژی‌ای که از قیمت پیشنهادی ثابت استفاده می‌کند.
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

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

در سطح سفارش درج، markupType موارد سطری را نمی‌توان روی PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM تنظیم کرد.

علاوه‌براین، مقدار performanceGoalType اختصاص‌داده‌شده به سفارش درج، مقادیر lineItemType ممکن را که برای موارد خطی تحت آن سفارش درج دردسترس است تعیین می‌کند:

  • ‫BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA، BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC، و BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED فقط برای LINE_ITEM_TYPE_DISPLAY_DEFAULT یا LINE_ITEM_TYPE_VIDEO_DEFAULT ردیف‌های هدف مجاز هستند.
  • ‫BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA و BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN فقط برای LINE_ITEM_TYPE_VIDEO_DEFAULT ردیف مجاز است.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH فقط LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP مورد خطی را مجاز می‌کند.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

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

object (YoutubeAndPartnersBiddingStrategy)

استراتژی پیشنهاد قیمتی که منابع YouTube و «شرکا» از آن استفاده می‌کنند.

فقط برای ردیف YouTube و شرکا یا نهاد گروه آگهی قابل‌استفاده است.
demandGenBid

object (DemandGenBiddingStrategy)

استراتژی پیشنهاد قیمتی که منابع «تولید تقاضا» استفاده می‌کنند.

فقط برای ردیف یا نهاد گروه آگهی «تولید تقاضا» می‌توان از آن استفاده کرد.
پایان فیلدهای متقابلاً انحصاری.

FixedBidStrategy

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

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

string (int64 format)

مقدار پیشنهاد قیمت ثابت، به میکرو واحد پول تبلیغ‌کننده. برای نهاد سفارش درج، bidAmountMicros باید روی ۰ تنظیم شود. برای نهاد ردیف آگهی، bidAmountMicros باید بزرگ‌تر یا مساوی با واحد قابل‌صورت‌حساب ارز داده‌شده و کوچک‌تر یا مساوی با حد بالای ۱۰۰۰۰۰۰۰۰۰ باشد.

برای مثال، ۱۵۰۰۰۰۰ نشان‌دهنده ۱٫۵ واحد استاندارد از ارز است.

MaximizeSpendBidStrategy

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

نمایش JSON 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
فیلدها
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

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

string (int64 format)

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

برای مثال، ۱۵۰۰۰۰۰ نشان‌دهنده ۱٫۵ واحد استاندارد از ارز است.
raiseBidForDeals

boolean

اینکه آیا استراتژی قیمت‌های کف معامله را درنظر می‌گیرد یا نه.
customBiddingAlgorithmId

string (int64 format)

شناسه «الگوریتم پیشنهاد قیمت سفارشی» که این استراتژی از آن استفاده می‌کند. فقط زمانی قابل‌اعمال است که performanceGoalType روی BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO تنظیم شده باشد.

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

BiddingStrategyPerformanceGoalType

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

شمارشی‌ها
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED مقدار نوع مشخص نشده است یا در این نسخه ناشناخته است.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA کنش‌بها.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC کلیک‌بها.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM هزارظهوربهای مشاهده‌شدنی.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO الگوریتم پیشنهاد قیمت دادن سفارشی.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA بازدیدهای کامل‌شده آگهی درونی دیداری و شنیداری.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN زمان مشاهده بیش‌از ۱۰ ثانیه بازدید.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ظهورهای قابل‌مشاهده.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH دسترسی را بیشینه کنید.

PerformanceGoalBidStrategy

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

نمایش JSON 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
فیلدها
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

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

برای استفاده در سطح ردیف، مقدار باید یکی از موارد زیر باشد:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.
performanceGoalAmountMicros

string (int64 format)

الزامی. هدف عملکردی که راهبرد پیشنهاد قیمت تلاش می‌کند به آن برسد یا از آن فراتر رود، به میکرو واحد پول تبلیغ‌کننده یا به میکرو مقدار «برگشت هزینه‌های تبلیغات» (ROAS) که آن هم براساس واحد پول تبلیغ‌کننده است. باید بزرگ‌تر یا مساوی با واحد قابل‌صورت‌حساب ارز داده‌شده و کوچک‌تر یا مساوی با حدود بالایی باشد. هر performanceGoalType کران بالای خود را دارد:

  • وقتی performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA است، حد بالا ۱۰۰۰۰٫۰۰ دلار امریکا است.
  • وقتی performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC است، حد بالا ۱۰۰۰٫۰۰ دلار امریکا است.
  • وقتی performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM است، حد بالا ۱۰۰۰٫۰۰ دلار امریکا است.
  • وقتی performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO است، حد بالا ۱۰۰۰٫۰۰ و حد پایین ۰٫۰۱ است.

مثال: اگر روی BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM تنظیم شود، قیمت پیشنهادی براساس احتمال قابل‌مشاهده بودن هر ظهور موجود خواهد بود. برای مثال، اگر هدف هزارظهوربهای مشاهده‌شدنی ۲ دلار باشد و احتمال مشاهده‌شدنی بودن ظهور ۴۰٪ باشد، قیمت پیشنهادی ۰٫۸۰ دلار هزارظهوربها (۴۰٪ از ۲ دلار) خواهد بود.

برای مثال، ۱۵۰۰۰۰۰ نشان‌دهنده ۱٫۵ واحد استاندارد از واحد پول یا مقدار «برگشت هزینه‌های تبلیغات» است.
maxAverageCpmBidAmountMicros

string (int64 format)

حداکثر هزارظهوربهای میانگین که ممکن است پیشنهاد شود، به میکرو واحد پول تبلیغ‌کننده. باید بزرگ‌تر یا مساوی با واحد قابل‌صورت‌حساب ارز داده‌شده باشد. وقتی performanceGoalType روی BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM تنظیم شده باشد، قابل‌اجرا نیست.

برای مثال، ۱۵۰۰۰۰۰ نشان‌دهنده ۱٫۵ واحد استاندارد از ارز است.
customBiddingAlgorithmId

string (int64 format)

شناسه «الگوریتم پیشنهاد قیمت سفارشی» که این استراتژی از آن استفاده می‌کند. فقط زمانی قابل‌اعمال است که performanceGoalType روی BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO تنظیم شده باشد.

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

YoutubeAndPartnersBiddingStrategy

تنظیماتی که استراتژی پیشنهاد قیمت را برای منابع YouTube و «شرکا» کنترل می‌کند.

نمایش JSON 
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
فیلدها
type

enum (YoutubeAndPartnersBiddingStrategyType)

نوع استراتژی پیشنهاد قیمت.
value

string (int64 format)

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

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

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

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

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

اگر از استراتژی قابل‌اجرا استفاده نمی‌کنید، مقدار این فیلد ۰ خواهد بود.
adGroupEffectiveTargetCpaValue

string (int64 format)

فقط خروجی. کنش‌بهای هدف مؤثر برای گروه آگهی، به میکرو واحد پول تبلیغ‌کننده.
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

فقط خروجی. منبع مقدار کنش‌بهای هدف مؤثر برای گروه آگهی.

YoutubeAndPartnersBiddingStrategyType

انواع ممکن استراتژی پیشنهاد قیمت برای منابع YouTube و «شرکا».

شمارشی‌ها
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED نوع مشخص نشده یا ناشناخته است.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV استراتژی پیشنهاد قیمت که مبلغ قابل‌پیکربندی را به‌ازای هر بازدید ویدیو پرداخت می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM استراتژی پیشنهاد قیمتی که مبلغ قابل‌پیکربندی را به‌ازای هر ظهور پرداخت می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA استراتژی پیشنهاد قیمت که به‌طور خودکار تبدیل‌ها را به‌ازای هر دلار بهینه‌سازی می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM استراتژی پیشنهاد قیمت که مبلغ قابل‌پیکربندی را برای هر ظهور پرداخت می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM استراتژی پیشنهاد قیمت برای موارد سطری «رزرو فوری YouTube» که مبلغ ثابتی را به‌ازای هر ظهور پرداخت می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT استراتژی پیشنهاد قیمت خودکار که قیمت‌های پیشنهادی را برای دستیابی به بیشترین بهینه‌گر تنظیم می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS استراتژی پیشنهاد قیمت که به‌طور خودکار تعداد تبدیل‌ها را با توجه به بودجه روزانه بیشینه می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV استراتژی پیشنهاد قیمت که به‌طور خودکار هزینه هر بازدید ویدیو را بهینه‌سازی می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS استراتژی پیشنهاد قیمت که به‌طور خودکار درآمد را بیشینه می‌کند و درعین‌حال میانگین «برگشت هزینه‌های تبلیغات هدف» (ROAS) خاصی را حفظ می‌کند.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE استراتژی پیشنهاد قیمت که به‌طور خودکار پیشنهاد قیمت‌ها را برای بیشینه‌سازی درآمد در چارچوب بودجه شما تنظیم می‌کند.

BiddingSource

منبع مقدار پیشنهاد قیمت.

شمارشی‌ها
BIDDING_SOURCE_UNSPECIFIED منبع پیشنهاد قیمت مشخص نشده یا ناشناخته است.
BIDDING_SOURCE_LINE_ITEM مقدار پیشنهاد قیمت از مورد خطی گرفته شده است.
BIDDING_SOURCE_AD_GROUP مقدار پیشنهاد قیمت در گروه آگهی تعریف شده است.

DemandGenBiddingStrategy

تنظیماتی که استراتژی پیشنهاد قیمت را برای منابع «تولید تقاضا» کنترل می‌کند.

نمایش JSON 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
فیلدها
type

enum (DemandGenBiddingStrategyType)

اختیاری. نوع استراتژی پیشنهاد قیمت.

این مورد فقط زمانی می‌تواند تنظیم شود که به یک ردیف اختصاص داده شده باشد. گروه‌های آگهی این مقدار را از ردیف هدفشان به ارث می‌برند.
value

string (int64 format)

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

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

مقدار این فیلد به میکرو واحد پول تبلیغ‌کننده یا مقدار ROAS است. برای مثال، ۱۰۰۰۰۰۰ نشان‌دهنده ۱٫۰ واحد استاندارد ارز یا ‎٪۱۰۰ مقدار «برگشت هزینه‌های تبلیغات» است. اگر از استراتژی قابل‌اجرا استفاده نمی‌کنید، مقدار این فیلد ۰ خواهد بود.
effectiveBiddingValue

string (int64 format)

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

اگر type DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA یا DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS نباشد، این فیلد ۰ خواهد بود.
effectiveBiddingValueSource

enum (BiddingSource)

فقط خروجی. منبع مقدار پیشنهاد قیمت مؤثر.

DemandGenBiddingStrategyType

انواع ممکن استراتژی پیشنهاد قیمت برای منابع «تولید تقاضا».

شمارشی‌ها
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED نوع مشخص نشده یا ناشناخته است.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA استراتژی پیشنهاد قیمت که به‌طور خودکار تبدیل‌ها را به‌ازای هر دلار بهینه‌سازی می‌کند.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS استراتژی پیشنهاد قیمت که به‌طور خودکار درآمد را بیشینه می‌کند و درعین‌حال میانگین «برگشت هزینه‌های تبلیغات هدف» (ROAS) خاصی را حفظ می‌کند.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS استراتژی پیشنهاد قیمت که به‌طور خودکار تعداد تبدیل‌ها را بیشینه می‌کند
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE استراتژی پیشنهاد قیمتی که به‌طور خودکار درآمد را بیشینه می‌کند و درعین‌حال بودجه شما را صرف می‌کند.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS استراتژی پیشنهاد قیمت که به‌طور خودکار کلیک‌ها را در چارچوب بودجه مشخص‌شده بیشینه می‌کند.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC استراتژی پیشنهاد قیمت که به‌طور خودکار کلیک‌بها را بهینه‌سازی می‌کند.