- منبع: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- اپلیکیشن موبایل
- سکو
- مواد و روش ها
منبع: LineItem
یک مورد تک خطی
نمایندگی JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
زمینه های | |
---|---|
name | فقط خروجی نام منبع مورد خط. |
advertiserId | فقط خروجی شناسه منحصربهفرد تبلیغکنندهای که مورد خط به آن تعلق دارد. |
campaignId | فقط خروجی شناسه منحصر به فرد کمپین که مورد خط به آن تعلق دارد. |
insertionOrderId | ضروری. تغییرناپذیر. شناسه منحصر به فرد سفارش درج که مورد خط به آن تعلق دارد. |
lineItemId | فقط خروجی شناسه منحصر به فرد مورد خط. توسط سیستم تعیین شده است. |
displayName | ضروری. نام نمایشی مورد خط. باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود. |
lineItemType | ضروری. تغییرناپذیر. نوع آیتم خط. |
entityStatus | ضروری. کنترل می کند که آیا آیتم خطی می تواند بودجه و پیشنهاد قیمت خود را صرف موجودی کند یا خیر.
|
updateTime | فقط خروجی مُهر زمانی آخرین بهروزرسانی مورد خط. توسط سیستم تعیین شده است. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
partnerCosts[] | هزینه های شریک مرتبط با آیتم خط. اگر در روش |
flight | ضروری. زمان شروع و پایان پرواز خط مورد. |
budget | ضروری. تنظیم تخصیص بودجه آیتم خط. |
pacing | ضروری. تنظیم سرعت هزینه بودجه آیتم خط. |
frequencyCap | ضروری. تنظیمات درب فرکانس نمایش مورد خط. فیلد |
partnerRevenueModel | ضروری. تنظیم مدل درآمد شریک مورد خط. |
conversionCounting | تنظیم ردیابی تبدیل مورد خط. |
creativeIds[] | شناسههای خلاقیتهای مرتبط با مورد خط. |
bidStrategy | ضروری. استراتژی مناقصه مورد خط. |
integrationDetails | جزئیات یکپارچه سازی مورد خط. |
inventorySourceIds[] | شناسه منابع موجودی خصوصی اختصاص داده شده به آیتم خط. |
targetingExpansion | تنظیمات گسترش هدف گذاری مورد خط. این پیکربندی فقط زمانی اعمال میشود که هدفیابی فهرست مخاطبان واجد شرایط به مورد خط اختصاص داده شود. |
warningMessages[] | فقط خروجی پیام های هشدار تولید شده توسط مورد خط. این اخطارها ذخیره آیتم خط را مسدود نمی کنند، اما برخی ممکن است اجرای آیتم خط را مسدود کنند. |
mobileApp | برنامه تلفن همراه که توسط مورد خط تبلیغ می شود. این فقط زمانی قابل اعمال است که نوع |
reservationType | فقط خروجی نوع رزرو مورد خط. |
excludeNewExchanges | آیا مبادلات جدید از هدف قرار گرفتن خودکار توسط آیتم خط حذف می شوند یا خیر. این فیلد به طور پیش فرض نادرست است. |
LineItemType
انواع احتمالی یک آیتم خط.
نوع آیتم خط تعیین میکند که کدام تنظیمات و گزینهها قابل اجرا هستند، مانند قالب تبلیغات یا گزینههای هدف.
Enums | |
---|---|
LINE_ITEM_TYPE_UNSPECIFIED | مقدار نوع در این نسخه مشخص نشده است یا ناشناخته است. |
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 | نمایش تبلیغات ارائه شده در موجودی برنامه تلفن همراه. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY | تبلیغات ویدیویی در فهرست موجودی برنامه تلفن همراه ارائه شده است. |
LINE_ITEM_TYPE_AUDIO_DEFAULT | تبلیغات صوتی RTB برای محیط های مختلف فروخته می شود. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP | تبلیغات فوقالعاده در سفارشهای درج OTT وجود دارد. این نوع فقط برای موارد خط با ترتیب درج insertionOrderType OVER_THE_TOP قابل استفاده است. |
LINE_ITEM_TYPE_DISPLAY_COMMERCE | تبلیغات محصول حمایت شده در دارایی یک خرده فروش ارائه می شود. |
LineItemFlight
تنظیماتی که مدت زمان فعال یک مورد خط را کنترل می کند.
نمایندگی JSON |
---|
{ "flightDateType": enum ( |
زمینه های | |
---|---|
flightDateType | ضروری. نوع تاریخ پرواز مورد خط. |
dateRange | تاریخ شروع و پایان پرواز مورد خط. آنها نسبت به منطقه زمانی تبلیغ کننده اصلی حل می شوند.
|
triggerId | شناسه راهانداز دستی مرتبط با مورد خط.
|
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 | مورد خط از یک ماشه استفاده می کند. |
LineItemBudget
تنظیماتی که نحوه تخصیص بودجه را کنترل می کند.
نمایندگی JSON |
---|
{ "budgetAllocationType": enum ( |
زمینه های | |
---|---|
budgetAllocationType | ضروری. نوع تخصیص بودجه |
budgetUnit | فقط خروجی واحد بودجه مشخص می کند که آیا بودجه مبتنی بر ارز است یا بر اساس برداشت. این مقدار از ترتیب درج والد به ارث می رسد. |
maxAmount | حداکثر مقدار بودجه ای که مورد خط خرج می کند. باید بزرگتر از 0 باشد. هنگامی که
|
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 ( |
زمینه های | |
---|---|
markupType | ضروری. نوع نشانه گذاری مدل درآمد شریک. |
markupAmount | ضروری. مقدار نشانه گذاری مدل درآمد شریک. باید بزرگتر یا مساوی 0 باشد.
|
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 ( |
زمینه های | |
---|---|
postViewCountPercentageMillis | درصد تبدیلهای پس از مشاهده برای شمارش، بر حسب میلیمتر (1/1000 درصد). باید بین 0 تا 100000 باشد. به عنوان مثال، برای ردیابی 50٪ از تبدیل های پس از کلیک، مقدار 50000 را تعیین کنید. |
floodlightActivityConfigs[] | تنظیمات فعالیت Floodlight که برای ردیابی تبدیل ها استفاده می شود. تعداد تبدیلهای شمارششده، مجموع همه تبدیلهای شمارششده توسط همه شناسههای فعالیت Floodlight مشخصشده در این فیلد است. |
TrackingFloodlightActivityConfig
تنظیماتی که رفتار یک پیکربندی فعالیت Floodlight را کنترل می کند.
نمایندگی JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
زمینه های | |
---|---|
floodlightActivityId | ضروری. شناسه فعالیت Floodlight. |
postClickLookbackWindowDays | ضروری. تعداد روزهایی که پس از کلیک روی یک تبلیغ ممکن است در آن تبدیل حساب شود. باید بین 0 تا 90 باشد. |
postViewLookbackWindowDays | ضروری. تعداد روزهای پس از مشاهده یک آگهی که در آن تبدیل ممکن است شمارش شود. باید بین 0 تا 90 باشد. |
TargetingExpansionConfig
تنظیماتی که گسترش هدف گذاری مورد خط را کنترل می کند. گسترش هدف گذاری به آیتم خط اجازه می دهد تا بر اساس فهرست مخاطبان اصلی و سطح گسترش هدف، به مخاطبان بیشتری دست یابد.
نمایندگی JSON |
---|
{
"targetingExpansionLevel": enum ( |
زمینه های | |
---|---|
targetingExpansionLevel | ضروری. میزان گسترش برای هدفگیری قابل اجرا در این مورد. |
excludeFirstPartyAudience | ضروری. آیا باید مخاطبان شخص اول را از هدف گذاری حذف کرد یا خیر. مخاطبان مشابه از لیست های حزب اول حذف شده حذف نخواهند شد. فقط زمانی قابل اعمال است که مخاطبان شخص اول به طور مثبت هدف قرار گیرند (مستقیم یا در یک مخاطب ترکیبی) در غیر این صورت این انتخاب نادیده گرفته خواهد شد. |
TargetingExpansionLevel
توصیف کیفی سطح گسترش.
Enums | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED | سطح گسترش هدف در این نسخه مشخص نشده یا ناشناخته است. |
NO_EXPANSION | هدف گذاری گسترش خاموش است. |
LEAST_EXPANSION | گسترش هدف گیری محافظه کارانه، کمترین دسترسی. |
SOME_EXPANSION | گسترش هدف گیری نسبتا محافظه کارانه، دسترسی کمتر. |
BALANCED_EXPANSION | گسترش هدف گیری متوسط، دسترسی متوسط. |
MORE_EXPANSION | گسترش هدف گیری نسبتاً تهاجمی، دسترسی بالاتر. |
MOST_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 | این مورد خط یک هدف جغرافیایی را هدف قرار می دهد که منسوخ شده است. |
اپلیکیشن موبایل
یک برنامه تلفن همراه که توسط یک مورد خط نصب برنامه تلفن همراه تبلیغ می شود.
نمایندگی JSON |
---|
{
"appId": string,
"platform": enum ( |
زمینه های | |
---|---|
appId | ضروری. شناسه برنامه ارائه شده توسط فروشگاه پلتفرم. برنامههای Android با شناسه بسته مورد استفاده توسط فروشگاه Play Android، مانند برنامههای iOS با یک شناسه برنامه نه رقمی که توسط فروشگاه App اپل استفاده میشود، مانند |
platform | فقط خروجی پلت فرم اپلیکیشن |
displayName | فقط خروجی نام برنامه |
publisher | فقط خروجی ناشر اپلیکیشن |
سکو
پلتفرم های احتمالی اپلیکیشن موبایل
Enums | |
---|---|
PLATFORM_UNSPECIFIED | پلتفرم مشخص نشده است. |
IOS | پلتفرم iOS. |
ANDROID | پلتفرم اندروید. |
مواد و روش ها | |
---|---|
| انبوه گزینه های هدف را در زیر یک مورد خط ویرایش می کند. |
| گزینه های هدف گذاری اختصاص داده شده برای یک مورد خط را در بین انواع هدف فهرست می کند. |
| یک آیتم خط جدید ایجاد می کند. |
| یک مورد خطی را حذف می کند. |
| یک مورد خط جدید با تنظیمات (از جمله هدفیابی) به ارث رسیده از ترتیب درج و یک ENTITY_STATUS_DRAFT entity_status ایجاد میکند. |
| یک مورد خطی دریافت می کند. |
| موارد خط را در یک تبلیغکننده فهرست میکند. |
| یک مورد خط موجود را به روز می کند. |