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)

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

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

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

ייצוג 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 חשיפה של מודעה שהצופה לא דילג עליה באופן מיידי, אבל גם לא הגיע לאירוע לחיוב.

שיטות

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

 מוחק פריט.

duplicate

 שכפול פריט.

generateDefault

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

get

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

list

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

patch

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