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