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-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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

اینکه آیا صرافی‌های جدید از هدف‌یابی خودکار توسط ردیف کنار گذاشته شوند یا نه. این فیلد به‌طور پیش‌فرض نادرست است.
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

انواع احتمالی مورد سطری.

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

شمارشی‌ها
LINE_ITEM_TYPE_UNSPECIFIED

مقدار نوع مشخص نشده است یا در این نسخه ناشناخته است.

اقلام ردیفی از این نوع و هدف‌یابی آن‌ها را نمی‌توان بااستفاده از API ایجاد یا به‌روزرسانی کرد.
LINE_ITEM_TYPE_DISPLAY_DEFAULT آگهی‌های تصویری، HTML5، بومی، یا رسانه تعاملی.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL آگهی‌های تصویری که نصب برنامه را افزایش می‌دهند.
LINE_ITEM_TYPE_VIDEO_DEFAULT آگهی‌های ویدیویی براساس هزارظهوربها برای محیط‌های مختلف فروخته می‌شوند.
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 موجود در دستورهای درج OTT. این نوع فقط برای موارد سطری با دستور درج insertionOrderType OVER_THE_TOP قابل اعمال است.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

آگهی‌های ویدیویی YouTube که تبدیل‌ها را تبلیغ می‌کنند.

اقلام ردیفی از این نوع و هدف‌یابی آن‌ها را نمی‌توان بااستفاده از API ایجاد یا به‌روزرسانی کرد.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

آگهی‌های ویدیویی YouTube (تا ۱۵ ثانیه) که نمی‌توان آن‌ها را رد کرد.

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

اقلام ردیفی از این نوع و هدف‌یابی آن‌ها را نمی‌توان بااستفاده از API ایجاد یا به‌روزرسانی کرد.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

آگهی‌های ویدیویی پیش‌فرض YouTube.

اقلام ردیفی از این نوع و هدف‌یابی آن‌ها را نمی‌توان بااستفاده از API ایجاد یا به‌روزرسانی کرد.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

آگهی‌های ویدیویی YouTube در تلویزیون متصل (تا ۱۵ ثانیه) که نمی‌توان آن‌ها را رد کرد.

اقلام ردیفی از این نوع و هدف‌یابی آن‌ها را نمی‌توان بااستفاده از API ایجاد یا به‌روزرسانی کرد.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

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

اقلام ردیفی از این نوع و هدف‌یابی آن‌ها را نمی‌توان بااستفاده از API ایجاد یا به‌روزرسانی کرد.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

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

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

LineItemFlightDateType

انواع ممکن تاریخ‌های پرواز مورد سطری.

شمارشی‌ها
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)

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

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

LineItemBudgetAllocationType

انواع ممکن اختصاص بودجه.

شمارشی‌ها
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)

الزامی. مقدار افزایش قیمت مدل درآمد شریک. باید بزرگ‌تر یا مساوی با ۰ باشد.

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

PartnerRevenueModelMarkupType

انواع نشان‌گذاری احتمالی مدل درآمد شریک.

شمارشی‌ها
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)
    }
  ],
  "primaryAttributionModelId": string
}
فیلدها
postViewCountPercentageMillis

string (int64 format)

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

برای مثال، برای پیگیری ۵۰٪ از تبدیل‌های پس‌از کلیک، مقدار را روی ۵۰۰۰۰ تنظیم کنید.
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

الزامی. تعداد روزهای پس‌از کلیک شدن آگهی که طی آن تبدیل ممکن است محاسبه شود. باید بین ۰ و ۹۰ باشد.
postViewLookbackWindowDays

integer

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

LineItemWarningMessage

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

شمارشی‌ها
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 تاریخ پایان سفارش درج این ردیف در گذشته تنظیم شده است. ردیف اجرا نخواهد شد.

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

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

پلاتفرم

پلاتفرم‌های ممکن برنامه تلفن همراه.

شمارشی‌ها
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,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "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 باید ازقبل به تبلیغ‌کننده پیوند شده باشد.
relatedVideos[]

object (RelatedVideo)

اختیاری. ویدیوهای مرتبط برای این مورد خطی. این ویدیوها هنگام پخش در برنامه 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_MACROMILL

ThirdPartyVendorConfig

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

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

enum (ThirdPartyVendor)

فروشنده سنجش طرف سوم.
placementId

string

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

ThirdPartyVendor

فروشندگانی که سنجش طرف سوم را انجام می‌دهند.

شمارشی‌ها
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 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 تحقیق ویدیویی.
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

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

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

boolean

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

boolean

اختیاری. اینکه موجودی کالا در برنامه‌های ویدیویی دردسترس با Google TV هدف‌یابی شود یا نه.
includeYoutubeVideoPartners

boolean

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

YoutubeAndPartnersContentCategory

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

شمارشی‌ها
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
  • TIME_UNIT_MONTHS
timeUnitCount

integer

تعداد timeUnit که بسامد هدف ادامه خواهد داشت.

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

  • ‫TIME_UNIT_WEEKS - باید ۱ باشد
  • ‫TIME_UNIT_MONTHS - باید ۱ باشد

RelatedVideo

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

نمایش JSON 
{
  "videoId": string,
  "videoAssetId": string
}
فیلدها
videoId

string

فقط خروجی. شناسه ویدیو YouTube مربوط به ویدیو مرتبط.
videoAssetId

string (int64 format)

الزامی. adAssetId منبع AdAsset برای ویدیو YouTube.

VideoAdSequenceSettings

تنظیمات مربوط به 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)

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

InteractionType

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

شمارشی‌ها
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,
  "allowNonSkippableInStream": boolean
}
فیلدها
allowInStream

boolean

اختیاری. آیا آگهی‌ها می‌توانند در قالب آگهی در جاری‌سازی ارائه شوند.
allowInFeed

boolean

اختیاری. آیا آگهی‌ها می‌توانند در قالب آگهی در فید ارائه شوند.
allowShorts

boolean

اختیاری. آیا آگهی‌ها می‌توانند در قالب فیلم‌های کوتاه YouTube ارائه شوند.
allowNonSkippableInStream

boolean

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

DemandGenSettings

تنظیمات ردیف‌های «تولید تقاضا».

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

object (ThirdPartyMeasurementConfigs)

اختیاری. تنظیمات سنجش طرف سوم برای ردیف «تولید تقاضا».
linkedMerchantId

string (int64 format)

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

این حساب Merchant Center باید ازقبل به تبلیغ‌کننده پیوند شده باشد.
geoLanguageTargetingEnabled

boolean

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

روش‌ها

bulkEditAssignedTargetingOptions

 ویرایش‌های انبوه گزینه‌های هدف‌یابی را در چندین ردیف هدف قرار می‌دهد.

bulkListAssignedTargetingOptions

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

bulkUpdate

 چندین ردیف را به‌روز می‌کند.

create

 مورد خطی جدیدی ایجاد می‌کند.

delete

 ردیف را حذف می‌کند.

duplicate

 ردیف را تکرار می‌کند.

get

 ردیف را دریافت می‌کند.

list

 موارد سطری را در آگهی‌دهنده فهرست می‌کند.

patch

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