REST Resource: advertisers.lineItems

משאב: LineItem

פריט אחד בשורה.

ייצוג ב-JSON
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}
שדות
name

string

פלט בלבד. שם המשאב של פריט העלויות.

advertiserId

string (int64 format)

פלט בלבד. המזהה הייחודי של המפרסם שאליו שייך הפריט.

campaignId

string (int64 format)

פלט בלבד. המזהה הייחודי של הקמפיין שאליו שייך הפריט.

insertionOrderId

string (int64 format)

חובה. לא ניתן לשינוי. המזהה הייחודי של הזמנת הקמפיין שאליה שייך הפריט.

lineItemId

string (int64 format)

פלט בלבד. המזהה הייחודי של הפריט. המערכת מקצה את השם.

displayName

string

חובה. שם התצוגה של הפריט.

הקידוד חייב להיות UTF-8 והגודל המקסימלי הוא 240 בייטים.

lineItemType

enum (LineItemType)

חובה. לא ניתן לשינוי. הסוג של הפריט.

entityStatus

enum (EntityStatus)

חובה. ההגדרה קובעת אם הפריט יוכל להוציא את התקציב שלו ולהגיש הצעות מחיר על מלאי שטחי הפרסום.

  • בשיטה lineItems.create, מותר להשתמש רק ב-ENTITY_STATUS_DRAFT. כדי להפעיל פריט, משתמשים בשיטה lineItems.patch ומעדכנים את הסטטוס ל-ENTITY_STATUS_ACTIVE אחרי היצירה.
  • אי אפשר לשנות את הסטטוס של פריט ל-ENTITY_STATUS_DRAFT מסטטוס אחר.
  • אם הזמנת ההצגה של ההורה של פריט החשבון לא פעילה, פריט החשבון לא יכול להוציא את התקציב שלו גם אם הסטטוס שלו הוא ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של מועד העדכון האחרון של הפריט. המערכת מקצה את השם.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

partnerCosts[]

object (PartnerCost)

העלויות של השותף שמשויכות לפריט.

אם השדה הזה לא קיים או שהוא ריק בשיטה lineItems.create, פריט העלויות החדש שייווצר יקבל בירושה את עלויות השותפים מההזמנה להצגת מודעות ההורה שלו.

flight

object (LineItemFlight)

חובה. שעת ההתחלה ושעת הסיום של הטיסה שרשומה בפריט.

budget

object (LineItemBudget)

חובה. הגדרת הקצאת התקציב של הפריט.

pacing

object (Pacing)

חובה. הגדרת קצב ההוצאה של התקציב בפריט.

frequencyCap

object (FrequencyCap)

חובה. הגדרות מכסת התדירות של החשיפות של הפריט.

אם מקצים מכסה מוגבלת, צריך להשתמש בשדה maxImpressions באובייקט ההגדרות הזה.

partnerRevenueModel

object (PartnerRevenueModel)

חובה. ההגדרה של מודל הכנסות השותף בפריט.

conversionCounting

object (ConversionCountingConfig)

ההגדרה של מעקב ההמרות של הפריט.

creativeIds[]

string (int64 format)

המזהים של הקריאייטיבים שמשויכים לפריט.

bidStrategy

object (BiddingStrategy)

חובה. שיטת הבידינג של הפריט.

integrationDetails

object (IntegrationDetails)

פרטי השילוב של הפריט.

targetingExpansion

object (TargetingExpansionConfig)

ההגדרות של אופטימיזציית הטירגוט של הפריט.

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

warningMessages[]

enum (LineItemWarningMessage)

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

mobileApp

object (MobileApp)

האפליקציה לנייד שמקודמת על ידי הפריט.

האפשרות הזו רלוונטית רק כאשר lineItemType הוא LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL או LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

reservationType

enum (ReservationType)

פלט בלבד. סוג ההזמנה של הפריט.

excludeNewExchanges

boolean

האם להחריג חילופי מטבע חדשים מהטירגוט האוטומטי של הפריט. השדה הזה מוגדר כ-false כברירת מחדל.

youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

פלט בלבד. הגדרות ספציפיות לפריטי YouTube ושותפים.

LineItemType

סוגי הפריטים האפשריים.

סוג הפריט קובע אילו הגדרות ואפשרויות רלוונטיות, כמו הפורמט של המודעות או אפשרויות הטירגוט.

טיפוסים בני מנייה (enum)
LINE_ITEM_TYPE_UNSPECIFIED

