אנחנו מוציאים משימוש את גרסה 1בטא2 של Display & Video 360 API. בקשות לגרסה שנסגרה עלולות להחזיר שגיאה.

עליכם להשתמש ב-Display & Video 360 API v2. אפשר להיעזר במדריך להעברת נתונים (מיגרציה) כדי לעבור מגרסה 1 לגרסה 2.

דף זה תורגם על ידי Cloud Translation API.

PerformanceGoal

ייצוג JSON
PerformanceGoalType

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

ייצוג JSON

ייצוג JSON
{ "performanceGoalType": enum (`PerformanceGoalType`), // Union field `performance_goal_value` can be only one of the following: "performanceGoalAmountMicros": string, "performanceGoalPercentageMicros": string, "performanceGoalString": string // End of list of possible types for union field `performance_goal_value`. }

{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}

שדות
`performanceGoalType`	`enum (PerformanceGoalType)` חובה. הסוג של יעד הביצועים.
שדה איחוד `performance_goal_value`. חובה. ערך יעד הביצועים התואם ל-`performance_goal_type` נתון. הערך של `performance_goal_value` יכול להיות רק אחת מהאפשרויות הבאות:
`performanceGoalAmountMicros`	`string (int64 format)` סכום היעד, במיליוניות השנייה של המטבע של המפרסם. רלוונטי אם `performanceGoalType` הוא אחד מהתנאים הבאים: `PERFORMANCE_GOAL_TYPE_CPM` `PERFORMANCE_GOAL_TYPE_CPC` `PERFORMANCE_GOAL_TYPE_CPA` `PERFORMANCE_GOAL_TYPE_CPIAVC` `PERFORMANCE_GOAL_TYPE_VCPM` לדוגמה, המספר 1500000 מייצג 1.5 יחידות סטנדרטיות של המטבע.
`performanceGoalPercentageMicros`	`string (int64 format)` ייצוג עשרוני של אחוז היעד במיליוניות השנייה. רלוונטי אם `performanceGoalType` הוא אחד מהתנאים הבאים: `PERFORMANCE_GOAL_TYPE_CTR` `PERFORMANCE_GOAL_TYPE_VIEWABILITY` `PERFORMANCE_GOAL_TYPE_CLICK_CVR` `PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR` `PERFORMANCE_GOAL_TYPE_VTR` `PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE` `PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE` לדוגמה: 70000 מייצג את 7% (0.07 עשרוני).
`performanceGoalString`	`string` מחרוזת של אינדיקטור ביצועים מרכזיים (KPI), שיכולה להיות ריקה. הקידוד חייב להיות UTF-8 באורך של עד 100 תווים. רלוונטי אם הערך של `performanceGoalType` מוגדר ל-`PERFORMANCE_GOAL_TYPE_OTHER`.

PerformanceGoalType

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

טיפוסים בני מנייה (enums)
`PERFORMANCE_GOAL_TYPE_UNSPECIFIED`	הסוג של יעד הביצועים לא צוין או שהוא לא ידוע בגרסה הזו.
`PERFORMANCE_GOAL_TYPE_CPM`	יעד הביצועים מוגדר לפי עלות לאלף חשיפות (CPM).
`PERFORMANCE_GOAL_TYPE_CPC`	יעד הביצועים מוגדר בעלות לקליק (CPC).
`PERFORMANCE_GOAL_TYPE_CPA`	יעד הביצועים מוגדר לפי עלות להמרה (CPA).
`PERFORMANCE_GOAL_TYPE_CTR`	יעד הביצועים מוגדר באחוזים של שיעור הקליקים (CTR).
`PERFORMANCE_GOAL_TYPE_VIEWABILITY`	יעד הביצועים מוגדר באחוז הניראות.
`PERFORMANCE_GOAL_TYPE_CPIAVC`	יעד הביצועים מוגדר כ-CPIAVC (העלות לחשיפה ניתנת לשמע ומוצגת בסיום).
`PERFORMANCE_GOAL_TYPE_CPE`	יעד הביצועים מוגדר לפי עלות לאינטראקציה ראשונית (CPE).
`PERFORMANCE_GOAL_TYPE_CLICK_CVR`	יעד הביצועים מוגדר באחוזים של שיעור ההמרה לקליק (המרות לכל קליק).
`PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR`	יעד הביצועים מוגדר באחוזים של שיעור המרות לחשיפה (המרות לכל חשיפה).
`PERFORMANCE_GOAL_TYPE_VCPM`	יעד הביצועים מוגדר ב-VCPM (עלות לאלף חשיפות שניתנות לצפייה).
`PERFORMANCE_GOAL_TYPE_VTR`	יעד הביצועים נקבע באחוזים של שיעור הצפייה ב-YouTube (צפיות ב-YouTube לכל חשיפה).
`PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE`	יעד הביצועים מוגדר באחוזים של שיעור השלמת האודיו (האזנות מלאות של אודיו לכל חשיפה).
`PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE`	יעד הביצועים מוגדר באחוז השלמת הסרטון (צפיות מלאות בסרטון לכל חשיפה).
`PERFORMANCE_GOAL_TYPE_OTHER`	יעד הביצועים שהוגדר הוא 'אחר'.