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 עלות לקליק.
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, הגבול העליון הוא 1000.00 והגבול התחתון הוא 0.01.

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

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

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