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

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 )

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

object ( TargetingExpansionConfig )

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

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

enum ( LineItemWarningMessage )

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

object ( MobileApp )

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

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

enum ( ReservationType )

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

boolean

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

object ( YoutubeAndPartnersSettings )

فقط خروجی تنظیمات مخصوص موارد خط YouTube و Partners.

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

enum ( LineItemFlightDateType )

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

object ( DateRange )

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

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

{
  "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 باشد.

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

string

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

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

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

enum ( Platform )

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

string

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

string

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

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

object ( FrequencyCap )

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

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

object ( ThirdPartyMeasurementConfigs )

اختیاری. پیکربندی های اندازه گیری شخص ثالث مورد خط.

object ( YoutubeAndPartnersInventorySourceConfig )

تنظیماتی که میزان موجودی YouTube و Partners را که مورد خط هدف قرار می‌دهد را کنترل می‌کند.

enum ( YoutubeAndPartnersContentCategory )

نوع محتوایی که تبلیغات YouTube و Partners در آن نشان داده می‌شود.

enum ( YoutubeAndPartnersContentCategory )

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

object ( TargetFrequency )

اختیاری. میانگین تعداد دفعاتی که می‌خواهید آگهی‌های این آیتم خطی در یک بازه زمانی مشخص به یک شخص نشان داده شود.

string ( int64 format)

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

string

اختیاری. وقتی تبلیغ در برنامه YouTube در دستگاه‌های تلفن همراه پخش می‌شود، شناسه‌های ویدیوها در زیر آگهی ویدیوی اصلی ظاهر می‌شوند.

string ( int64 format)

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

object ( VideoAdSequenceSettings )

اختیاری. تنظیمات مربوط به VideoAdSequence.

{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}

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

object ( ThirdPartyVendorConfig )

اختیاری. فروشندگان شخص ثالث ایمنی برند را اندازه گیری می کنند.

فروشندگان شخص ثالث زیر قابل اجرا هستند:

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

object ( ThirdPartyVendorConfig )

اختیاری. فروشندگان شخص ثالث در حال اندازه گیری میزان دسترسی هستند.

فروشندگان شخص ثالث زیر قابل اجرا هستند:

• THIRD_PARTY_VENDOR_NIELSEN
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_KANTAR

object ( ThirdPartyVendorConfig )

اختیاری. فروشندگان شخص ثالث افزایش برند را اندازه می‌گیرند.

فروشندگان شخص ثالث زیر قابل اجرا هستند:

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}

enum ( ThirdPartyVendor )

فروشنده شخص ثالث اندازه گیری.

string

شناسه مورد استفاده توسط پلتفرم فروشنده شخص ثالث برای شناسایی مورد خط.

{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

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

boolean

اختیاری. آیا می‌توان موجودی در برنامه‌های ویدیویی موجود با Google TV را هدف قرار داد.

boolean

آیا می‌توان موجودی را در مجموعه‌ای از سایت‌ها و برنامه‌های شریک که از استانداردهای ایمنی نام تجاری مشابه YouTube پیروی می‌کنند، هدف قرار داد.

{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}

string ( int64 format)

تعداد دفعات مورد نظر، به طور متوسط، تبلیغات به همان شخص در بازه زمانی دیکته شده توسط timeUnit و timeUnitCount نشان داده می شود.

enum ( TimeUnit )

واحد زمانی که فرکانس هدف در آن اعمال خواهد شد.

واحد زمانی زیر قابل اجرا است:

• TIME_UNIT_WEEKS

integer

تعداد timeUnit فرکانس هدف دوام خواهد آورد.

محدودیت های زیر بر اساس مقدار timeUnit اعمال می شود:

• TIME_UNIT_WEEKS - باید 1 باشد

{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}

enum ( VideoAdSequenceMinimumDuration )

حداقل فاصله زمانی قبل از اینکه همان کاربر دوباره این توالی را ببیند.

object ( VideoAdSequenceStep )

مراحلی که دنباله از آنها تشکیل شده است.

{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}

string ( int64 format)

شناسه مرحله.

string ( int64 format)

شناسه گروه تبلیغاتی مربوطه مرحله.

string ( int64 format)

شناسه مرحله قبل مرحله اول مرحله قبلی ندارد.

enum ( InteractionType )

تعامل در مرحله قبل که بیننده را به این مرحله سوق می دهد. مرحله اول interactionType ندارد.