REST Resource: advertisers.lineItems

{
  "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
}

string

فقط خروجی نام منبع مورد خط.

string ( int64 format)

فقط خروجی شناسه منحصربه‌فرد تبلیغ‌کننده‌ای که مورد خط به آن تعلق دارد.

string ( int64 format)

فقط خروجی شناسه منحصر به فرد کمپین که مورد خط به آن تعلق دارد.

string ( int64 format)

مورد نیاز. تغییرناپذیر. شناسه منحصر به فرد سفارش درج که مورد خط به آن تعلق دارد.

string ( int64 format)

فقط خروجی شناسه منحصر به فرد مورد خط. توسط سیستم تعیین شده است.

string

مورد نیاز. نام نمایشی مورد خط.

باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود.

enum ( LineItemType )

مورد نیاز. تغییرناپذیر. نوع آیتم خط.

enum ( EntityStatus )

مورد نیاز. کنترل می کند که آیا آیتم خطی می تواند بودجه و پیشنهاد قیمت خود را صرف موجودی کند یا خیر.

• برای روش lineItems.create ، فقط ENTITY_STATUS_DRAFT مجاز است. برای فعال کردن یک آیتم خط، از روش lineItems.patch استفاده کنید و وضعیت را پس از ایجاد به ENTITY_STATUS_ACTIVE به روز کنید.
• یک مورد خطی را نمی توان از هر وضعیت دیگری به وضعیت ENTITY_STATUS_DRAFT تغییر داد.
• اگر سفارش درج والد مورد خط فعال نباشد، آن مورد نمی‌تواند بودجه خود را خرج کند حتی اگر وضعیت خودش ENTITY_STATUS_ACTIVE باشد.

string ( Timestamp format)

فقط خروجی مُهر زمانی آخرین به‌روزرسانی مورد خط. توسط سیستم تعیین شده است.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( PartnerCost )

هزینه های شریک مرتبط با آیتم خط.

اگر در روش lineItems.create وجود نداشته باشد یا خالی باشد، مورد خط جدید ایجاد شده هزینه‌های شریک را از ترتیب درج والد خود به ارث می‌برد.

object ( LineItemFlight )

مورد نیاز. زمان شروع و پایان پرواز خط مورد.

object ( LineItemBudget )

مورد نیاز. تنظیم تخصیص بودجه آیتم خط.

object ( Pacing )

مورد نیاز. تنظیم سرعت هزینه بودجه آیتم خط.

object ( FrequencyCap )

مورد نیاز. تنظیمات درب فرکانس نمایش مورد خط.

فیلد maxImpressions در این شی تنظیمات باید در صورت اختصاص یک سرپوش محدود استفاده شود.

object ( PartnerRevenueModel )

مورد نیاز. تنظیم مدل درآمد شریک مورد خط.

object ( ConversionCountingConfig )

تنظیم ردیابی تبدیل مورد خط.

string ( int64 format)

شناسه‌های خلاقیت‌های مرتبط با مورد خط.

object ( BiddingStrategy )

مورد نیاز. استراتژی مناقصه مورد خط.

object ( IntegrationDetails )

جزئیات یکپارچه سازی مورد خط.

string ( int64 format)

شناسه منابع موجودی خصوصی اختصاص داده شده به آیتم خط.

object ( TargetingExpansionConfig )

تنظیمات هدف گذاری بهینه مورد خط.

این پیکربندی فقط برای موارد صفحه نمایش، ویدیو یا صوتی که از مناقصه خودکار استفاده می‌کنند و فهرست‌های مخاطبان واجد شرایط را هدف قرار می‌دهند، قابل اجرا است.

enum ( LineItemWarningMessage )

فقط خروجی پیام های هشدار تولید شده توسط مورد خط. این اخطارها ذخیره آیتم خط را مسدود نمی‌کنند، اما برخی ممکن است اجرای آیتم خط را مسدود کنند.

object ( MobileApp )

برنامه تلفن همراه که توسط مورد خط تبلیغ می شود.

این فقط زمانی قابل اعمال است که نوع lineItemType LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL یا LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL باشد.

enum ( ReservationType )

فقط خروجی نوع رزرو مورد خط.

boolean

آیا مبادلات جدید از هدف قرار گرفتن خودکار توسط آیتم خط حذف می شوند یا خیر. این فیلد به طور پیش فرض نادرست است.

{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}

enum ( LineItemFlightDateType )

مورد نیاز. نوع تاریخ پرواز مورد خط.

object ( DateRange )

تاریخ شروع و پایان پرواز مورد خط. آنها نسبت به منطقه زمانی تبلیغ کننده اصلی حل می شوند.

• زمانی که flightDateType LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM باشد، الزامی است. خروجی فقط در غیر این صورت.
• هنگام ایجاد یک پرواز جدید، هر دو startDate و endDate باید در آینده باشند.
• پرواز موجود با startDate در گذشته دارای endDate قابل تغییر است اما startDate غیرقابل تغییر دارد.
• endDate باید startDate یا بالاتر باشد، هر دو قبل از سال 2037.

