- משאב: פריט שורה
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- פלטפורמה
- שיטות
משאב: פריט שורה
פריט יחיד.
ייצוג JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של הפריט. |
advertiserId |
פלט בלבד. המזהה הייחודי של המפרסם שאליו שייך הפריט. |
campaignId |
פלט בלבד. המזהה הייחודי של הקמפיין שהפריט שייך לו. |
insertionOrderId |
חובה. לא משתנה. המזהה הייחודי של הזמנת הקמפיין שאליה שייך הפריט. |
lineItemId |
פלט בלבד. המזהה הייחודי של הפריט. הוקצה על ידי המערכת. |
displayName |
חובה. השם המוצג של הפריט. חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים. |
lineItemType |
חובה. לא משתנה. סוג הפריט. |
entityStatus |
חובה. המדיניות הזו קובעת אם הפריט יכול לנצל את התקציב ולהגיש הצעות מחיר על מלאי שטחי פרסום.
|
updateTime |
פלט בלבד. חותמת הזמן של העדכון האחרון של הפריט. הוקצה על ידי המערכת. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
partnerCosts[] |
עלויות השותף שמשויכות לפריט. אם המאפיין חסר או ריק בשיטה |
flight |
חובה. זמן ההתחלה ושעת הסיום של הטיסה של הפריט. |
budget |
חובה. הגדרת הקצאת התקציב של הפריט. |
pacing |
חובה. הגדרת מהירות ההוצאה של התקציב של הפריט. |
frequencyCap |
חובה. ההגדרות של מכסת תדירות החשיפות של הפריט. אם מקצים מכסה מוגבלת, צריך להשתמש בשדה |
partnerRevenueModel |
חובה. הגדרת מודל הכנסות השותף עבור הפריט. |
conversionCounting |
הגדרת מעקב ההמרות של הפריט. |
creativeIds[] |
המזהים של נכסי הקריאייטיב שמשויכים לפריט. |
bidStrategy |
חובה. שיטת הבידינג של הפריט. |
integrationDetails |
פרטי השילוב של הפריט. |
inventorySourceIds[] |
המזהים של המקורות של מלאי שטחי הפרסום הפרטי שהוקצו לפריט. |
targetingExpansion |
הגדרות אופטימיזציית הטירגוט של הפריט. ההגדרה הזו רלוונטית רק לפריטים לרשת המדיה, לפריטי וידאו או לאודיו שמוגדר בהם בידינג אוטומטי ומטרגטים באופן חיובי רשימות קהלים שעומדות בדרישות. |
warningMessages[] |
פלט בלבד. הודעות האזהרה שנוצרו על ידי הפריט. האזהרות האלה לא חוסמות את שמירת הפריט, אבל חלק מהן עלולות לחסום את ההפעלה של הפריט. |
mobileApp |
האפליקציה לנייד שהפריט מקדם. רלוונטי רק כאשר הערך של |
reservationType |
פלט בלבד. סוג ההזמנה של הפריט. |
excludeNewExchanges |
האם להחריג בורסות חדשות מטירגוט אוטומטי על ידי הפריט. השדה הזה מוגדר כ-False כברירת מחדל. |
LineItemType
סוגים אפשריים של פריט.
סוג הפריט קובע אילו הגדרות ואפשרויות ניתן להחיל, כמו הפורמט של המודעות או אפשרויות הטירגוט.
טיפוסים בני מנייה (enums) | |
---|---|
LINE_ITEM_TYPE_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. לא ניתן ליצור או לעדכן פריטים מהסוג הזה באמצעות ה-API. |
LINE_ITEM_TYPE_DISPLAY_DEFAULT |
מודעות תמונה, HTML5, מודעות מותאמות או מודעות מדיה עשירה. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
מודעות ברשת המדיה שמעודדות התקנות של אפליקציה. |
LINE_ITEM_TYPE_VIDEO_DEFAULT |
מודעות וידאו שנמכרות על בסיס עלות לאלף חשיפות במגוון סביבות. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL |
מודעות וידאו שמעודדות התקנות של אפליקציה. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY |
מודעות לרשת המדיה מוצגות במלאי שטחי פרסום באפליקציות לנייד. לא ניתן ליצור או לעדכן פריטים מהסוג הזה באמצעות ה-API. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY |
מודעות וידאו מוצגות במלאי שטחי פרסום באפליקציות לנייד. לא ניתן ליצור או לעדכן פריטים מהסוג הזה באמצעות ה-API. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
מודעות אודיו של RTB שנמכרות במגוון סביבות. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
מודעות ישירות ללקוח (OTT). הסוג הזה רלוונטי רק לפריטים עם הזמנת קמפיין של insertionOrderType OVER_THE_TOP . |
LineItemFlight
הגדרות שקובעות את משך הפעילות של פריט.
ייצוג JSON |
---|
{ "flightDateType": enum ( |
שדות | |
---|---|
flightDateType |
חובה. הסוג של תאריכי הטיסה של הפריט. |
dateRange |
תאריכי ההתחלה והסיום של הטיסה בפריט. הם מזוהים בהתאם לאזור הזמן של מפרסם ההורה.
|
triggerId |
המזהה של הטריגר הידני שמשויך לפריט.
אזהרה: פריטים שנעשה בהם שימוש בטריגרים ידניים לא יוצגו יותר ב-Display & Video 360. השדה הזה ייסגר ב-1 באוגוסט 2023. מידע נוסף זמין בהודעה על הוצאה משימוש של התכונות. |
LineItemFlightDateType
סוגים אפשריים של תאריכי טיסה של פריט.
טיפוסים בני מנייה (enums) | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
תאריכי פרק הזמן של הפרסום של הפריט עוברים בירושה מהזמנת האם של הפריט. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
לפריט הזה יש תאריכי פרסום מותאמים אישית משלו. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
הפריט משתמש בטריגר. אזהרה: פריטים שנעשה בהם שימוש בטריגרים ידניים לא יוצגו יותר ב-Display & Video 360. הערך הזה ייסגר ב-1 באוגוסט 2023. מידע נוסף זמין בהודעה על הוצאה משימוש של התכונות. |
LineItemBudget
הגדרות שקובעות את אופן הקצאת התקציב.
ייצוג JSON |
---|
{ "budgetAllocationType": enum ( |
שדות | |
---|---|
budgetAllocationType |
חובה. הסוג של הקצאת התקציב.
|
budgetUnit |
פלט בלבד. יחידת התקציב מציינת אם התקציב מבוסס על מטבע או על חשיפות. הערך הזה עובר בירושה מהזמנת ההורה. |
maxAmount |
סכום התקציב המקסימלי שיושקע בפריט. חייב להיות גדול מ-0. כשהערך בשדה
|
LineItemBudgetAllocationType
סוגים אפשריים של הקצאת התקציב
טיפוסים בני מנייה (enums) | |
---|---|
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC |
הקצאת תקציב אוטומטית מופעלת עבור הפריט. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED |
סכום קבוע של תקציב מקסימלי מוקצה לפריט. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
לא חלה מגבלת תקציב על הפריט. |
PartnerRevenueModel
הגדרות שקובעות איך מחושבות הכנסות השותף.
ייצוג JSON |
---|
{
"markupType": enum ( |
שדות | |
---|---|
markupType |
חובה. סוג תגי העיצוב של מודל הכנסות השותף. |
markupAmount |
חובה. סכום תגי העיצוב של מודל הכנסות השותף. חייב להיות גדול מ-0 או שווה לו.
|
PartnerRevenueModelMarkupType
סוגי תגי עיצוב אפשריים במודל הכנסות השותף.
טיפוסים בני מנייה (enums) | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM |
מחשבים את הכנסות השותף על סמך עלות קבועה לאלף חשיפות. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP |
מחשבים את הכנסות השותף על סמך אחוז התשלום הנוסף מתוך עלות המדיה. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
מחשבים את הכנסות השותף על סמך אחוז התשלום הנוסף מתוך עלות המדיה הכוללת, שכולל את כל עלויות השותפים ועלויות הנתונים. |
ConversionCountingConfig
הגדרות שקובעות איך המרות נספרות.
המערכת תספור את כל ההמרות שהתרחשו בעקבות קליק. ניתן להגדיר ערך באחוזים לספירת המרות לאחר צפייה.
ייצוג JSON |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
שדות | |
---|---|
postViewCountPercentageMillis |
אחוז ההמרות לאחר צפייה שצריך לספור, באלפיות השנייה (1/1,000 של אחוז). חייב להיות בין 0 ל-100,000, כולל. לדוגמה, כדי לעקוב אחר 50% מההמרות שהתרחשו לאחר קליק, מגדירים את הערך 50,000. |
floodlightActivityConfigs[] |
הגדרות הפעילות ב-Floodlight שמשמשות למעקב אחר המרות. מספר ההמרות שנספרו הוא הסכום של כל ההמרות שנספרו לפי כל מזהי הפעילות ב-Floodlight שצוינו בשדה הזה. |
TrackingFloodlightActivityConfig
הגדרות שקובעות את ההתנהגות של תצורה יחידה של פעילות ב-Floodlight.
ייצוג JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
שדות | |
---|---|
floodlightActivityId |
חובה. המזהה של הפעילות ב-Floodlight. |
postClickLookbackWindowDays |
חובה. מספר הימים לאחר קליק על מודעה שבהם ניתן לספור המרה. חייב להיות בין 0 ל-90, כולל. |
postViewLookbackWindowDays |
חובה. מספר הימים לאחר צפייה במודעה שבהם ניתן לספור המרה. חייב להיות בין 0 ל-90, כולל. |
TargetingExpansionConfig
הגדרות שקובעות את הגדרות אופטימיזציית הטירגוט של הפריט.
ייצוג JSON |
---|
{
"targetingExpansionLevel": enum ( |
שדות | |
---|---|
targetingExpansionLevel |
חובה. האם התכונה 'אופטימיזציית טירגוט' מופעלת. שדה זה תומך בערכים הבאים:
אם בשדה הזה מוגדר ערך אחר, הוא יוגדר אוטומטית כ- הערך |
excludeFirstPartyAudience |
האם להחריג קהלים מאינטראקציה ישירה משימוש בהרחבת הטירגוט. השדה הזה הוצא משימוש כשהשקנו את התכונה אופטימיזציית טירגוט. השדה הזה יוגדר לערך |
TargetingExpansionLevel
ההגדרה 'אופטימיזציית טירגוט'.
טיפוסים בני מנייה (enums) | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
ההגדרה של אופטימיזציית הטירגוט לא צוינה בגרסה הזו או שהיא לא ידועה. |
NO_EXPANSION |
אופטימיזציית הטירגוט מושבתת. |
LEAST_EXPANSION |
אופטימיזציית הטירגוט מופעלת. |
SOME_EXPANSION |
אם ייעשה שימוש, המדיניות תוגדר באופן אוטומטי ל- |
BALANCED_EXPANSION |
אם ייעשה שימוש, המדיניות תוגדר באופן אוטומטי ל- |
MORE_EXPANSION |
אם ייעשה שימוש, המדיניות תוגדר באופן אוטומטי ל- |
MOST_EXPANSION |
אם ייעשה שימוש, המדיניות תוגדר באופן אוטומטי ל- |
LineItemWarningMessage
הודעות האזהרה שנוצרו על ידי פריט מסוים. אזהרות מסוג זה לא חוסמות שמירת פריט, אבל הן עלולות לחסום הפעלה של פריט.
טיפוסים בני מנייה (enums) | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
לא צוין או לא ידוע. |
INVALID_FLIGHT_DATES |
לפריט הזה הוגדרו תאריכים לא חוקיים של פרק זמן של פרסום פעיל. הפריט לא יפעל. |
EXPIRED |
תאריך הסיום של הפריט הזה חל בעבר. |
PENDING_FLIGHT |
הפריט הזה יתחיל לפעול בעתיד. |
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED |
כל הערוצים המופעלים של שותפים נכללים במיקוד שלילי. הפריט לא יפעל. |
INVALID_INVENTORY_SOURCE |
אין מיקוד למקורות פעילים של מלאי שטחי פרסום. הפריט לא יפעל. |
APP_INVENTORY_INVALID_SITE_TARGETING |
המיקוד לאפליקציות ולכתובות URL של הפריט הזה לא כולל אפליקציות לנייד. סוג הפריט הזה מחייב אותך לכלול אפליקציות לנייד בטירגוט של הערוץ, רשימת האתרים או האפליקציות. הפריט לא יפעל. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
הפריט הזה לא מטרגט משתמשים בנייד. לסוג הפריט הזה צריך לטרגט רשימת משתמשים עם משתמשים בנייד. הפריט לא יפעל. |
NO_VALID_CREATIVE |
הפריט הזה לא מכיל קריאייטיב חוקי. הפריט לא יפעל. |
PARENT_INSERTION_ORDER_PAUSED |
סדר ההכנסה של הפריט הזה נמצא בהשהיה. הפריט לא יפעל. |
PARENT_INSERTION_ORDER_EXPIRED |
לסדר ההכנסה של הפריט הזה הוגדר תאריך סיום שכבר חלף. הפריט לא יפעל. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
הפריט הזה לא ממקד לרשימות קהלים, מה שעשוי להוביל לניצול מהיר מדי של התקציב. |
APP_INSTALL_NO_CONVERSION_PIXEL |
לפריט הזה של התקנת אפליקציה עדיין לא הוגדר פיקסל המרה. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
הפריט הזה מטרגט רשימת משתמשים אחת או יותר שכבר לא זמינה. מצב כזה ימנע בעתיד את הצגת הפריט, לכן מומלץ להסיר את הרשימות האלה מהטירגוט. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
לפריט הזה לעידוד התקנת אפליקציה לא הוגדרה שיטת בידינג אופטימלית |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
הפריט הזה ממקד לעסקאות שתומכות בגודלי קראייטיב שלא נמצאים בשימוש. מצב כזה עשוי להגביל את ההצגה או הביצועים של הפריט. |
NO_CREATIVE_FOR_TARGETED_DEALS |
הפריט הזה לא מכיל קריאייטיב עבור העסקאות המטורגטות. |
TARGETING_DEPRECATED_GEO_TARGET |
הפריט הזה מטרגט טירגוט גיאוגרפי שהוצא משימוש. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
הפריט הזה משתמש בהגדרה כדי להביא בחשבון את סגירת השדה |
MobileApp
אפליקציה לנייד המקודמת על ידי פריט של התקנת אפליקציה לנייד.
ייצוג JSON |
---|
{
"appId": string,
"platform": enum ( |
שדות | |
---|---|
appId |
חובה. מזהה האפליקציה שסופק על ידי חנות הפלטפורמה. אפליקציות ל-Android מזוהות לפי מזהה החבילה שמשמש את חנות Play של Android, למשל אפליקציות ל-iOS מזוהות באמצעות מזהה אפליקציה בן תשע ספרות ש-App Store של Apple משתמש בו. למשל: |
platform |
פלט בלבד. פלטפורמת האפליקציה. |
displayName |
פלט בלבד. שם האפליקציה. |
publisher |
פלט בלבד. הבעלים של האפליקציה. |
הפלטפורמה
פלטפורמות אפשריות של אפליקציות לנייד.
טיפוסים בני מנייה (enums) | |
---|---|
PLATFORM_UNSPECIFIED |
לא צוינה פלטפורמה. |
IOS |
iOS. |
ANDROID |
פלטפורמת Android. |
שיטות |
|
---|---|
|
ביצוע עריכות בכמות גדולה של אפשרויות טירגוט בפריט יחיד. |
|
בתיבת הדו-שיח הזו מפורטים אפשרויות טירגוט שהוקצו לפריט בכל סוגי הטירגוט. |
|
יצירת פריט חדש. |
|
מוחק פריט. |
|
הפונקציה יוצרת פריט חדש עם ההגדרות (כולל טירגוט) שעברו בירושה מהזמנת הקמפיין וentity_status ENTITY_STATUS_DRAFT . |
|
מקבל פריט. |
|
בתיבת הדו-שיח הזו מוצגים פריטים של מפרסם. |
|
עדכון פריט קיים. |