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 و حداکثر اندازه ۲۴۰ بایت کدگذاری شود.

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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 و Partners.

demandGenSettings

object ( DemandGenSettings )

اختیاری. تنظیمات مخصوص آیتم‌های ردیف Demand Gen.

فقط برای اقلام ردیف Demand Gen قابل اجرا است.

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 اعمال می‌شود.

نوع آیتم خطی

انواع ممکن یک آیتم خطی.

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

انوم‌ها
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 ads) در سفارش‌های درج OTT وجود دارند. این نوع فقط برای مواردی از سطر که ترتیب درج آنها insertionOrderType OVER_THE_TOP است، قابل استفاده است.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

تبلیغات ویدیویی یوتیوب (تا ۱۵ ثانیه) که نمی‌توان از آنها صرف نظر کرد.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

تبلیغات ویدیویی یوتیوب که داستانی را در یک توالی خاص با استفاده از ترکیبی از قالب‌ها نشان می‌دهند.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

تبلیغات صوتی یوتیوب

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

تبلیغات ویدیویی پیش‌فرض یوتیوب

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

تبلیغات ویدیویی یوتیوب (تا ۱۵ ثانیه) که نمی‌توان از آنها صرف نظر کرد.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

تبلیغات ویدیویی پیش‌فرض یوتیوب برای تلویزیون‌های متصل. فقط شامل فرمت تبلیغات در حال پخش می‌شود.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

تبلیغات ویدیویی یوتیوب که با هدف افزایش بازدید با فرمت‌های مختلف تبلیغاتی ارائه می‌شوند.

آیتم‌های خطی از این نوع و هدف‌گیری آنها را نمی‌توان با استفاده از 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 یا بعد از آن باشد، هر دو قبل از سال ۲۰۳۷.

نوع تاریخ پرواز

انواع احتمالی تاریخ‌های پرواز یک کالا.

انوم‌ها
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED مقدار نوع در این نسخه مشخص نشده یا ناشناخته است.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED تاریخ‌های پرواز هر سطر از ترتیب درج والدش به ارث می‌رسند.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM این آیتم از تاریخ‌های پرواز سفارشی خودش استفاده می‌کند.

بودجه اقلام خطی

تنظیماتی که نحوه تخصیص بودجه را کنترل می‌کنند.

نمایش 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)

حداکثر مبلغ بودجه‌ای که هر ردیف هزینه خواهد کرد. باید بزرگتر از ۰ باشد.

وقتی budgetAllocationType برابر است با:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC ، این فیلد تغییرناپذیر است و توسط سیستم تنظیم می‌شود.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED ، اگر budgetUnit برابر باشد با:
    • BUDGET_UNIT_CURRENCY ، این فیلد حداکثر مبلغ بودجه برای خرج کردن را بر حسب میکروواحد پول تبلیغ‌کننده نشان می‌دهد. برای مثال، ۱۵۰۰۰۰۰ نشان دهنده ۱.۵ واحد استاندارد از آن واحد پول است.
    • BUDGET_UNIT_IMPRESSIONS ، این فیلد حداکثر تعداد نمایش‌هایی که باید ارائه شود را نشان می‌دهد.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED ، این فیلد قابل استفاده نیست و توسط سیستم نادیده گرفته می‌شود.

نوع تخصیص بودجه ردیف

انواع احتمالی تخصیص بودجه

انوم‌ها
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED مقدار نوع در این نسخه مشخص نشده یا ناشناخته است.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC تخصیص خودکار بودجه برای ردیف مورد نظر فعال است.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED حداکثر مبلغ بودجه ثابتی برای هر ردیف اختصاص داده می‌شود.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED هیچ محدودیت بودجه‌ای برای ردیف ردیف اعمال نمی‌شود.

مدل درآمد شریک

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

نمایش JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
فیلدها
markupType

enum ( PartnerRevenueModelMarkupType )

الزامی. نوع افزایش قیمت مدل درآمدی شریک.

این فیلد باید برای ردیف‌های اقلام Demand Gen روی PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP تنظیم شود.

