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)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}
فیلدها
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 )

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

inventorySourceIds[]

string ( int64 format)

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

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

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

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 قابل استفاده است.

LineItemFlight

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

نمایندگی JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}
فیلدها
flightDateType

enum ( LineItemFlightDateType )

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

dateRange

object ( DateRange )

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

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

string ( int64 format)

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

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

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

LineItemFlightDateType

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

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

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

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

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

TargetingExpansionConfig

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

نمایندگی JSON 
{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
فیلدها
targetingExpansionLevel

enum ( TargetingExpansionLevel )

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

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

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

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

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

excludeFirstPartyAudience
(deprecated)

boolean

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

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

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

TargetingExpansionLevel

تنظیمات هدف گیری بهینه

Enums
TARGETING_EXPANSION_LEVEL_UNSPECIFIED تنظیم هدف بهینه شده در این نسخه مشخص نشده یا ناشناخته است.
NO_EXPANSION هدف گیری بهینه خاموش است.
LEAST_EXPANSION هدف‌گیری بهینه روشن است.
SOME_EXPANSION

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

BALANCED_EXPANSION

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

MORE_EXPANSION

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

MOST_EXPANSION

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

LineItemWarningMessage

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

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 ترتیب درج این آیتم خط تاریخ پایان آن در گذشته تنظیم شده است. مورد خط اجرا نمی شود.
NO_POSITIVE_AUDIENCE_LIST_TARGETED این مورد هیچ لیست مخاطبی را هدف قرار نمی دهد، که ممکن است باعث شود بودجه شما خیلی سریع خرج شود.
APP_INSTALL_NO_CONVERSION_PIXEL این مورد خط نصب برنامه هیچ پیکسل تبدیلی تنظیم نشده است.
TARGETING_REVOKED_OR_CLOSED_USER_LIST این مورد یک یا چند لیست کاربری را هدف قرار می دهد که دیگر در دسترس نیستند. در آینده، این کار از ارائه آیتم خط جلوگیری می کند، بنابراین این لیست ها را از هدف خود حذف کنید.
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY این مورد خط نصب برنامه استراتژی پیشنهاد قیمت بهینه ندارد.
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS معاملات هدف این مورد خطی، اندازه‌های خلاقانه‌ای را می‌پذیرند که استفاده نمی‌شوند. این ممکن است تحویل یا عملکرد خط مورد را محدود کند.
NO_CREATIVE_FOR_TARGETED_DEALS این مورد خطی حاوی هیچ خلاقیتی برای معاملات هدفمند نیست.
TARGETING_DEPRECATED_GEO_TARGET این مورد خط یک هدف جغرافیایی را هدف قرار می دهد که منسوخ شده است.
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 پلتفرم اندروید.

روش ها

bulkEditLineItemAssignedTargetingOptions

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

bulkListLineItemAssignedTargetingOptions

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

create

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

delete

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

generateDefault

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

get

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

list

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

patch

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