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)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

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 ו-Partners.

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) קיימות בהזמנות קמפיין 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 TV מחוברות (עד 15 שניות) שלא ניתן לדלג עליהן.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

מודעות וידאו ב-YouTube TV מחוברות שמאפשרות אופטימיזציה של פוטנציאל החשיפה ליותר משתמשים ייחודיים בעלות נמוכה יותר. המודעות יכולות לכלול מודעות באמפר, מודעות וידאו 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

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

טיפוסים בני מנייה (enums)
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

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

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

enum (PartnerRevenueModelMarkupType)

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

markupAmount

string (int64 format)

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

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

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

טיפוסים בני מנייה (enums)
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM מחשבים את הכנסות השותף על סמך עלות קבועה לאלף חשיפות (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% מההמרות לאחר קליק, מגדירים את הערך 50,000.

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

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

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

MobileApp

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

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

string

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

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

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

platform

enum (Platform)

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

displayName

string

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

publisher

string

פלט בלבד. בעל האפליקציה.

פלטפורמה

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

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

YoutubeAndPartnersSettings

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

ייצוג 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

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

טיפוסים בני מנייה (enums)
THIRD_PARTY_VENDOR_UNSPECIFIED ספק צד שלישי לא ידוע.
THIRD_PARTY_VENDOR_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 ושל Partners.

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

boolean

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

includeGoogleTv

boolean

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

includeYoutubeVideoPartners

boolean

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

YoutubeAndPartnersContentCategory

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

טיפוסים בני מנייה (enums)
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

הספירה לאחור עבור זמן המרווח המינימלי האפשרי לפני שאותו משתמש יראה שוב את ה-VideoAdSequence.

טיפוסים בני מנייה (enums)
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)

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

InteractionType

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

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

שיטות

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

מחיקת פריט.

duplicate

משכפל פריט.

generateDefault

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

get

הפונקציה מקבלת פריט.

list

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

patch

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