markupAmount

string ( int64 format)

الزامی. مبلغ اضافه بها برای مدل درآمدی شریک. باید بزرگتر یا مساوی ۰ باشد.

  • وقتی markupType روی PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM تنظیم شده باشد، این فیلد نشان‌دهنده‌ی نشانه‌گذاری CPM بر حسب میکروواحد پول تبلیغ‌کننده است. برای مثال، ۱۵۰۰۰۰۰ نشان‌دهنده‌ی ۱.۵ واحد استاندارد از آن واحد پول است.
  • وقتی markupType روی PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP تنظیم شده باشد، این فیلد درصد افزایش هزینه رسانه را بر حسب میلی‌لی نشان می‌دهد. برای مثال، ۱۰۰ نشان دهنده ۰.۱٪ (اعشاری ۰.۰۰۱) است.
  • وقتی markupType روی PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP تنظیم شده باشد، این فیلد نشان دهنده درصد کل هزینه رسانه بر حسب میلی‌لیتر است. برای مثال، ۱۰۰ نشان دهنده ۰.۱٪ (اعشاری ۰.۰۰۱) است.

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

انواع احتمالی افزایش قیمت برای مدل درآمدی شرکا.

انوم‌ها
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 درآمد شریک را بر اساس درصدی از کل هزینه رسانه‌ای آن، که شامل تمام هزینه‌های شریک و هزینه‌های داده می‌شود، محاسبه کنید.

پیکربندی شمارش تبدیل

تنظیماتی که نحوه شمارش تبدیل‌ها را کنترل می‌کنند.

تمام تبدیل‌های پس از کلیک شمارش می‌شوند. می‌توان برای شمارش تبدیل‌های پس از مشاهده، یک مقدار درصدی تعیین کرد.

نمایش JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
فیلدها
postViewCountPercentageMillis

string ( int64 format)

درصد تبدیل‌های پس از بازدید که باید شمارش شوند، بر حسب میلی (۱/۱۰۰۰ درصد). باید بین ۰ تا ۱۰۰۰۰۰ باشد.

برای مثال، برای ردیابی ۵۰٪ از تبدیل‌های پس از کلیک، مقدار ۵۰۰۰۰ را تعیین کنید.

floodlightActivityConfigs[]

object ( TrackingFloodlightActivityConfig )

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

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

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

primaryAttributionModelId

string ( int64 format)

اختیاری. مدل انتساب مورد استفاده برای اندازه‌گیری تبدیل. این مدل انتساب نحوه شمارش تبدیل‌ها را تعیین می‌کند. مدل اصلی را می‌توانید برای پیکربندی یا گروه نورافکن تنظیم کنید. جزئیات بیشتر اینجا .

فقط برای اقلام ردیف Demand Gen قابل اجرا است.

پیکربندی ردیابی نورافکنفعالیت

تنظیماتی که رفتار یک پیکربندی فعالیت Floodlight را کنترل می‌کنند.

نمایش JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
فیلدها
floodlightActivityId

string ( int64 format)

الزامی. شناسه‌ی فعالیت Floodlight.

postClickLookbackWindowDays

integer

الزامی. تعداد روزهایی که پس از کلیک روی تبلیغ، تبدیل (conversion) محاسبه می‌شود. باید بین ۰ تا ۹۰ باشد.

postViewLookbackWindowDays

integer

الزامی. تعداد روزهایی که پس از مشاهده تبلیغ، تبدیل (conversion) محاسبه می‌شود. باید بین ۰ تا ۹۰ باشد.

پیام هشدار آیتم خط

پیام‌های هشداری که توسط یک آیتم خطی ایجاد می‌شوند. این نوع هشدارها مانع ذخیره یک آیتم خطی نمی‌شوند، اما ممکن است مانع از اجرای آن شوند.

