- משאב: InsertionOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- שיטות
משאב: InsertionOrder
הזמנת קמפיין אחת.
ייצוג JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של הזמנת הקמפיין. |
advertiserId |
פלט בלבד. המזהה הייחודי של המפרסם שאליו שייכת הזמנת הקמפיין. |
campaignId |
חובה. לא משתנה. המזהה הייחודי של הקמפיין שאליו שייכת הזמנת הקמפיין. |
insertionOrderId |
פלט בלבד. המזהה הייחודי של הזמנת הקמפיין. הוקצה על ידי המערכת. |
displayName |
חובה. השם המוצג של הזמנת הקמפיין. חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים. |
insertionOrderType |
הסוג של הזמנת הקמפיין. אם השדה הזה לא צוין במהלך היצירה, ברירת המחדל של הערך היא |
entityStatus |
חובה. המדיניות הזו קובעת אם סדר ההכנסה יוכל לנצל את התקציב ולהגיש הצעות מחיר על מלאי שטחי פרסום.
|
updateTime |
פלט בלבד. חותמת הזמן של מועד העדכון האחרון של הזמנת הקמפיין. הוקצה על ידי המערכת. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
partnerCosts[] |
עלויות השותף שמשויכות להזמנת הקמפיין. אם המאפיין חסר או ריק בשיטה |
pacing |
חובה. ההגדרה של מהירות הוצאת התקציב של סדר ההכנסה. |
frequencyCap |
חובה. הגדרת מכסת התדירות של סדר ההכנסה. |
integrationDetails |
פרטים נוספים על השילוב של הזמנת הקמפיין. |
performanceGoal |
חובה. יעד הביצועים של הזמנת הקמפיין. |
budget |
חובה. הגדרות הקצאת התקציב של הזמנת הקמפיין. |
bidStrategy |
שיטת הבידינג של הזמנת הקמפיין. המדיניות |
reservationType |
פלט בלבד. סוג ההזמנה של הזמנת הקמפיין. |
billableOutcome |
לא משתנה. התוצאה של הזמנת הקמפיין שניתנת לחיוב. הוצאנו משימוש קנייה מבוססת-תוצאות. |
InsertionOrderType
סוגים אפשריים של הזמנת קמפיין.
הסוג של סדר ההכנסה קובע אילו הגדרות ואפשרויות ניתן להחיל, כמו הפורמט של המודעות או אפשרויות הטירגוט.
טיפוסים בני מנייה (enums) | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
סוג הזמנת הקמפיין לא צוין או שאינו ידוע. |
RTB |
בידינג בזמן אמת. |
OVER_THE_TOP |
ישירות ללקוח. |
InsertionOrderBudget
הגדרות שקובעות את אופן הקצאת התקציב של הזמנת הקמפיין.
ייצוג JSON |
---|
{ "budgetUnit": enum ( |
שדות | |
---|---|
budgetUnit |
חובה. לא משתנה. יחידת התקציב מציינת אם התקציב מבוסס על מטבע או על חשיפות. |
automationType |
סוג האוטומציה שמשמשת לניהול של הצעות המחיר והתקציב של הזמנת הקמפיין. אם השדה הזה לא צוין במהלך היצירה, ברירת המחדל של הערך היא |
budgetSegments[] |
חובה. רשימת הפלחים של התקציב. אפשר להשתמש בפלח תקציב כדי לציין תקציב ספציפי לתקופת זמן נתונה של הזמנת קמפיין. |
InsertionOrderAutomationType
אפשרויות אפשריות לאוטומציה של התקציב והצעת המחיר להזמנת קמפיין.
טיפוסים בני מנייה (enums) | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
אפשרות האוטומציה של הזמנת הקמפיין לא צוינה או שהיא לא ידועה בגרסה הזו. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
הקצאת תקציב אוטומטית. המערכת יכולה להעביר באופן אוטומטי את התקציב לפריטי הבעלות על הפריטים, כדי לבצע אופטימיזציה לביצועים שהוגדרו על ידי performanceGoal . ללא פעולות אוטומטיות בהגדרות של הצעות המחיר. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
אין אוטומציה של הצעת המחיר או התקציב ברמת סדר ההכנסה. צריך להגדיר את התקציב ואת הצעת המחיר ברמת הפריט באופן ידני. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
מתן אפשרות למערכת להתאים את הצעות המחיר באופן אוטומטי ולהעביר את התקציב לפריטים השייכים לו, כדי להשיג ביצועים אופטימליים שהוגדרו על ידי performanceGoal . |
InsertionOrderBudgetSegment
הגדרות שקובעות את התקציב של פלח תקציב יחיד.
ייצוג JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
שדות | |
---|---|
budgetAmountMicros |
חובה. סכום התקציב ההוצאה של הזמנת הקמפיין עבור |
description |
תיאור פלח התקציב. אפשר להשתמש בו כדי להזין את פרטי הזמנת הרכש לכל פלח תקציב, ולהדפיס את הפרטים האלה בחשבוניות. הקידוד חייב להיות UTF-8. |
dateRange |
חובה. הגדרות תאריכי ההתחלה והסיום של פלח התקציב. הם מזוהים בהתאם לאזור הזמן של מפרסם ההורה.
|
campaignBudgetId |
ה- |
BillableOutcome
תוצאות אפשריות לחיוב של הזמנת קמפיין.
טיפוסים בני מנייה (enums) | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
תוצאה לא מוגדרת לחיוב. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
משלמים לפי חשיפות. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
תשלום לפי קליק. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
תשלום לפי תצוגה פעילה. |
שיטות |
|
---|---|
|
בתיבת הדו-שיח הזו מפורטים אפשרויות הטירגוט שהוקצו לפי סדר ההכנסה בכל סוגי הטירגוט. |
|
יצירה של הזמנת קמפיין חדשה. |
|
מחיקה של הזמנת קמפיין. |
|
הפונקציה מקבלת הזמנת קמפיין. |
|
בתיבת הדו-שיח הזו מפורטים הזמנות קמפיינים במפרסם. |
|
עדכון של הזמנת קמפיין קיימת. |