string ( int64 format)

شناسه راه‌انداز دستی مرتبط با مورد خط.

• زمانی که flightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER باشد الزامی است. در غیر این صورت نباید تنظیم شود.
• در صورت تنظیم، تاریخ پرواز مورد خط از ترتیب درج والد آن به ارث می رسد.
• زمانی که محرک انتخابی در تاریخ پرواز سفارش درج والد فعال شود، موارد خط فعال هزینه می‌شوند.

هشدار: موارد خطی که از محرک‌های دستی استفاده می‌کنند، دیگر در Display & Video 360 استفاده نمی‌شوند. این فیلد در 1 اوت 2023 غروب می‌کند. برای اطلاعات بیشتر اعلامیه لغو ویژگی ما را بخوانید.

{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}

enum ( LineItemBudgetAllocationType )

مورد نیاز. نوع تخصیص بودجه

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC فقط زمانی قابل اعمال است که تخصیص خودکار بودجه برای سفارش درج والد فعال باشد.

enum ( BudgetUnit )

فقط خروجی واحد بودجه مشخص می کند که آیا بودجه مبتنی بر ارز است یا بر اساس برداشت. این مقدار از ترتیب درج والد به ارث می رسد.

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 ، این فیلد قابل اجرا نیست و توسط سیستم نادیده گرفته خواهد شد.

{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}

enum ( PartnerRevenueModelMarkupType )

مورد نیاز. نوع نشانه گذاری مدل درآمد شریک.

string ( int64 format)

مورد نیاز. مقدار نشانه گذاری مدل درآمد شریک. باید بزرگتر یا مساوی 0 باشد.

• وقتی markupType روی PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM تنظیم شده است، این فیلد نشان‌گذاری 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) است.

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string ( int64 format)

درصد تبدیل‌های پس از مشاهده برای شمارش، بر حسب میلی‌متر (1/1000 درصد). باید بین 0 تا 100000 باشد.

به عنوان مثال، برای ردیابی 50٪ از تبدیل های پس از کلیک، مقدار 50000 را تعیین کنید.

object ( TrackingFloodlightActivityConfig )

تنظیمات فعالیت Floodlight که برای ردیابی تبدیل ها استفاده می شود.

تعداد تبدیل‌های شمارش‌شده، مجموع همه تبدیل‌های شمارش‌شده توسط همه شناسه‌های فعالیت Floodlight مشخص‌شده در این فیلد است.

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string ( int64 format)

مورد نیاز. شناسه فعالیت Floodlight.

integer

مورد نیاز. تعداد روزهایی که پس از کلیک روی یک تبلیغ ممکن است در آن تبدیل حساب شود. باید بین 0 تا 90 باشد.

integer

مورد نیاز. تعداد روزهای پس از مشاهده یک آگهی که در آن تبدیل ممکن است شمارش شود. باید بین 0 تا 90 باشد.

{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}

enum ( TargetingExpansionLevel )

مورد نیاز. آیا هدف‌یابی بهینه‌سازی شده روشن است یا خیر.

این فیلد از مقادیر زیر پشتیبانی می کند:

• NO_EXPANSION : هدف‌گیری بهینه خاموش است
• LEAST_EXPANSION : هدف‌گیری بهینه روشن است

اگر این فیلد روی مقدار دیگری تنظیم شود، به طور خودکار روی LEAST_EXPANSION تنظیم می شود.

NO_EXPANSION مقدار پیش‌فرض فیلد خواهد بود و اگر فیلد را تنظیم نکنید، به‌طور خودکار به آن اختصاص داده می‌شود.

boolean

آیا برای حذف مخاطبان شخص اول از استفاده در توسعه هدف.

این فیلد با راه‌اندازی هدف‌یابی بهینه منسوخ شد.

این فیلد روی false تنظیم می شود. اگر این فیلد در هنگام منسوخ شدن روی true تنظیم شود، همه هدف‌یابی مخاطبان شخص اول مثبت اختصاص داده شده به این مورد با هدف‌گیری منفی همان مخاطبان شخص اول جایگزین می‌شود تا از مستثنی ماندن مستمر آن مخاطبان اطمینان حاصل شود.

{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}

string

مورد نیاز. شناسه برنامه ارائه شده توسط فروشگاه پلتفرم.

برنامه‌های Android با شناسه بسته مورد استفاده توسط فروشگاه Play Android، مانند com.google.android.gm شناسایی می‌شوند.

برنامه‌های iOS با یک شناسه برنامه نه رقمی که توسط فروشگاه App اپل استفاده می‌شود، مانند 422689480 شناسایی می‌شوند.

enum ( Platform )

فقط خروجی پلت فرم اپلیکیشن

string

فقط خروجی نام برنامه

string

فقط خروجی ناشر اپلیکیشن