انوم‌ها
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 هدف‌گیری برنامه‌ها و آدرس‌های اینترنتی این آیتم خطی شامل هیچ برنامه تلفن همراهی نمی‌شود. این نوع آیتم خطی مستلزم آن است که برنامه‌های تلفن همراه را در هدف‌گیری کانال، لیست سایت یا برنامه‌های خود قرار دهید. این آیتم خطی اجرا نخواهد شد.
APP_INVENTORY_INVALID_AUDIENCE_LISTS این آیتم خطی هیچ کاربر موبایلی را هدف قرار نمی‌دهد. نوع این آیتم خطی ایجاب می‌کند که شما یک لیست کاربر با کاربران موبایل را هدف قرار دهید. این آیتم خطی اجرا نخواهد شد.
NO_VALID_CREATIVE این سطر شامل هیچ محتوای خلاقانه معتبری نیست. سطر اجرا نخواهد شد.
PARENT_INSERTION_ORDER_PAUSED ترتیب درج این سطر متوقف شده است. سطر اجرا نخواهد شد.
PARENT_INSERTION_ORDER_EXPIRED تاریخ پایان ترتیب درج این سطر، گذشته است. سطر اجرا نخواهد شد.

موبایل‌اپ

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

نمایش JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
فیلدها
appId

string

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

برنامه‌های اندروید توسط شناسه بسته‌ای (bundle ID) که توسط فروشگاه پلی استور اندروید استفاده می‌شود، مانند com.google.android.gm ، شناسایی می‌شوند.

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

platform

enum ( Platform )

فقط خروجی. پلتفرم برنامه.

displayName

string

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

publisher

string

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

پلتفرم

پلتفرم‌های احتمالی اپلیکیشن موبایل

انوم‌ها
PLATFORM_UNSPECIFIED پلتفرم مشخص نشده است.
IOS پلتفرم iOS.
ANDROID پلتفرم اندروید.

تنظیمات YoutubeAndPartners

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

نمایش 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 )

تنظیماتی که مشخص می‌کنند هر آیتم، کدام فهرست‌های یوتیوب و شرکا را هدف قرار دهد.

contentCategory

enum ( YoutubeAndPartnersContentCategory )

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

effectiveContentCategory

enum ( YoutubeAndPartnersContentCategory )

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

آیتم‌های خط جدید فقط تنظیمات سطح تبلیغ‌کننده را به ارث می‌برند.

targetFrequency

object ( TargetFrequency )

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

linkedMerchantId

string ( int64 format)

اختیاری. شناسه حساب مرکز فروشندگان که برای ارائه فید محصول استفاده می‌شود.

این حساب مرکز بازرگانان باید از قبل به تبلیغ‌کننده مرتبط باشد.

relatedVideoIds[]

string

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

leadFormId

string ( int64 format)

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

videoAdSequenceSettings

object ( VideoAdSequenceSettings )

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

videoAdInventoryControl

object ( VideoAdInventoryControl )

اختیاری. تنظیمات مربوط به کنترل موجودی مجاز برای این ردیف کالا.

پیکربندی‌های اندازه‌گیری شخص ثالث

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

نمایش 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

پیکربندی فروشنده شخص ثالث

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

نمایش JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
فیلدها
vendor

enum ( ThirdPartyVendor )

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

placementId

string

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

فروشنده شخص ثالث

فروشندگانی که اندازه‌گیری توسط شخص ثالث را انجام می‌دهند.

انوم‌ها
THIRD_PARTY_VENDOR_UNSPECIFIED فروشنده شخص ثالث ناشناس.
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 معیارها
THIRD_PARTY_VENDOR_ZEFR زفر
THIRD_PARTY_VENDOR_NIELSEN نیلسن
THIRD_PARTY_VENDOR_KANTAR کانتار
THIRD_PARTY_VENDOR_DYNATA دیناتا
THIRD_PARTY_VENDOR_TRANSUNION اتحادیه ترانسیون.
THIRD_PARTY_VENDOR_ORIGIN منشأ.
THIRD_PARTY_VENDOR_GEMIUS گمیوس
THIRD_PARTY_VENDOR_MEDIA_SCOPE مدیااسکوپ
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT پروژه مخاطبان.
THIRD_PARTY_VENDOR_VIDEO_AMP آمپلی فایر ویدیویی
THIRD_PARTY_VENDOR_ISPOT_TV تلویزیون ایسپات
THIRD_PARTY_VENDOR_INTAGE اینتاژ
THIRD_PARTY_VENDOR_MACROMILL ماکرومیل
THIRD_PARTY_VENDOR_VIDEO_RESEARCH تحقیقات ویدیویی.

