- المورد: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- النظام الأساسي
- الطُرق
المرجع: عنصر
عنصر واحد.
تمثيل 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
الأنواع المحتملة من العنصر.
يحدِّد نوع العنصر الإعدادات والخيارات السارية، مثل شكل الإعلانات أو خيارات الاستهداف.
عمليات التعداد | |
---|---|
LINE_ITEM_TYPE_UNSPECIFIED |
لم يتم تحديد قيمة النوع أو أنها غير معروفة في هذا الإصدار. لا يمكن إنشاء العناصر من هذا النوع واستهدافها أو تعديلها باستخدام واجهة برمجة التطبيقات. |
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 |
الإعلانات الصورية المعروضة على مستودع التطبيقات المتوافقة مع الأجهزة الجوّالة. لا يمكن إنشاء العناصر من هذا النوع واستهدافها أو تعديلها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY |
إعلانات الفيديو المعروضة على مستودع التطبيقات المتوافقة مع الأجهزة الجوّالة. لا يمكن إنشاء العناصر من هذا النوع واستهدافها أو تعديلها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
تُباع الإعلانات الصوتية المستندة إلى عرض الأسعار في الوقت الفعلي (RTB) لمجموعة متنوعة من البيئات. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
تتوفّر إعلانات خدمة البث المباشر على الإنترنت في طلبات إدراج خدمة البث المباشر على الإنترنت. لا ينطبق هذا النوع إلا على العناصر التي لها طلب إدراج بقيمة insertionOrderType OVER_THE_TOP . |
LineItemFlight
الإعدادات التي تتحكّم في المدة النشطة لعنصر معيّن.
تمثيل JSON |
---|
{ "flightDateType": enum ( |
الحقول | |
---|---|
flightDateType |
مطلوبة. تمثّل هذه السمة نوع تواريخ عرض تفاصيل الإعلان. |
dateRange |
تاريخا بدء عرض الإعلانات وانتهائها للعنصر. ويتم حلها وفقًا للمنطقة الزمنية للمعلِن الرئيسي.
|
triggerId |
رقم تعريف المشغِّل اليدوي المرتبط بالعنصر.
تحذير: لم تعُد العناصر التي تستخدم المشغّلات اليدوية ظاهرة في "مساحة العرض والفيديو 360". سيتم إيقاف هذا الحقل في 1 آب (أغسطس) 2023. يمكنك الاطّلاع على الإشعار عن إيقاف الميزات نهائيًا للحصول على مزيد من المعلومات. |
LineItemFlightDateType
الأنواع المحتملة لتواريخ عرض تفاصيل الإعلان.
عمليات التعداد | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
لم يتم تحديد قيمة النوع أو أنها غير معروفة في هذا الإصدار. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
يتم اكتساب تواريخ إطلاق العنصر من طلب الإدراج الرئيسي. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
يستخدِم العنصر تواريخ عرض الإعلانات المخصّصة له. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
يستخدِم العنصر مشغّلاً. تحذير: لم تعُد العناصر التي تستخدم المشغّلات اليدوية ظاهرة في "مساحة العرض والفيديو 360". ستنتهي هذه القيمة في 1 آب (أغسطس) 2023. يمكنك الاطّلاع على الإشعار عن إيقاف الميزات نهائيًا للحصول على مزيد من المعلومات. |
LineItemBudget
الإعدادات التي تتحكّم في كيفية تخصيص الميزانية
تمثيل JSON |
---|
{ "budgetAllocationType": enum ( |
الحقول | |
---|---|
budgetAllocationType |
مطلوبة. نوع توزيع الميزانية. لا يسري |
budgetUnit |
النتائج فقط. تحدد وحدة الميزانية ما إذا كانت الميزانية تعتمد على العملة أو مستندة إلى مرات الظهور. هذه القيمة مكتسَبة من طلب الإدراج الرئيسي. |
maxAmount |
الحد الأقصى لمبلغ الميزانية الذي سينفقه العنصر. يجب أن يكون أكبر من 0. عندما تكون قيمة الحقل "
|
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 ( |
الحقول | |
---|---|
markupType |
مطلوبة. نوع الترميز لنموذج أرباح الشريك. |
markupAmount |
مطلوبة. مبلغ الترميز الخاص بنموذج أرباح الشريك. يجب أن تكون أكبر من أو تساوي 0.
|
PartnerRevenueModelMarkupType
أنواع الترميز المحتملة لنموذج أرباح الشركاء.
عمليات التعداد | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED |
لم يتم تحديد قيمة النوع أو أنها غير معروفة في هذا الإصدار. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_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% من الإحالات الناجحة بعد النقر، اضبط القيمة 50,000. |
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
إعداد "الاستهداف المحسّن"
عمليات التعداد | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
إعداد الاستهداف المحسّن غير محدّد أو غير معروف في هذا الإصدار. |
NO_EXPANSION |
ميزة "الاستهداف المحسّن" غير مفعَّلة. |
LEAST_EXPANSION |
ميزة "الاستهداف المحسّن" مفعَّلة. |
SOME_EXPANSION |
وفي حال تم استخدامه، سيتم ضبطه تلقائيًا على |
BALANCED_EXPANSION |
وفي حال تم استخدامه، سيتم ضبطه تلقائيًا على |
MORE_EXPANSION |
وفي حال تم استخدامه، سيتم ضبطه تلقائيًا على |
MOST_EXPANSION |
وفي حال تم استخدامه، سيتم ضبطه تلقائيًا على |
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 |
لا يتضمّن استهداف التطبيقات وعناوين URL لهذا العنصر أيّ تطبيقات متوافقة مع الأجهزة الجوّالة. يتطلب نوع هذا العنصر تضمين التطبيقات المتوافقة مع الأجهزة الجوّالة في استهداف القناة أو قائمة المواقع الإلكترونية أو التطبيقات. ولن يتمّ تشغيل العنصر. |
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 |
يستخدم هذا العنصر الإعداد يجب تعديل عملية دمج واجهة برمجة التطبيقات لاستبعاد أي شرائح جمهور للطرف الأول تستخدم استهداف الجمهور مباشرةً قبل 25 آذار (مارس) 2023 لمراعاة الإيقاف النهائي للحقل |
MobileApp
تطبيق متوافق مع الأجهزة الجوّالة يتم الترويج له من خلال عنصر تثبيت تطبيق متوافق مع الأجهزة الجوّالة.
تمثيل JSON |
---|
{
"appId": string,
"platform": enum ( |
الحقول | |
---|---|
appId |
مطلوبة. رقم تعريف التطبيق الذي وفّره متجر المنصّة يتم التعرّف على تطبيقات Android من خلال معرّف الحزمة الذي يستخدمه "متجر Play" على أجهزة Android، مثل يتم التعرّف على تطبيقات iOS من خلال رقم تعريف تطبيق مكوَّن من تسعة أرقام يستخدمه متجر App Store من Apple، مثل |
platform |
النتائج فقط. النظام الأساسي للتطبيق. |
displayName |
النتائج فقط. اسم التطبيق |
publisher |
النتائج فقط. ناشر التطبيق. |
النظام الأساسي
الأنظمة الأساسية المحتملة للتطبيقات المتوافقة مع الأجهزة الجوّالة.
عمليات التعداد | |
---|---|
PLATFORM_UNSPECIFIED |
لم يتم تحديد النظام الأساسي. |
IOS |
نظام التشغيل iOS. |
ANDROID |
نظام Android الأساسي. |
الطُرق |
|
---|---|
|
التعديلات المجمّعة لخيارات الاستهداف ضمن بند واحد. |
|
يسرد خيارات الاستهداف المعينة لعنصر على مستوى أنواع الاستهداف. |
|
تُنشئ عنصرًا جديدًا. |
|
حذف عنصر |
|
إنشاء عنصر جديد مع إعدادات (بما في ذلك الاستهداف) المكتسبة من طلب الإدراج وENTITY_STATUS_DRAFT entity_status . |
|
الحصول على عنصر. |
|
يسرد العناصر في أحد المعلنين. |
|
لتعديل عنصر حالي |