- المورد: عنصر السطر
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- LineItemWarningMessage
- MobileApp
- النظام الأساسي
- YoutubeAndPartnersSettings
- YoutubeAndPartnersThirdPartyMeasurementSettings
- ThirdPartyVendorConfig
- ThirdPartyVendor
- YoutubeAndPartnersInventorySourceConfig
- YoutubeAndPartnersContentCategory
- TargetFrequency
- VideoAdSequenceSettings
- VideoAdSequenceMinimumDuration
- VideoAdSequenceStep
- InteractionType
- الطُرق
المرجع: عنصر
تمثّل هذه السمة عنصرًا واحدًا.
تمثيل 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 |
تفاصيل دمج العنصر |
targetingExpansion |
إعدادات الاستهداف المحسّن للعنصر. لا تنطبق هذه الإعدادات إلا على عناصر الشبكة الإعلانية أو الفيديو أو تفاصيل الصوت التي تستخدم عروض الأسعار المبرمَجة وتستهدف قوائم المستخدمين المؤهَّلة بشكل إيجابي. |
warningMessages[] |
النتائج فقط. رسائل التحذير التي تم إنشاؤها بواسطة العنصر. لا تؤدي هذه التحذيرات إلى حظر حفظ العنصر، إلا أنّ بعضها قد يؤدي إلى منع تشغيل العنصر. |
mobileApp |
تطبيق الأجهزة الجوّالة الذي تم الترويج له من خلال العنصر. ولا ينطبق ذلك إلا إذا كانت قيمة |
reservationType |
النتائج فقط. نوع حجز العنصر. |
excludeNewExchanges |
ما إذا كان سيتم استبعاد التبادلات الجديدة من الاستهداف التلقائي بواسطة العنصر أم لا. يكون هذا الحقل "خطأ" تلقائيًا. |
youtubeAndPartnersSettings |
النتائج فقط. الإعدادات المخصّصة لعناصر YouTube والشركاء. |
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 . |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION |
إعلانات فيديو YouTube التي تروّج للإحالات الناجحة. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE |
إعلانات فيديو YouTube (التي تصل مدتها إلى 15 ثانية) لا يمكن تخطّيها. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE |
إعلانات فيديو YouTube التي تعرض قصة بتسلسل معيّن باستخدام مزيج من الأشكال. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO |
الإعلانات الصوتية على YouTube. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH |
إعلانات فيديو YouTube التي تعمل على تحسين الوصول إلى المزيد من المستخدمين الفرديين بتكلفة أقل. وقد يشمل ذلك إعلانات الملصقات الصغيرة أو الإعلانات القابلة للتخطي أثناء عرض الفيديو أو مزيج من أنواع الإعلانات. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE |
إعلانات فيديو YouTube التلقائية. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP |
إعلانات فيديو YouTube على التلفزيون المتّصل (تصل مدتها إلى 15 ثانية) ولا يمكن تخطّيها. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP |
إعلانات فيديو YouTube للتلفزيون المتّصل تعمل على تحسين الوصول إلى المزيد من المستخدمين الفرديين بتكلفة أقل وقد يشمل ذلك إعلانات الملصقات الصغيرة أو الإعلانات القابلة للتخطي أثناء عرض الفيديو أو مزيج من أنواع الإعلانات. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP |
إعلانات الفيديو التلقائية على YouTube للتلفزيون المتّصل يجب تضمين شكل الإعلان أثناء عرض الفيديو فقط. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY |
الهدف من هذا النوع من العناصر هو عرض عدد المرّات المستهدَفة من الإعلانات على YouTube للشخص نفسه في فترة زمنية معيّنة. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW |
إعلانات فيديو YouTube التي تهدف إلى الحصول على المزيد من المشاهدات باستخدام مجموعة متنوعة من أشكال الإعلانات. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME |
الإعلانات الصورية التي يتم عرضها على مستودع الإعلانات الرقمية خارج المنزل. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME |
إعلانات الفيديو التي يتم عرضها على مستودع الإعلانات الرقمية خارج المنزل. لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات. |
LineItemFlight
الإعدادات التي تتحكّم في مدة نشاط أحد العناصر.
تمثيل JSON |
---|
{ "flightDateType": enum ( |
الحقول | |
---|---|
flightDateType |
مطلوبة. نوع تواريخ إطلاق العنصر. |
dateRange |
تاريخا بدء عرض الإعلانات وانتهائها للعنصر. يتم حلها وفقًا للمنطقة الزمنية للمعلِن الرئيسي.
|
LineItemFlightDateType
الأنواع المحتملة من تواريخ إطلاق العنصر
عمليات التعداد | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
لم يتم تحديد قيمة النوع أو غير معروفة في هذا الإصدار. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
يتم اكتساب تواريخ إطلاق العنصر من طلب الإدراج الرئيسي. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
يستخدم العنصر تواريخ رحلات الطيران المخصّصة له. |
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, 000 من النسبة المئوية) يجب أن تتراوح القيمة بين 0 و100,000 كحدّ أقصى. على سبيل المثال، لتتبُّع 50% من الإحالات الناجحة بعد النقر، حدِّد قيمة 50,000. |
floodlightActivityConfigs[] |
إعدادات نشاط Floodlight المستخدَمة لتتبُّع الإحالات الناجحة عدد الإحالات الناجحة التي يتم احتسابها هو مجموع كل الإحالات الناجحة التي تم احتسابها من خلال جميع أرقام تعريف أنشطة Floodlight المحدّدة في هذا الحقل. |
TrackingFloodlightActivityConfig
الإعدادات التي تتحكّم في سلوك أحد إعدادات نشاط Floodlight
تمثيل JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
الحقول | |
---|---|
floodlightActivityId |
مطلوبة. رقم تعريف نشاط Floodlight. |
postClickLookbackWindowDays |
مطلوبة. عدد الأيام التي تلي النقر على الإعلان والتي قد يتم احتساب إحالة ناجحة فيها. يجب أن تتراوح القيمة بين 0 و90 بشكل شامل. |
postViewLookbackWindowDays |
مطلوبة. عدد الأيام التي بعد مشاهدة الإعلان والتي قد يتم احتساب إحالة ناجحة فيها. يجب أن تتراوح القيمة بين 0 و90 بشكل شامل. |
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 |
تم تحديد تاريخ انتهاء طلب الإدراج لهذا العنصر في الماضي. لن يتم تشغيل العنصر. |
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 الأساسي. |
YoutubeAndPartnersSettings
إعدادات عناصر YouTube والشركاء
تمثيل JSON |
---|
{ "biddingStrategy": { object ( |
الحقول | |
---|---|
biddingStrategy |
مطلوبة. استراتيجية عروض الأسعار لعنصر YouTube والشركاء. |
viewFrequencyCap |
إعدادات تحديد عدد مرات الظهور للعنصر. يجب استخدام الحقل |
thirdPartyMeasurementSettings |
اختياريّ. إعدادات القياس التابعة لجهة خارجية للعنصر. |
inventorySourceSettings |
الإعدادات التي تتحكّم في المستودع الإعلاني الذي تستهدفه منصة YouTube والشركاء. |
contentCategory |
نوع المحتوى الذي سيتمّ عرض إعلانات YouTube والشركاء عليه. |
effectiveContentCategory |
النتائج فقط. تمثّل هذه السمة فئة المحتوى التي يتم تطبيقها عند عرض العنصر. عند ضبط فئة المحتوى في كلٍّ من العنصر والمعلِن، سيتم تفعيل فئة أكثر صرامة عند عرض العنصر. |
targetFrequency |
متوسط عدد المرّات التي تريد فيها عرض إعلانات من هذا العنصر للمستخدم نفسه خلال فترة زمنية معيّنة. |
linkedMerchantId |
معرّف التاجر المرتبط بعنصر خلاصة المنتج |
relatedVideoIds[] |
وتظهر أرقام تعريف الفيديوهات أسفل إعلان الفيديو الأساسي عند عرض الإعلان في تطبيق YouTube على الأجهزة الجوّالة. |
leadFormId |
رقم تعريف النموذج لاكتساب عملاء محتملين. |
videoAdSequenceSettings |
الإعدادات ذات الصلة بـ VideoAdSequence. |
YoutubeAndPartnersThirdPartyMeasurementSettings
الإعدادات التي تتحكّم في قياسات تفاصيل الإعلانات لدى مورّدي الجهات الخارجية.
تمثيل JSON |
---|
{ "viewabilityVendorConfigs": [ { object ( |
الحقول | |
---|---|
viewabilityVendorConfigs[] |
مورّدو الجهات الخارجية الذين يقيسون إمكانية العرض ينطبق المورّدون الخارجيون التاليون:
|
brandSafetyVendorConfigs[] |
المورّدون التابعون لجهات خارجية الذين يقيسون أمان العلامة التجارية ينطبق المورّدون الخارجيون التاليون:
|
reachVendorConfigs[] |
يقيس مورّدو الجهات الخارجية مدى الوصول. ينطبق المورّدون الخارجيون التاليون:
|
brandLiftVendorConfigs[] |
مورّدو الجهات الخارجية الذين يقيسون تأثير العلامة التجارية ينطبق المورّدون الخارجيون التاليون:
|
ThirdPartyVendorConfig
الإعدادات التي تتحكّم في كيفية ضبط مورّدي القياس التابع لجهة خارجية.
تمثيل JSON |
---|
{
"vendor": enum ( |
الحقول | |
---|---|
vendor |
مورّد القياس التابع لطرف ثالث |
placementId |
المعرّف الذي تستخدمه النظام الأساسي للمورّد التابع لطرف ثالث لتحديد العنصر. |
ThirdPartyVendor
المورّدون الذين يجرون القياس التابع لجهة خارجية
عمليات التعداد | |
---|---|
THIRD_PARTY_VENDOR_UNSPECIFIED |
مورِّد تابع لجهة خارجية غير معروف. |
THIRD_PARTY_VENDOR_MOAT |
خندق. |
THIRD_PARTY_VENDOR_DOUBLE_VERIFY |
إثبات الملكية. |
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE |
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 |
Nielsen. |
THIRD_PARTY_VENDOR_KANTAR |
Kantar. |
THIRD_PARTY_VENDOR_DYNATA |
Dynata. |
YoutubeAndPartnersInventorySourceConfig
الإعدادات التي تتحكّم في المستودعات ذات الصلة بمنصة YouTube التي سيستهدِفها العنصر على YouTube والشركاء.
تمثيل JSON |
---|
{ "includeYoutubeSearch": boolean, "includeYoutubeVideos": boolean, "includeGoogleTv": boolean, "includeYoutubeVideoPartners": boolean } |
الحقول | |
---|---|
includeYoutubeSearch |
ما إذا كنت تريد استهداف المستودع في صفحة نتائج بحث YouTube. |
includeYoutubeVideos |
ما إذا كنت تريد استهداف مستودع القنوات والفيديوهات على YouTube وفيديوهات YouTube المضمّنة في مواقع إلكترونية أخرى. |
includeGoogleTv |
اختياريّ. يمكنك اختيار ما إذا كنت تريد استهداف المستودع الإعلاني في تطبيقات الفيديو المتوفّرة مع Google TV. |
includeYoutubeVideoPartners |
ما إذا كنت تريد استهداف المستودع الإعلاني في مجموعة من المواقع الإلكترونية والتطبيقات التابعة للشركاء التي تتّبع معايير أمان العلامة التجارية نفسها المتّبعة في YouTube |
YoutubeAndPartnersContentCategory
فئات أمان العلامة التجارية للمحتوى على YouTube والشركاء
عمليات التعداد | |
---|---|
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 |
يشير ذلك المصطلح إلى فئة تتألّف من نطاق محدود من المحتوى يستوفي متطلبات عالية، لا سيّما في ما يتعلّق باللغة غير اللائقة والإيحاءات الجنسية. |
TargetFrequency
إعداد يتحكّم في متوسط عدد مرات ظهور الإعلانات للمستخدم نفسه خلال فترة زمنية معيّنة.
تمثيل JSON |
---|
{
"targetCount": string,
"timeUnit": enum ( |
الحقول | |
---|---|
targetCount |
في المتوسّط، سيتم عرض الإعلانات على المستخدِم نفسه في الفترة الزمنية التي تفرضها السمة |
timeUnit |
الوحدة الزمنية التي سيتم فيها تطبيق عدد مرّات الظهور المستهدَف. تسري الوحدة الزمنية التالية:
|
timeUnitCount |
عدد يتم تطبيق القيود التالية استنادًا إلى قيمة
|
VideoAdSequenceSettings
الإعدادات ذات الصلة بـ VideoAdSequence.
تمثيل JSON |
---|
{ "minimumDuration": enum ( |
الحقول | |
---|---|
minimumDuration |
الحدّ الأدنى للفاصل الزمني قبل أن يرى المستخدم نفسه هذا التسلسل مرة أخرى. |
steps[] |
الخطوات التي يتألف منها التسلسل. |
VideoAdSequenceMinimumDuration
تعداد الحد الأدنى المحتمل للفاصل الزمني قبل أن يرى المستخدم نفسه VideoAdSequence مرة أخرى.
عمليات التعداد | |
---|---|
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 ( |
الحقول | |
---|---|
stepId |
رقم تعريف الخطوة. |
adGroupId |
رقم تعريف المجموعة الإعلانية المقابلة للخطوة. |
previousStepId |
رقم تعريف الخطوة السابقة. لا تحتوي الخطوة الأولى على خطوة سابقة. |
interactionType |
التفاعل في الخطوة السابقة الذي سيقود المُشاهد إلى هذه الخطوة. الخطوة الأولى لا تحتوي على عناصرInteractType. |
InteractionType
تمثّل هذه السمة أنواع التفاعل في الخطوة.
عمليات التعداد | |
---|---|
INTERACTION_TYPE_UNSPECIFIED |
غير محدّد أو غير معروف |
INTERACTION_TYPE_PAID_VIEW |
مشاهدة مدفوعة. |
INTERACTION_TYPE_SKIP |
تخطّى المشاهد المحتوى. |
INTERACTION_TYPE_IMPRESSION |
مرّة ظهور للإعلان (معروضة). |
INTERACTION_TYPE_ENGAGED_IMPRESSION |
مرة ظهور إعلان لم يتخطّاها المشاهد على الفور، ولكن لم تصل أيضًا إلى الحدث القابل للفوترة |
الطُرق |
|
---|---|
|
تعديلات مجمّعة لخيارات الاستهداف ضمن عناصر متعددة. |
|
يسرد خيارات الاستهداف التي تم تعيينها لعناصر متعددة عبر أنواع الاستهداف. |
|
تعمل على تعديل عناصر متعدّدة. |
|
ينشئ عنصرًا جديدًا. |
|
يؤدي هذا الإجراء إلى حذف عنصر. |
|
تكرار عنصر |
|
ينشئ عنصرًا جديدًا باستخدام الإعدادات (بما في ذلك الاستهداف) المكتسبة من طلب الإدراج وENTITY_STATUS_DRAFT entity_status . |
|
الحصول على عنصر. |
|
يسرد العناصر في أحد المعلِنين. |
|
لتعديل عنصر حالي |