پیکربندی منبع موجودی یوتیوب و شرکا

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

نمایش JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
فیلدها
includeYoutube

boolean

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

includeGoogleTv

boolean

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

includeYoutubeVideoPartners

boolean

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

دسته‌بندی محتوا یوتیوب و شرکا

دسته‌بندی‌های ایمنی برند برای محتوای یوتیوب و شرکا.

انوم‌ها
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED دسته بندی محتوا در این نسخه مشخص نشده یا ناشناخته است.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD دسته‌ای شامل طیف گسترده‌ای از محتوا که برای اکثر برندها مناسب است. این محتوا بر اساس دستورالعمل‌های محتوای مناسب برای تبلیغ‌کنندگان یوتیوب تهیه شده است.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED دسته‌ای شامل تمام محتوای یوتیوب و شرکای ویدیویی که استانداردهای کسب درآمد را رعایت می‌کنند.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED دسته‌ای متشکل از طیف محدودی از محتوا که الزامات سختگیرانه‌تری را برآورده می‌کند، به‌ویژه در مورد زبان نامناسب و القای جنسی.

فرکانس هدف

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

نمایش 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 - باید ۱ باشد

تنظیمات توالی تبلیغات ویدیویی

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

نمایش JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
فیلدها
minimumDuration

enum ( VideoAdSequenceMinimumDuration )

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

steps[]

object ( VideoAdSequenceStep )

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

VideoAdSequenceMinimumDuration

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

انوم‌ها
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED نامشخص یا نامعلوم.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK ۷ روز.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH ۳۰ روز.

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 )

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

نوع تعامل

انواع تعامل روی یک پله.

انوم‌ها
INTERACTION_TYPE_UNSPECIFIED نامشخص یا نامعلوم
INTERACTION_TYPE_PAID_VIEW یک نمای پولی.
INTERACTION_TYPE_SKIP از دید بیننده پنهان مانده است.
INTERACTION_TYPE_IMPRESSION یک نمایش تبلیغ (مشاهده شده).
INTERACTION_TYPE_ENGAGED_IMPRESSION نمایش تبلیغی که بیننده بلافاصله از آن صرف نظر نکرد، اما به رویداد قابل پرداخت هم نرسید.

کنترل موجودی تبلیغات ویدیویی

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

نمایش JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
فیلدها
allowInStream

boolean

اختیاری. اینکه آیا تبلیغات می‌توانند به صورت فرمت درون استریم ارائه شوند یا خیر.

allowInFeed

boolean

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

allowShorts

boolean

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

تنظیمات تولید تقاضا

تنظیمات مربوط به ردیف‌های اقلام تقاضامحور.

نمایش JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
فیلدها
thirdPartyMeasurementConfigs

object ( ThirdPartyMeasurementConfigs )

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

linkedMerchantId

string ( int64 format)

اختیاری. شناسه حساب مرکز فروشندگان که برای ارائه فید محصول استفاده می‌شود.

این حساب مرکز بازرگانان باید از قبل به تبلیغ‌کننده مرتبط باشد.

geoLanguageTargetingEnabled

boolean

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

روش‌ها

bulkEditAssignedTargetingOptions

 ویرایش‌های دسته‌جمعی، گزینه‌های هدف‌گیری را در زیر چندین مورد خطی قرار می‌دهند.

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

 یک آیتم خطی جدید ایجاد می‌کند.

delete

 یک آیتم خطی را حذف می‌کند.

duplicate

 یک آیتم خطی را کپی می‌کند.

get

 یک آیتم خطی دریافت می‌کند.

list

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

patch

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