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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

لتحديد ما إذا كان سيتم استبعاد التبادلات الجديدة من الاستهداف التلقائي للعنصر. ويكون هذا الحقل false بشكلٍ تلقائي.

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 تُباع الإعلانات الصوتية التي تستخدم عروض الأسعار في الوقت الفعلي في مجموعة متنوعة من البيئات.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP إعلانات خدمة البث المباشر على الإنترنت متوفّرة في طلبات إدراج خدمة البث المباشر على الإنترنت لا ينطبق هذا النوع إلا على العناصر التي تم طلب إدراجها بقيمة 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. يجب عدم ضبطها على خلاف ذلك.
  • وعند ضبط هذه السياسة، يتم اكتساب تواريخ عرض العنصر من طلب الإدراج الرئيسي.
  • ستُنفق العناصر النشطة عند تفعيل المشغّل المحدّد خلال تواريخ عرض إعلانات طلب الإدراج الرئيسي.

تحذير: لم يعد يتم عرض العناصر التي تستخدم عوامل التشغيل اليدوية في "الشبكة الإعلانية" فيديو 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 (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

الأنواع المحتملة لتخصيص الميزانية.

عمليات التعداد
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

أنواع الترميز المحتملة لنموذج أرباح الشركاء.

عمليات التعداد
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 (TrackingFloodlightActivityConfig)
    }
  ]
}
الحقول
postViewCountPercentageMillis

string (int64 format)

النسبة المئوية للإحالات الناجحة بعد المشاهدة التي يتم احتسابها بالمللي ثانية (1/1000 من النسبة المئوية) يجب أن تتراوح القيمة بين 0 و100,000 كحدّ أقصى.

على سبيل المثال، لتتبُّع 50% من الإحالات الناجحة بعد النقر، حدِّد قيمة 50,000.
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

إعداد "الاستهداف المحسّن"

عمليات التعداد
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

رسائل التحذير التي تم إنشاؤها بواسطة أحد العناصر لا تحظر هذه الأنواع من التحذيرات حفظ عنصر، ولكنها قد تحظر تشغيل عنصر.

عمليات التعداد
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

يستخدم هذا العنصر الإعداد "excludeFirstPartyAudience"، الذي تم إيقافه نهائيًا ومن المقرّر إيقافه بعد 25 آذار (مارس) 2023.

عليك تعديل عملية دمج واجهة برمجة التطبيقات لاستبعاد أي شرائح جمهور للطرف الأول تستخدم استهداف الجمهور مباشرةً قبل 25 آذار (مارس) 2023 من أجل مراعاة الإيقاف النهائي لحقل excludeFirstPartyAudience.

MobileApp

تطبيق للأجهزة الجوّالة يروّج له عنصر لتثبيت تطبيق للأجهزة الجوّالة.

تمثيل JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
الحقول
appId

string

مطلوب. رقم تعريف التطبيق الذي يوفّره متجر المنصة.

يتم التعرّف على تطبيقات Android من خلال معرّف الحزمة المُستخدَم في "متجر Play" لتطبيقات Android، مثل com.google.android.gm.

يتم التعرّف على تطبيقات iOS من خلال معرّف التطبيق المكوَّن من تسعة أرقام والذي يستخدمه متجر تطبيقات Apple، مثل 422689480.
platform

enum (Platform)

النتائج فقط. النظام الأساسي للتطبيق.
displayName

string

النتائج فقط. اسم التطبيق
publisher

string

النتائج فقط. ناشر التطبيق

النظام الأساسي

الأنظمة الأساسية المحتملة لتطبيقات الأجهزة الجوّالة.

عمليات التعداد
PLATFORM_UNSPECIFIED لم يتم تحديد النظام الأساسي.
IOS لنظام التشغيل iOS الأساسي.
ANDROID نظام Android الأساسي.

الطُرق

bulkEditLineItemAssignedTargetingOptions

 التعديلات المجمّعة لخيارات الاستهداف ضمن بند واحد.

bulkListLineItemAssignedTargetingOptions

 تعمل على سرد خيارات الاستهداف المعيّنة لعنصر على مستوى أنواع الاستهداف.

create

 تنشئ عنصرًا جديدًا.

delete

 حذف عنصر.

generateDefault

 تُنشئ عنصرًا جديدًا يتضمّن إعدادات (بما في ذلك الاستهداف) مكتسَبة من طلب الإدراج وentity_status ENTITY_STATUS_DRAFT.

get

 يحصل على عنصر.

list

 يسرد العناصر في أحد المعلنين.

patch

 يعدِّل عنصر حالي.