ערך הטיפוס לא צוין או שהוא לא ידוע בגרסה הזו.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_DISPLAY_DEFAULT מודעות תמונה, מודעות HTML5, מודעות מותאמות או מודעות מדיה עשירה.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL מודעות לרשת המדיה שמעודדות התקנות של אפליקציה.
LINE_ITEM_TYPE_VIDEO_DEFAULT מודעות וידאו שנמכרות על בסיס עלות לאלף חשיפות (CPM) במגוון סביבות.
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 מודעות Over-the-top שמופיעות בהזמנות להטמעת מודעות ב-OTT. הסוג הזה רלוונטי רק לפריטים עם הזמנת קמפיין מסוג insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

מודעות וידאו ב-YouTube שמקדמות המרות.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

מודעות וידאו ב-YouTube (עד 15 שניות) שלא ניתן לדלג עליהן.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

מודעות וידאו ב-YouTube שמציגות סיפור ברצף מסוים באמצעות שילוב של פורמטים.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

מודעות אודיו ב-YouTube.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

מודעות וידאו ב-YouTube שעוברות אופטימיזציה כדי להגיע ליותר משתמשים ייחודיים בעלות נמוכה יותר. יכולות לכלול מודעות באמפר, מודעות וידאו In-Stream שניתן לדלג עליהן או שילוב של סוגי מודעות.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

מודעות וידאו ב-YouTube שמוגדרות כברירת מחדל.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

מודעות וידאו ב-YouTube לטלוויזיות מחוברות (עד 15 שניות) שלא ניתן לדלג עליהן.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

מודעות וידאו ב-YouTube לטלוויזיות מחוברות שמאפשרות לכם להגיע ליותר משתמשים ייחודיים בעלות נמוכה יותר. יכולות לכלול מודעות באמפר, מודעות וידאו In-Stream שניתן לדלג עליהן או שילוב של סוגי מודעות.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

מודעות וידאו ב-YouTube שמוגדרות כברירת מחדל בטלוויזיה מחוברת. יש לכלול רק מודעות וידאו In-stream.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

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

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

מודעות וידאו ב-YouTube שמטרתן להשיג יותר צפיות באמצעות מגוון פורמטים של מודעות.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

מודעות לרשת המדיה שמוצגות במלאי שטחי פרסום דיגיטליים מחוץ לבית.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

מודעות וידאו שמוצגות במלאי שטחי פרסום דיגיטליים מחוץ לבית.

לא ניתן ליצור או לעדכן פריטים מסוג זה ואת הטירגוט שלהם באמצעות ה-API.

LineItemFlight

הגדרות ששולטות במשך הזמן הפעיל של פריט.

ייצוג ב-JSON
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
שדות
flightDateType

enum (LineItemFlightDateType)

חובה. הסוג של תאריכי הטיסות של הפריט.

dateRange

object (DateRange)

תאריכי ההתחלה והסיום של הטיסה בפריט. הן מומרות לפי אזור הזמן של המפרסם ההורה.

  • חובה כשהערך של flightDateType הוא LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. אחרת, פלט בלבד.
  • כשיוצרים טיסה חדשה, הערכים של startDate ו-endDate חייבים להיות בעתיד.
  • לטיסה קיימת עם startDate בעבר יש endDate שניתן לשינוי, אבל startDate שלא ניתן לשינוי.
  • הערך של endDate חייב להיות startDate או תאריך מאוחר יותר, שניהם לפני שנת 2037.

LineItemFlightDateType

סוגי התאריכים האפשריים של הטיסה בפריט.

טיפוסים בני מנייה (enum)
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED ערך הטיפוס לא צוין או שהוא לא ידוע בגרסה הזו.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED תאריכי הטיסות של הפריט עוברים בירושה מסדר ההכנסה ההורה שלו.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM לפריט יש תאריכי טיסה מותאמים אישית משלו.

LineItemBudget

הגדרות שקובעות את אופן הקצאת התקציב.

ייצוג ב-JSON
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
שדות
budgetAllocationType

enum (LineItemBudgetAllocationType)

חובה. הסוג של הקצאת התקציב.

אפשר להשתמש ב-LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC רק כשהקצאת התקציב האוטומטית מופעלת בהזמנת ההצגה הראשית.

budgetUnit

enum (BudgetUnit)

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

maxAmount

string (int64 format)

סכום התקציב המקסימלי שבו יושקע הפריט. הערך חייב להיות גדול מ-0.

