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. כדי להפעיל פריט, משתמשים בשיטה 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 מודעות 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 לטלוויזיות מחוברות (עד 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 שמוצגות כברירת מחדל בטלוויזיה מחוברת (CTV). כוללים רק פורמט של מודעת וידאו 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 פריטים מסוג כזה ואת הגדרות הטירגוט שלהם.
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/1000 של אחוז). הערך חייב להיות בין 0 ל-100,000 כולל.

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

object (TrackingFloodlightActivityConfig)

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

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

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

string (int64 format)

אופציונלי. מודל השיוך שבו רוצים להשתמש למעקב המרות. מודל השיוך הזה יקבע איך ההמרות ייספרו. אתם יכולים להגדיר את המודל הראשי עבור קבוצה או הגדרה של 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 מזוהות באמצעות מזהה אפליקציה בן 9 ספרות שמשמש את 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,
  "relatedVideoIds": [
    string
  ],
  "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 הזה כבר צריך להיות מקושר למפרסם.
relatedVideoIds[]

string

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

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

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

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_NIELSEN
  • 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 פרויקט של קהלים.
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 VideoResearch

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

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

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

VideoAdSequenceStep

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

ייצוג 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
}
שדות
allowInStream

boolean

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

boolean

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

boolean

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

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

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