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)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
שדות
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. כדי להפעיל פריט, משתמשים ב-method‏ lineItems.patch ומעדכנים את הסטטוס ל-ENTITY_STATUS_ACTIVE אחרי היצירה.
  • אי אפשר לשנות את הסטטוס של פריט ל-ENTITY_STATUS_DRAFT מכל סטטוס אחר.
  • אם הזמנת ההכנסה הראשית של הפריט לא פעילה, הפריט לא יכול לנצל את התקציב שלו גם אם הסטטוס שלו הוא ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

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

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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)

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

אם מקצים מכסה מוגבלת, צריך להשתמש בשדה 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 ושותפים.
demandGenSettings

object (DemandGenSettings)

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

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

enum (EuPoliticalAdvertisingStatus)

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

אם הערך של containsEuPoliticalAds הוגדר ל-DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING במפרסם הראשי ולא צוין ערך אחר, השדה הזה יקבל את הערך DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING. אחר כך אפשר לעדכן את השדה הזה באמצעות ממשק המשתמש, ה-API או קבצים של נתונים מובנים.

צריך להקצות את השדה הזה כשיוצרים פריט חדש. אחרת, בקשת ה-advertisers.lineItems.create תיכשל.
optimizeFixedBidding

boolean

אופציונלי. האם להפעיל את האופטימיזציה של הצעות המחיר ב-DV360 לפריטים עם הצעת מחיר קבועה.

כברירת מחדל, מערכת DV360 מבצעת אופטימיזציה של הצעת המחיר הקבועה על ידי הפחתה אוטומטית של הצעות המחיר לחשיפות שפחות סביר שיניבו ביצועים טובים. האופטימיזציה הזו מופעלת כברירת מחדל (הערך הוא True).

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

ההגדרה הזו רלוונטית רק לפריטים עם biddingStrategy מסוג FIXED_BID.

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

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

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

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

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

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

בפריטים מקמפיינים ליצירת ביקוש, צריך להגדיר את השדה הזה בתור LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED.
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)

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

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

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

ConversionCountingConfig

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

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

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

string (int64 format)

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

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

object (TrackingFloodlightActivityConfig)

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

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

אי אפשר לעדכן את השדה הזה אם אלגוריתם בידינג מותאם אישית מוקצה לפריט. אם מגדירים את השדה הזה ומקצים אלגוריתם בידינג מותאם אישית באותה בקשה, הפעילויות ב-Floodlight צריכות להתאים לאלה שבהן משתמש אלגוריתם הבידינג המותאם אישית.
primaryAttributionModelId

string (int64 format)

אופציונלי. מודל השיוך (Attribution) שבו משתמשים למעקב המרות. מודל השיוך הזה יקבע איך ההמרות ייספרו. אתם יכולים להגדיר את המודל הראשי לקבוצה או לתצורה של 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 של אפל, למשל 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,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
שדות
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)

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

החשבון הזה ב-Merchant Center כבר צריך להיות מקושר למפרסם.
relatedVideos[]

object (RelatedVideo)

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

string (int64 format)

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

object (VideoAdSequenceSettings)

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

object (VideoAdInventoryControl)

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

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_ZEFR
  • 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
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

אופציונלי. ספקים חיצוניים שמודדים את Brand Lift.

אלה הספקים החיצוניים הרלוונטיים:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

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.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN מקור.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV iSpot TV.
THIRD_PARTY_VENDOR_INTAGE ‫Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH מחקר בווידאו.
THIRD_PARTY_VENDOR_AQUILA Aquila.

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
  • TIME_UNIT_MONTHS
timeUnitCount

integer

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

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

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

RelatedVideo

מייצג רשומה של סרטון קשור.

ייצוג ב-JSON 
{
  "videoId": string,
  "videoAssetId": string
}
שדות
videoId

string

פלט בלבד. מזהה הסרטון ב-YouTube של הסרטון הקשור.
videoAssetId

string (int64 format)

חובה. ה-adAssetId של המשאב AdAsset לסרטון ב-YouTube.

VideoAdSequenceSettings

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

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

enum (VideoAdSequenceMinimumDuration)

פרק הזמן המינימלי שצריך לעבור לפני שאותו משתמש יראה שוב את הרצף הזה.
steps[]

object (VideoAdSequenceStep)

השלבים שמרכיבים את הרצף.

VideoAdSequenceMinimumDuration

הערך של enum לפרק הזמן המינימלי האפשרי לפני שאותו משתמש יראה שוב את רצף מודעות הווידאו.

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

VideoAdInventoryControl

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

ייצוג ב-JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
שדות
allowInStream

boolean

אופציונלי. אם אפשר להציג מודעות בפורמט In-stream.
allowInFeed

boolean

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

boolean

אופציונלי. אם אפשר להציג מודעות בפורמט Shorts.
allowNonSkippableInStream

boolean

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

DemandGenSettings

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

ייצוג ב-JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
שדות
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

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

string (int64 format)

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

החשבון הזה ב-Merchant Center כבר צריך להיות מקושר למפרסם.
geoLanguageTargetingEnabled

boolean

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

Methods

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

 מחיקה של פריט.

duplicate

 משכפל פריט.

get

 מקבל פריט.

list

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

patch

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