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)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": 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)

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

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

פרטי השילוב של הפריט.
inventorySourceIds[]

string (int64 format)

המזהים של מקורות המלאי הפרטי שהוקצו לפריט.
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.

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

LineItemFlight

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

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

enum (LineItemFlightDateType)

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

object (DateRange)

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

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

string (int64 format)

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

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

אזהרה: פריטים שהוגדרו להם טריגרים ידניים לא מוצגים יותר בקמפיינים לרשת המדיה וידאו 360 השדה הזה ייסגר ב-1 באוגוסט 2023. למידע נוסף, אפשר לקרוא את ההודעה על הוצאה משימוש של תכונות.

LineItemFlightDateType

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

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

הפריט משתמש בטריגר.

אזהרה: פריטים שהוגדרו להם טריגרים ידניים לא מוצגים יותר בקמפיינים לרשת המדיה וידאו 360 הערך הזה ייסגר ב-1 באוגוסט 2023. למידע נוסף, אפשר לקרוא את ההודעה על הוצאה משימוש של תכונות.

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

TargetingExpansionConfig

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

ייצוג JSON 
{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
שדות
targetingExpansionLevel

enum (TargetingExpansionLevel)

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

השדה הזה תומך בערכים הבאים:

  • NO_EXPANSION: אופטימיזציית הטירגוט מושבתת
  • LEAST_EXPANSION: אופטימיזציית טירגוט מופעלת

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

NO_EXPANSION יהיה ערך ברירת המחדל בשדה, והוא יוקצה באופן אוטומטי אם לא מגדירים אותו.
excludeFirstPartyAudience
(deprecated)

boolean

הגדרה שקובעת אם מחריגים קהלים מאינטראקציה ישירה (First-Party) משימוש בהרחבת הטירגוט.

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

השדה הזה יוגדר בתור false. אם השדה הזה מוגדר לערך true כשהוא הוצא משימוש, כל הטירגוט החיובי לפי קהל מאינטראקציה ישירה שהוקצה לפריט הזה יוחלף בטירגוט שלילי של אותם קהלים מאינטראקציה ישירה, כדי להבטיח את המשך ההחרגה של הקהלים האלה.

TargetingExpansionLevel

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

טיפוסים בני מנייה (enum)
TARGETING_EXPANSION_LEVEL_UNSPECIFIED ההגדרה של אופטימיזציית הטירגוט לא צוינה או לא ידועה בגרסה הזו.
NO_EXPANSION אופטימיזציית הטירגוט מושבתת.
LEAST_EXPANSION אופטימיזציית הטירגוט מופעלת.
SOME_EXPANSION

אם ייעשה שימוש, הוא יוגדר באופן אוטומטי ל-LEAST_EXPANSION.
BALANCED_EXPANSION

אם ייעשה שימוש, הוא יוגדר באופן אוטומטי ל-LEAST_EXPANSION.
MORE_EXPANSION

אם ייעשה שימוש, הוא יוגדר באופן אוטומטי ל-LEAST_EXPANSION.
MOST_EXPANSION

אם ייעשה שימוש, הוא יוגדר באופן אוטומטי ל-LEAST_EXPANSION.

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 תאריך הסיום של הזמנת הקמפיין של הפריט הזה מוגדר בעבר. הפריט לא יפעל.
NO_POSITIVE_AUDIENCE_LIST_TARGETED הפריט הזה לא ממקד לרשימות קהלים, מה שעשוי להוביל לניצול מהיר מדי של התקציב.
APP_INSTALL_NO_CONVERSION_PIXEL לפריט הזה של התקנת אפליקציה עדיין לא הוגדר פיקסל המרה.
TARGETING_REVOKED_OR_CLOSED_USER_LIST הפריט הזה מטרגט רשימת משתמשים אחת או יותר שכבר לא זמינה. הגדרה כזו תמנע בעתיד את הצגת הפריט, לכן כדאי להסיר את הרשימות האלה מהטירגוט.
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY לפריט הזה לעידוד התקנת אפליקציה לא הוגדרה שיטת בידינג אופטימלית
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS הפריט הזה ממקד לעסקאות שתומכות בגודלי קראייטיב שלא נמצאים בשימוש. מצב כזה עשוי להגביל את ההצגה או הביצועים של הפריט.
NO_CREATIVE_FOR_TARGETED_DEALS הפריט הזה לא מכיל קריאייטיב עבור העסקאות המטורגטות.
TARGETING_DEPRECATED_GEO_TARGET הפריט הזה מטרגט טירגוט גיאוגרפי שהוצא משימוש.
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

הפריט הזה משתמש בהגדרה excludeFirstPartyAudience, שהוצאה משימוש ומתוכננת לצאת משימוש אחרי 25 במרץ 2023.

כדי להביא בחשבון את הסגירה של השדה excludeFirstPartyAudience, עליך לעדכן את השילוב של ה-API כך שיחריגו ישירות קהלים מאינטראקציה ישירה באמצעות טירגוט לפי קהל לפני 25 במרץ 2023.

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.

שיטות

bulkEditLineItemAssignedTargetingOptions

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

bulkListLineItemAssignedTargetingOptions

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

create

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

delete

 מוחק פריט.

generateDefault

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

get

 מקבל פריט.

list

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

patch

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