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 צריך להיות 0. עבור ישות של פריט, הערך של bidAmountMicros חייב להיות גדול או שווה ליחידה הניתנת לחיוב של המטבע הנתון, וקטן או שווה לגבול העליון של 1,000,000,000.

לדוגמה, הערך 1500000 מייצג 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)

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

לדוגמה, הערך 1500000 מייצג 1.5 יחידות סטנדרטיות של המטבע.
raiseBidForDeals

boolean

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

string (int64 format)

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

אם תקצו אלגוריתם של בידינג מותאם אישית שמשתמש בפעילויות Floodlight שלא זוהו ב-floodlightActivityConfigs, תוחזר שגיאה.

BiddingStrategyPerformanceGoalType

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

טיפוסים בני מנייה (enum)
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA עלות להמרה.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC עלות לקליק (CPC).
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM עלות לאלף חשיפות הניתנות לצפייה (vCPM).
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 חשיפות שניתנות לצפייה.
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, הגבול העליון הוא ‎10,000.00 USD.
  • כשהערך של performanceGoalType הוא BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, הגבול העליון הוא ‎1,000.00 USD.
  • כשהערך של performanceGoalType הוא BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, הגבול העליון הוא ‎1,000.00 USD.
  • כאשר performanceGoalType הוא BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, הגבול העליון הוא 1,000.00 והגבול התחתון הוא 0.01.

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

לדוגמה, הערך 1500000 מייצג 1.5 יחידות רגילות של המטבע או של ערך ההחזר על הוצאות הפרסום.
maxAverageCpmBidAmountMicros

string (int64 format)

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

לדוגמה, הערך 1500000 מייצג 1.5 יחידות סטנדרטיות של המטבע.
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

אם לא משתמשים בשיטה רלוונטית, הערך של השדה הזה יהיה 0.
adGroupEffectiveTargetCpaValue

string (int64 format)

פלט בלבד. יעד העלות להמרה בפועל של קבוצת המודעות, במיקרו-מטבע של המפרסם.
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

פלט בלבד. המקור של ערך יעד העלות להמרה בפועל של קבוצת המודעות.

YoutubeAndPartnersBiddingStrategyType

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

טיפוסים בני מנייה (enum)
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

המקור של ערך הבידינג.

טיפוסים בני מנייה (enum)
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). לדוגמה, הערך 1000000 מייצג 1.0 יחידות רגילות של המטבע או ערך של 100% החזר על הוצאות פרסום. אם לא משתמשים בשיטה רלוונטית, הערך של השדה הזה יהיה 0.
effectiveBiddingValue

string (int64 format)

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

אם הערך בשדה type הוא לא DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA או DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS, הערך בשדה הזה יהיה 0.
effectiveBiddingValueSource

enum (BiddingSource)

פלט בלבד. המקור של ערך הבידינג בפועל.

DemandGenBiddingStrategyType

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

טיפוסים בני מנייה (enum)
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 שיטת בידינג שמבצעת אופטימיזציה אוטומטית של העלות לקליק.