כשהערך בשדה budgetAllocationType הוא:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, השדה הזה לא ניתן לשינוי והוא מוגדר על ידי המערכת.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, אם budgetUnit הוא:
    • BUDGET_UNIT_CURRENCY, השדה הזה מייצג את סכום התקציב המקסימלי להוצאה, במיקרו של המטבע של המפרסם. לדוגמה, הערך 1500000 מייצג 1.5 יחידות רגילות של המטבע.
    • BUDGET_UNIT_IMPRESSIONS, השדה הזה מייצג את מספר החשיפות המקסימלי שיוצגו.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, השדה הזה לא רלוונטי והמערכת תתעלם ממנו.

LineItemBudgetAllocationType

הסוגים האפשריים של הקצאת התקציב.

טיפוסים בני מנייה (enum)
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 (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
שדות
markupType

enum (PartnerRevenueModelMarkupType)

חובה. סוג הייקור של מודל ההכנסות של השותף.

markupAmount

string (int64 format)

חובה. סכום היקור של מודל ההכנסות של השותף. חייב להיות גדול מ-0 או שווה לו.

  • כשהערך של markupType מוגדר כ-PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, השדה הזה מייצג את ה-markup של העלות לאלף חשיפות במיקרו של המטבע של המפרסם. לדוגמה, הערך 1500000 מייצג 1.5 יחידות רגילות של המטבע.
  • כשהערך של markupType מוגדר כ-PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, השדה הזה מייצג את אחוז העלייה בעלות המדיה במיליס. לדוגמה, הערך 100 מייצג 0.1% (0.001 בערך עשרוני).
  • כשהערך של markupType מוגדר כ-PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, השדה הזה מייצג את אחוז העלייה בעלות המדיה הכוללת במיליונים. לדוגמה, הערך 100 מייצג 0.1% (0.001 בערך עשרוני).

PartnerRevenueModelMarkupType

סוגי המיפוי האפשריים של מודל ההכנסות של השותף.

טיפוסים בני מנייה (enum)
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED ערך הטיפוס לא צוין או שהוא לא ידוע בגרסה הזו.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM חישוב ההכנסות של השותף על סמך עלות קבועה ל-1,000 חשיפות (CPM).
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

חישוב ההכנסה של השותף על סמך תוספת אחוזית לעלות המדיה שלו.

PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP חישוב ההכנסה של השותף על סמך תוספת אחוזית לעלות המדיה הכוללת שלו, כולל כל העלויות של השותף ושל נתונים.

ConversionCountingConfig

הגדרות שקובעות איך ההמרות נספרות.

המערכת תספור את כל ההמרות שמתרחשות אחרי הקליק. אפשר להגדיר ערך אחוז לסימון המרות לאחר צפייה.

ייצוג ב-JSON
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
שדות
postViewCountPercentageMillis

string (int64 format)

אחוז ההמרות לאחר צפייה שצריך לספור, באלפיות (1/1,000 אחוז). הערך חייב להיות בין 0 ל-100,000, כולל.

לדוגמה, כדי לעקוב אחרי 50% מההמרות שמתרחשות אחרי קליק, מגדירים ערך של 50000.

floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

הגדרות הפעילות ב-Floodlight שמשמשות למעקב אחר המרות.

מספר ההמרות שנספר הוא הסכום של כל ההמרות שנספרו על ידי כל מזהי הפעילויות ב-Floodlight שצוינו בשדה הזה.

TrackingFloodlightActivityConfig

הגדרות ששולטות בהתנהגות של הגדרת פעילות אחת ב-Floodlight.

ייצוג ב-JSON
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
שדות
floodlightActivityId

string (int64 format)

חובה. המזהה של הפעילות ב-Floodlight.

postClickLookbackWindowDays

integer

חובה. מספר הימים אחרי הקליק על המודעה שבמהלכם יכולה להיספר המרה. חייב להיות בין 0 ל-90, כולל.

postViewLookbackWindowDays

integer

חובה. מספר הימים אחרי הצפייה במודעה שבמהלכם יכולה להיספר המרה. חייב להיות בין 0 ל-90, כולל.

LineItemWarningMessage

הודעות האזהרה שנוצרו על ידי פריט. סוגים כאלה של אזהרות לא חוסמים את השמירה של פריט, אבל הם עשויים לחסום את ההפעלה של פריט.

טיפוסים בני מנייה (enum)
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 לסדר ההכנסה של הפריט הזה הוגדר תאריך סיום שכבר חלף. הפריט לא יפעל.

MobileApp

אפליקציה לנייד שמקודמת באמצעות פריט 'התקנת אפליקציה'.

ייצוג ב-JSON
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
שדות
appId

string

חובה. המזהה של האפליקציה שסופק על ידי חנות הפלטפורמה.

אפליקציות ל-Android מזוהות לפי מזהה החבילה שבו נעשה שימוש בחנות Play ל-Android, למשל com.google.android.gm.

אפליקציות ל-iOS מזוהות באמצעות מזהה אפליקציה בן תשע ספרות שמשמש את App Store של Apple, למשל 422689480.

platform

enum (Platform)

פלט בלבד. הפלטפורמה של האפליקציה.

displayName

string

פלט בלבד. שם האפליקציה.

publisher

string

פלט בלבד. בעל התוכן הדיגיטלי של האפליקציה.

פלטפורמה

פלטפורמות אפשריות לאפליקציות לנייד.

טיפוסים בני מנייה (enum)
PLATFORM_UNSPECIFIED לא צוינה פלטפורמה.
IOS פלטפורמת iOS.
ANDROID פלטפורמת Android.

YoutubeAndPartnersSettings

הגדרות של פריטי YouTube ושותפים.

ייצוג ב-JSON
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
שדות
viewFrequencyCap

object (FrequencyCap)

הגדרות מכסת התדירות של הצגת המודעות בפריט.

אם מקצים מכסה מוגבלת, צריך להשתמש בשדה maxViews באובייקט ההגדרות הזה.

thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

זה שינוי אופציונלי. הגדרות המדידה על ידי צד שלישי של הפריט.

inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

הגדרות שקובעות את מלאי שטחי הפרסום ב-YouTube ובשותפים שאליהם יופנה הפריט.

contentCategory

enum (YoutubeAndPartnersContentCategory)

סוג התוכן שבו יוצגו המודעות של YouTube ושל שותפים.

effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

פלט בלבד. קטגוריית התוכן שחלה כשהפריט מוצג. כשמגדירים את קטגוריית התוכן גם בפריט החשבון וגם ברמת המפרסם, הקטגוריה המחמירה יותר תהיה בתוקף כשהמערכת תציג את הפריט.

targetFrequency

object (TargetFrequency)

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

linkedMerchantId

string (int64 format)

זה שינוי אופציונלי. המזהה של המוכר שמקושר לפריט בפיד המוצרים.

relatedVideoIds[]

string

זה שינוי אופציונלי. המזהים של הסרטונים מופיעים מתחת למודעת הווידאו הראשית כשהמודעה מוצגת באפליקציית YouTube במכשירים ניידים.

leadFormId

string (int64 format)

זה שינוי אופציונלי. המזהה של הטופס ליצירת לידים.

videoAdSequenceSettings

object (VideoAdSequenceSettings)

זה שינוי אופציונלי. ההגדרות שקשורות ל-VideoAdSequence.

ThirdPartyMeasurementConfigs

הגדרות שקובעות אילו ספקי צד שלישי מודדים מדדים ספציפיים של פריטים.

ייצוג ב-JSON
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
שדות
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

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

הספקים הבאים של צד שלישי רלוונטיים:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

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

הספקים הבאים של צד שלישי רלוונטיים:

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

זה שינוי אופציונלי. ספקי הצד השלישי שמבצעים מדידה של היקף החשיפה.

הספקים הבאים של צד שלישי רלוונטיים:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

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

הספקים הבאים של צד שלישי רלוונטיים:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

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

ייצוג ב-JSON
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
שדות
vendor

enum (ThirdPartyVendor)

ספק המדידה של הצד השלישי.

placementId

string

המזהה שבו משתמשת הפלטפורמה של ספק הצד השלישי כדי לזהות את הפריט.

ThirdPartyVendor

ספקים שמבצעים מדידה על ידי צד שלישי.

טיפוסים בני מנייה (enum)
THIRD_PARTY_VENDOR_UNSPECIFIED ספק צד שלישי לא ידוע.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY טלמטריה.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.

YoutubeAndPartnersInventorySourceConfig

הגדרות שקובעות את מלאי שטחי הפרסום הקשור ל-YouTube שאליו יופנה הפריט 'YouTube ושותפים'.

ייצוג ב-JSON
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
שדות
includeYoutube

boolean

זה שינוי אופציונלי. האם לטרגט מלאי שטחי פרסום ב-YouTube. הנתונים האלה כוללים גם חיפוש, ערוצים וסרטונים.

includeGoogleTv

boolean

זה שינוי אופציונלי. האם לטרגט מלאי שטחי פרסום באפליקציות וידאו שזמינות ב-Google TV.

includeYoutubeVideoPartners

boolean

האם לטרגט מלאי שטחי פרסום באוסף של אתרים ואפליקציות של שותפים שתואמים לתקנים של YouTube להגנה על מותגים.

YoutubeAndPartnersContentCategory

קטגוריות של תוכן ב-YouTube ובתוכן של שותפים שעשויות לסכן את המותג.

טיפוסים בני מנייה (enum)
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED קטגוריית התוכן לא צוינה או שהיא לא ידועה בגרסה הזו.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD קטגוריה שמכילה מגוון רחב של תכנים שמתאימים לרוב המותגים. התוכן מבוסס על ההנחיות של YouTube ליצירת תוכן ידידותי למפרסמים.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED קטגוריה שכוללת את כל התוכן ב-YouTube ובשותפי הווידאו שעומד בתקנים למונטיזציה.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED קטגוריה שמכילה מגוון מצומצם של תוכן שעומד בדרישות מחמירות, במיוחד בכל הנוגע לשימוש בשפה לא הולמת וברמיזות מיניות.

TargetFrequency

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

ייצוג ב-JSON
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
שדות
targetCount

string (int64 format)

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

timeUnit

enum (TimeUnit)

יחידת הזמן שבה תדירות הטירגוט תחול.

יחידת הזמן הרלוונטית היא:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

מספר הtimeUnit שבו תדירות הטירגוט תימשך.

ההגבלות הבאות חלות על סמך הערך של timeUnit:

  • TIME_UNIT_WEEKS – חייב להיות 1

VideoAdSequenceSettings

הגדרות שקשורות ל-VideoAdSequence.

ייצוג ב-JSON
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
שדות
minimumDuration

enum (VideoAdSequenceMinimumDuration)

מרווח הזמן המינימלי לפני שאותו משתמש יראה שוב את הרצף הזה.

steps[]

object (VideoAdSequenceStep)

השלבים שמהם מורכבת התצוגה.

VideoAdSequenceMinimumDuration

Enumeration של פרק הזמן המינימלי האפשרי לפני שאותו משתמש יראה שוב את VideoAdSequence.

טיפוסים בני מנייה (enum)
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED לא צוין או לא ידוע.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 ימים.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 ימים.

VideoAdSequenceStep

פרטי שלב יחיד ב-VideoAdSequence.

ייצוג ב-JSON
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
שדות
stepId

string (int64 format)

המזהה של השלב.

adGroupId

string (int64 format)

המזהה של קבוצת המודעות התואמת של השלב.

previousStepId

string (int64 format)

המזהה של השלב הקודם. לשלב הראשון אין שלב קודם.

interactionType

enum (InteractionType)

האינטראקציה בשלב הקודם שתובילה את הצופה לשלב הזה. בשלב הראשון אין את השדה interactionType.

InteractionType

סוגי האינטראקציה בשלב.

טיפוסים בני מנייה (enum)
INTERACTION_TYPE_UNSPECIFIED לא צוין או לא ידוע
INTERACTION_TYPE_PAID_VIEW צפייה בתשלום.
INTERACTION_TYPE_SKIP הצופה דילג עליה.
INTERACTION_TYPE_IMPRESSION חשיפה של מודעה (שצפו בה).
INTERACTION_TYPE_ENGAGED_IMPRESSION חשיפה של מודעה שהצופה לא דילג עליה באופן מיידי, אבל גם לא הגיע לאירוע לחיוב.

Methods

bulkEditAssignedTargetingOptions

עריכה בכמות גדולה של אפשרויות הטירגוט בכמה פריטים.

bulkListAssignedTargetingOptions

רשימה של אפשרויות הטירגוט שהוקצו למספר פריטים שונים בקטגוריות שונות של טירגוט.

bulkUpdate

עדכון של כמה פריטים.

create

יצירת פריט חדש.

delete

מחיקת פריט.

duplicate

יוצר עותק כפול של פריט.

generateDefault

הפונקציה יוצרת פריט חדש עם הגדרות (כולל טירגוט) שעברו בירושה מההזמנה להצגת מודעות ועם ENTITY_STATUS_DRAFT entity_status.

get

אחזור של פריט.

list

הצגת רשימה של פריטים במפרסם.

patch

עדכון של פריט קיים.