BiddingStrategy

הגדרות שקובעות את שיטת הבידינג. שיטת הבידינג קובעת את מחיר הצעת המחיר.

ייצוג JSON 
{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}
שדות
שדה איחוד bid_strategy_scheme. חובה. bid_strategy_scheme יכול להיות רק אחת מהאפשרויות הבאות:
fixedBid

object (FixedBidStrategy)

שיטה שמוגדרת בה הצעת מחיר קבועה.
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

שיטה שמתאימה את הצעת המחיר באופן אוטומטי כדי לבצע אופטימיזציה להשגת יעד הביצועים שהגדרתם, תוך ניצול התקציב במלואו.

ברמה של הזמנת הקמפיין, לא ניתן להגדיר את markupType של הפריטים כ-PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM. בנוסף, אם performanceGoalType הוא אחד מהתנאים הבאים:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ,

השדה lineItemType של הפריטים בהזמנת הקמפיין חייב להיות:

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT ,

וכשהפרמטר performanceGoalType הוא:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

הערך lineItemType של הפריטים בהזמנת הקמפיין חייב להיות LINE_ITEM_TYPE_VIDEO_DEFAULT.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

שיטה שמתאימה באופן אוטומטי את הצעת המחיר כדי לעמוד ביעד ביצועים מסוים או לעבור אותו. הוא מיועד לשימוש רק בישות של פריט.

FixedBidStrategy

שיטה שמבוססת על מחיר קבוע לבידינג.

ייצוג JSON 
{
  "bidAmountMicros": string
}
שדות
bidAmountMicros

string (int64 format)

סכום הצעת המחיר הקבוע, במיליוניות השנייה של מטבע המפרסם. בישות של הזמנת קמפיין, יש להגדיר את bidAmountMicros כ-0. בישות פריט, bidAmountMicros חייב להיות גדול מהערך או שווה ליחידה הניתנת לחיוב של המטבע הנתון, וקטן מהמגבלה העליונה 1000000000 או שווה לה.

לדוגמה, המספר 1500,000 מייצג 1.5 יחידות רגילות של המטבע.

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)

העלות המקסימלית לאלף חשיפות הממוצעת שאפשר להציע, במיליוניות השנייה של מטבע המפרסם. הערך חייב להיות שווה ליחידה שניתנת לחיוב של המטבע הנתון, או גדול ממנה.

לדוגמה, המספר 1500,000 מייצג 1.5 יחידות רגילות של המטבע.
raiseBidForDeals

boolean

האם האסטרטגיה משקללת מחירי מינימום לעסקאות.
customBiddingAlgorithmId

string (int64 format)

המזהה של האלגוריתם של הצעות המחיר המותאמות אישית שבו נעשה שימוש בשיטה הזו. רלוונטי רק כאשר בשדה performanceGoalType מוגדר הערך BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

BiddingStrategyPerformanceGoalType

סוגים אפשריים של יעדי ביצועים לשיטות בידינג.

טיפוסים בני מנייה (enum)
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 זמן צפייה – יותר מ-10 שניות.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED חשיפות שניתנות לצפייה.

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, הגבול העליון הוא 10000.00 USD.
  • כשהערך של performanceGoalType הוא BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, הגבול העליון הוא 4,000.00 ILS.
  • כשהערך של performanceGoalType הוא BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, הגבול העליון הוא 4,000.00 ILS.
  • כאשר performanceGoalType הוא BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, הגבול העליון הוא 1000.00 והגבול התחתון הוא 0.01.

דוגמה: אם מגדירים את הערך BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, מחיר הצעת המחיר יתבסס על הסבירות שכל חשיפה זמינה תהיה ניתנת לצפייה. לדוגמה, אם יעד העלות לאלף חשיפות הניתנות לצפייה הוא 8 ש"ח ויש סבירות של 40% שחשיפה מסוימת תהיה ניתנת לצפייה, מחיר הצעת המחיר יהיה 3.20 ש"ח לאלף חשיפות (40% מ-8 ש"ח).

לדוגמה, המספר 1500,000 מייצג 1.5 יחידות רגילות של המטבע או של ערך ה-ROAS.
maxAverageCpmBidAmountMicros

string (int64 format)

העלות המקסימלית לאלף חשיפות הממוצעת שאפשר להציע, במיליוניות השנייה של מטבע המפרסם. הערך חייב להיות שווה ליחידה שניתנת לחיוב של המטבע הנתון, או גדול ממנה. לא רלוונטי אם בשדה performanceGoalType מוגדר הערך BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

לדוגמה, המספר 1500,000 מייצג 1.5 יחידות רגילות של המטבע.
customBiddingAlgorithmId

string (int64 format)

המזהה של האלגוריתם של הבידינג המותאם אישית שבו נעשה שימוש בשיטה הזו. רלוונטי רק כאשר בשדה performanceGoalType מוגדר הערך BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.