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)
  }
}
زمینه های
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 )

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

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 و Partners.

LineItemType

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

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

Enums
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 تبلیغات فوق‌العاده در سفارش‌های درج OTT وجود دارد. این نوع فقط برای موارد خط با ترتیب درج insertionOrderType OVER_THE_TOP قابل استفاده است.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

تبلیغات ویدیویی یوتیوب (حداکثر 15 ثانیه) که نمی توان آنها را نادیده گرفت.

موارد خطی از این نوع و هدف گذاری آنها را نمی توان با استفاده از 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

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

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

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

تبلیغات ویدئویی YouTube TV متصل (حداکثر 15 ثانیه) که نمی‌توان از آنها رد شد.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

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

موارد خطی از این نوع و هدف گذاری آنها را نمی توان با استفاده از 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

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

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

LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

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

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

LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

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

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

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 یا بالاتر باشد، هر دو قبل از سال 2037.

LineItemFlightDateType

انواع احتمالی تاریخ پرواز یک آیتم خط.

Enums
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 فقط زمانی قابل اعمال است که تخصیص خودکار بودجه برای سفارش درج والد فعال باشد.

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 ، این فیلد حداکثر مقدار بودجه برای خرج کردن را در میکرو واحد پول تبلیغ‌کننده نشان می‌دهد. به عنوان مثال، 1500000 نشان دهنده 1.5 واحد استاندارد واحد پول است.
    • BUDGET_UNIT_IMPRESSIONS ، این فیلد نشان دهنده حداکثر تعداد نمایش برای ارائه است.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED ، این فیلد قابل اجرا نیست و توسط سیستم نادیده گرفته خواهد شد.

LineItemBudgetAllocationType

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

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

PartnerRevenueModelMarkupType

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

Enums
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/1000 درصد). باید بین 0 تا 100000 باشد.

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

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

LineItemWarning Message

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

Enums
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 ترتیب درج این آیتم خط تاریخ پایان آن در گذشته تنظیم شده است. مورد خط اجرا نمی شود.
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

این مورد از تنظیم excludeFirstPartyAudience استفاده می‌کند، که منسوخ شده و برای غروب آفتاب پس از ۲۵ مارس ۲۰۲۳ برنامه‌ریزی شده است.

یکپارچه‌سازی API خود را به‌روزرسانی کنید تا مستقیماً مخاطبان شخص اول را با استفاده از هدف‌یابی مخاطب قبل از ۲۵ مارس ۲۰۲۳ حذف کنید تا غروب قسمت excludeFirstPartyAudience را در نظر بگیرید.

اپلیکیشن موبایل

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

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

string

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

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

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

platform

enum ( Platform )

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

displayName

string

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

publisher

string

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

سکو

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

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

تنظیمات YouTubeAndPartners

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

نمایندگی JSON
{
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementSettings": {
    object (YoutubeAndPartnersThirdPartyMeasurementSettings)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
زمینه های
biddingStrategy

object ( YoutubeAndPartnersBiddingStrategy )

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

viewFrequencyCap

object ( FrequencyCap )

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

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

thirdPartyMeasurementSettings

object ( YoutubeAndPartnersThirdPartyMeasurementSettings )

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

inventorySourceSettings

object ( YoutubeAndPartnersInventorySourceConfig )

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

contentCategory

enum ( YoutubeAndPartnersContentCategory )

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

effectiveContentCategory

enum ( YoutubeAndPartnersContentCategory )

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

targetFrequency

object ( TargetFrequency )

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

linkedMerchantId

string ( int64 format)

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

relatedVideoIds[]

string

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

leadFormId

string ( int64 format)

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

videoAdSequenceSettings

object ( VideoAdSequenceSettings )

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

YoutubeAndPartnersThirdPartyMeasurementSettings

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

نمایندگی 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_ZERF
  • 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
brandLiftVendorConfigs[]

object ( ThirdPartyVendorConfig )

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

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

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

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

نمایندگی JSON
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
زمینه های
vendor

enum ( ThirdPartyVendor )

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

placementId

string

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

ThirdPartyVendor

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

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED فروشنده شخص ثالث ناشناس.
THIRD_PARTY_VENDOR_MOAT خندق.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE علم تبلیغات یکپارچه
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY تله متری.
THIRD_PARTY_VENDOR_MEETRICS متریک ها
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN نیلسن
THIRD_PARTY_VENDOR_KANTAR کانتار.
THIRD_PARTY_VENDOR_DYNATA دیناتا

YoutubeAndPartnersInventorySourceConfig

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

نمایندگی JSON
{
  "includeYoutubeSearch": boolean,
  "includeYoutubeVideos": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
زمینه های
includeYoutubeVideos

boolean

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

includeGoogleTv

boolean

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

includeYoutubeVideoPartners

boolean

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

YouTubeAndPartnersCategory محتوای

دسته‌های ایمنی برند برای محتوای YouTube و Partners.

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

فرکانس هدف

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

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

VideoAdSequenceSettings

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

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

enum ( VideoAdSequenceMinimumDuration )

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

steps[]

object ( VideoAdSequenceStep )

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

VideoAdSequenceMinimumDuration

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

Enums
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED نامشخص یا ناشناخته.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 روز.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 روز.

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 ندارد.

نوع تعامل

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

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

مواد و روش ها

bulkEditAssignedTargetingOptions

 انبوه گزینه های هدف را در زیر چند مورد خط ویرایش می کند.

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

 یک مورد خطی را حذف می کند.

duplicate

 یک مورد خطی را کپی می کند.

generateDefault

 یک مورد خط جدید با تنظیمات (از جمله هدف‌یابی) به ارث رسیده از ترتیب درج و یک ENTITY_STATUS_DRAFT entity_status ایجاد می‌کند.

get

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

list

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

patch

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