البيانات المنظَّمة - الإصدار 7 - منتج وسائط

تم إيقاف هذا الإصدار من SDF نهائيًا. على المستخدمين الانتقال إلى الإصدار v9 من "تنسيق البيانات المنظَّمة" قبل 4 نوفمبر 2025 لمواصلة استخدام ملفات البيانات المنظَّمة.

راجِع النظرة العامة للحصول على شرح حول التنسيق.

الحقل	مطلوب	النوع	قابل للكتابة	الوصف
معرِّف المنتج	لا	عدد صحيح	لا	تمثّل هذه السمة القيمة الرقمية لمعرّف المنتج الإعلامي.
معرّف الخطة	لا	عدد صحيح	لا	تمثّل هذه السمة قيمة المعرّف الرقمي لاقتراح الوسائط.
رقم تعريف الحملة	لا	عدد صحيح	لا
الاسم	نعم	سلسلة	نعم	اسم الإدخال.
النوع	لا	سلسلة	لا	تمثّل هذه السمة نوع المنتج الإعلامي. إعلان صوري لمزاد مفتوح إعلان صوتي لمزاد مفتوح إعلان فيديو لمزاد مفتوح حملة لمشاهدة الفيديو مدى الوصول الفعّال إعلان TrueView أثناء عرض الفيديو على YouTube إعلانات TrueView Discovery على YouTube إعلانات الملصق الصغير من TrueView على YouTube ‫Youtube TrueView Reach إعلان صوتي على YouTube إعلانات الملصقات الصغيرة القابلة للتخطّي المستندة إلى عدد مرّات الظهور المستهدَف عدد مرّات الظهور المستهدَف للإعلانات غير القابلة للتخطّي إعلان قابل للتخطّي ضمن "عدد مرّات الظهور المستهدَف" إعلان قصير ضمن "عدد مرّات الظهور المستهدَف" ‫Google Preferred Bumper فيديو Shorts ضمن Google Preferred Google Preferred Long إعلان غير قابل للتخطي أثناء عرض الفيديو مدته 30 ثانية في Google Preferred فيديوهات Shorts على Google Preferred فيديو Shorts عادي محجوز Standard Reserve Long غير قابل للتخطي ضمن البث خاص (الناشر) خاص (مصدر المساحات الإعلانية) خاص (تفاوض) الحملات لزيادة الطلب
Start Date	لا	سلسلة	لا	تمثّل هذه السمة تاريخ بدء عرض المنتج الإعلامي بالتنسيق MM/DD/YYYY HH:mm.
تاريخ الانتهاء	لا	سلسلة	لا	تمثّل هذه السمة تاريخ انتهاء صلاحية المنتج الإعلامي بالتنسيق MM/DD/YYYY HH:mm.
الميزانية	لا	عدد عائم	لا	مبلغ ميزانية موجب للمنتج الإعلامي يكون دائمًا عددًا عشريًا لمبلغ العملة لأنّه سيكون دائمًا ميزانية نقدية. سيتم عرض العملات بعملة المعلِن بوحدات عادية (وليس بجزء من مليون من وحدة العملة).
تفعيل ميزة "عدد مرات الظهور"	نعم	سلسلة	نعم
عدد مرات الظهور	مطلوبة عندما تكون قيمة "تفعيل عدد مرات الظهور" هي "TRUE"	عدد صحيح	نعم	مبلغ عدد صحيح موجب لعدد مرّات الظهور في "مبلغ عدد مرات الظهور" معيّن، أي x في "عرض x مرّات ظهور على مدار الفترة y".
فترة عدد مرّات الظهور	مطلوبة عندما تكون قيمة "تفعيل عدد مرات الظهور" هي "TRUE"	سلسلة	نعم	دقائق ساعات الأيام أسابيع الأشهر الفترة منذ الإنشاء
مبلغ التكرار	مطلوبة عندما تكون قيمة "تفعيل عدد مرات الظهور" هي "TRUE"	عدد صحيح	نعم
الاستهداف الجغرافي - التضمين	لا	سلسلة أو قائمة	نعم	قائمة بالمناطق الجغرافية المطلوب تضمينها في الاستهداف. يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_GEO_REGION. تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.
استهداف اللغة - تضمين	لا	سلسلة أو قائمة	نعم	قائمة اللغات المطلوب تضمينها في الاستهداف يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_LANGUAGE. تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.
استهداف اللغة - الاستبعاد	لا	سلسلة أو قائمة	نعم	قائمة اللغات المطلوب استبعادها من الاستهداف يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_LANGUAGE. تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.
استهداف القنوات - تضمين	لا	سلسلة أو قائمة	نعم	قائمة بالقنوات المطلوب تضمينها في الاستهداف. يستخدِم هذا العمود أرقام تعريف الموارد Channel في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360". تنسيق القائمة = (Channel.channelId; Channel.channelId; إلخ).
استهداف القنوات - الاستبعاد	لا	سلسلة أو قائمة	نعم	قائمة بالقنوات المطلوب استبعادها من الاستهداف يستخدِم هذا العمود أرقام تعريف الموارد Channel في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360". تنسيق القائمة = (Channel.channelId; Channel.channelId; إلخ).
استهداف الفئات - التضمين	لا	سلسلة أو قائمة	نعم	قائمة بالفئات المطلوب تضمينها في الاستهداف يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_CATEGORY. تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.
استهداف الفئات - الاستبعاد	لا	سلسلة أو قائمة	نعم	قائمة الفئات المطلوب استبعادها من الاستهداف يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_CATEGORY. تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.
استهداف الجمهور - تضمين	لا	سلسلة، قائمة بقوائم أزواج	نعم	قائمة بقوائم المستخدمين التي سيتم تضمينها في الاستهداف. يستخدِم هذا العمود أرقام تعريف الموارد FirstPartyAndPartnerAudience في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360". بالنسبة إلى قوائم جمهور الطرف الأول، يتم إدراج كل جمهور كزوج من FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId وإعداد الحداثة. الزوج هو (1;1d;‎)، حيث يمثّل 1d مدى الحداثة لعيّنة تبلغ يومًا واحدًا. لا تتوفّر بيانات الحداثة لشرائح الجمهور التابعة لجهات خارجية، لذا يكون تنسيق القائمة هو (3;);(4;);. لدمج مجموعات الجمهور باستخدام "AND" و "OR"، اتّبِع المثال التالي: لدمج أزواج مع مراعاة الحداثة وبدونها: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. يعني ذلك (القائمة 1 التي تتضمّن بيانات حديثة ليوم واحد أو القائمة 2 التي تتضمّن بيانات حديثة لـ 365 يومًا) و (القائمة 3 بدون بيانات حديثة محدّدة أو القائمة 4 التي تتضمّن بيانات حديثة لـ 5 دقائق أو القائمة 5 التي تتضمّن جميع المستخدمين). قيم الحداثة الصالحة هي: الكل دقيقة واحدة ‫5 دقائق ‫10 دقائق ‫15 دقيقة ‫30 دقيقة 1 س ساعتان 3 ساعات 6 ساعات ‫12 ساعة يوم واحد يومَان ثلاثي الأبعاد 5 ي 7 أيام ‫10 أيام 14 يومًا ‫15 يومًا 21d 28 يومًا 30 يومًا 45 يومًا ‫60 يومًا 90 يومًا ‫120d ‫180 يومًا ‫270 يومًا 365 يومًا
استهداف الجمهور - الاستبعاد	لا	سلسلة، قائمة بقوائم أزواج	نعم	قائمة بقوائم المستخدمين المطلوب استبعادها من الاستهداف. يستخدِم هذا العمود أرقام تعريف الموارد FirstPartyAndPartnerAudience في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360". يتم إدراج كل شريحة جمهور كزوج من FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId وإعداد الحداثة، إذا كانت قائمة المستخدمين هي قائمة مستخدمين من الطرف الأول. الزوج هو (1;1d;‎)، حيث يمثّل 1d مدى الحداثة لعيّنة تبلغ يومًا واحدًا. ومع ذلك، بالنسبة إلى شرائح جمهور الجهات الخارجية، لا تتوفّر ميزة "الحداثة"، لذا يكون تنسيق القائمة هو (3;);(4;);. تنسيق القائمة = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);) مثال: "(1;1d;);(2;);". قيم الحداثة الصالحة هي: الكل دقيقة واحدة ‫5 دقائق ‫10 دقائق ‫15 دقيقة ‫30 دقيقة 1 س ساعتان 3 ساعات 6 ساعات ‫12 ساعة يوم واحد يومَان ثلاثي الأبعاد 5 ي 7 أيام ‫10 أيام 14 يومًا ‫15 يومًا 21d 28 يومًا 30 يومًا 45 يومًا ‫60 يومًا 90 يومًا ‫120d ‫180 يومًا ‫270 يومًا 365 يومًا
استهداف الجمهور ذي الاهتمامات المشتركة والجمهور في السوق - تضمين	لا	سلسلة أو قائمة	نعم
استهداف الجمهور ذي الاهتمامات المشتركة والجمهور في السوق - الاستبعاد	لا	سلسلة أو قائمة	نعم
استهداف الفئة الديمغرافية حسب الجنس	لا	سلسلة أو قائمة	نعم	قائمة الأجناس المطلوب استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة: أنثى ذكر غير معروف
استهداف الفئة الديمغرافية حسب العمر	لا	سلسلة أو قائمة	نعم	استهداف فئة عمرية معيّنة من المستخدمين حدِّد نطاقًا من/إلى من خلال اختيار عمر واحد من وعمر واحد إلى وما إذا كان سيتم تضمين الأعمار غير المعروفة صواب/خطأ. اطّلِع على قائمة الأعمار المقبولة في الحقلَين "من" و"إلى". المثال 1: لاستهداف الفئة العمرية 18-55 عامًا وتضمين الأعمار غير المعروفة، حدِّد التنسيق {من؛ إلى؛ تضمين الأعمار غير المعروفة صحيح/خطأ} = 18؛55؛صحيح؛ المثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستبعاد الأعمار غير المعروفة، حدِّد ما يلي = 35؛+؛خطأ؛. القيم المقبولة في الحقل "من": 18 25 35 45 55 65 القيم المقبولة في الحقل "إلى" 25 35 45 55 65 +
استهداف الفئة الديمغرافية حسب الحالة الأبوية	نعم	سلسلة أو قائمة	نعم	قائمة بالحالات الأبوية التي تريد استهدافها. اختَر قيمة واحدة أو أكثر من القيم المقبولة. أحد الوالدين ليس أحد الوالدين غير معروف
استهداف الأجهزة - التضمين	لا	سلسلة أو قائمة	نعم	قائمة الأجهزة المطلوب تضمينها في الاستهداف. يستخدِم هذا العمود أرقام تعريف موارد واجهة برمجة التطبيقات TargetingOption في "مساحة العرض والفيديو 360" لأنواع الاستهداف التالية: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.
استهداف حجم مشغّل الفيديو	لا	سلسلة أو قائمة	نعم	قائمة بأحجام مشغّل إعلانات الفيديو التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة: غير معروف صغير كبير الدقة العالية
خاصة - اسم البائع	لا	سلسلة	لا	تمثّل هذه السمة اسم الناشر في صفقة. ينطبق هذا الحقل على منتجات الوسائط الخاصة فقط.
خاص - معرّف الطلب	لا	سلسلة	لا	معرّف طلب الصفقة المضمونة. ينطبق هذا الحقل على منتجات الوسائط الخاصة فقط.
خاص - رقم تعريف مصدر المساحات الإعلانية	لا	سلسلة	لا	معرّف مصدر المساحات الإعلانية في "مدير حملة DoubleClick" ينطبق هذا الحقل على منتجات الوسائط الخاصة فقط.