آخر تعديل: 2023-10-18
يرشدك هذا الدليل خلال عملية النقل إلى الإصدار 7 من ملفات البيانات المنظَّمة (SDF) من إصدار سابق والتغييرات، المطلوبة والمقترَحة، التي يمكنك إجراؤها لتحسين عملية الدمج بشكل أفضل.
يمكنك الاطّلاع على ملاحظات الإصدار للحصول على قائمة شاملة بالاختلافات بين الإصدارين 6 و7.
نقل إصدار ملفات البيانات المنظَّمة
يتطلّب نقل البيانات إلى الإصدار 7 من ملفات البيانات المنظَّمة من إصدار سابق تحديد الإصدار الجديد، وتحديث مساحات أرقام التعريف لمجموعة فرعية من الأعمدة الحالية، وإضافة عملية دمج مع الأعمدة الجديدة.
تعديل إصدار ملفات البيانات المنظَّمة
للحصول على إصدار جديد من ملفات البيانات المنظَّمة، عليك تحديث النسخة التي تحدّدها لموارد الشريك والمعلِن الرئيسية ومهام التنزيل الفردية في مساحة العرض والفيديو 360 API.
تعديل إعدادات المورد الرئيسي
يتم ضبط نسخة تلقائية من "ملفات البيانات المنظَّمة" على مستوى موارد الشريك والمعلِن. يُستخدم هذا الإصدار كالخيار التلقائي عند تنزيل ملفات البيانات المنظَّمة من خلال الواجهة أو واجهة برمجة التطبيقات.
الضبط في الواجهة
- على مستوى الشريك
- انتقِل إلى الشريك المقصود. انتقِل إلى صفحة التفاصيل الأساسية ضمن قائمة إعدادات الشركاء في شريط التنقّل الأيمن. عدِّل إعدادات إصدار SDF في قسم ملفات البيانات المنظَّمة إلى v7.
- على مستوى المعلِن
- انتقِل إلى المعلِن المقصود. انتقل إلى صفحة التفاصيل الأساسية ضمن قائمة إعدادات المعلن في شريط التنقل الأيمن. عدِّل إعدادات إصدار أداة تطوير البرامج (SDF) في قسم ملفات البيانات المنظَّمة إلى الإصدار 7. وفي حال ضبط الإصدار التلقائي على مستوى الشريك، قد لا يكون هذا الإعداد قابلاً للتعديل.
الضبط في واجهة برمجة التطبيقات
- على مستوى المعلِن
- يمكنك تقديم طلب
advertisers.patchلتعديلdataAccessConfig.sdfConfig.sdfConfig.versionإلىSDF_VERSION_7، وإذا لزم الأمر،dataAccessConfig.sdfConfig.overridePartnerSdfConfigإلىTrue.
تعديل طلبات sdfdownloadtasks.create في واجهة برمجة التطبيقات
عند تقديم طلب sdfdownloadtasks.create باستخدام واجهة برمجة التطبيقات "مساحة العرض والفيديو 360"، اضبط الحقل version في نص الطلب على SDF_VERSION_7.
تعديل أرقام التعريف في الأعمدة المطلوبة
في الإصدار 7، تم تعديل مساحات أرقام التعريف التي تستخدمها مجموعة فرعية من الأعمدة وذلك لفصل ملفات البيانات المنظَّمة من منتج "قراءة ملفات الكيان" المتوقّف نهائيًا وزيادة التوافق مع الأدوات المتوافقة، مثل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".
يسرد هذا القسم كل عمود باستخدام معرّفات مختلفة عن الإصدار 6 وتعليمات حول كيفية استرداد معلومات مرجعية للقيم الجديدة.
طلب الإدراج
| الإصدار 7 من تعليمات نقل بيانات الأعمدة | |
|---|---|
|
استهداف التطبيقات - استثناء استهداف التطبيقات - تضمين |
تم تعديل هذه الأعمدة لتستخدم معرّفات التطبيقات المتوافقة مع التنسيق يتم تحديد منصات التطبيقات من خلال قيمة سلسلة. معرّفات التطبيقات هي المعرّفات التي تقدّمها المنصة المعنية، مثل معرّف الحزمة من "متجر Play" لنظام التشغيل Android أو رقم تعريف التطبيق من App Store الخاص بشركة Apple. |
|
استهداف المتصفح - استبعاد استهداف المتصفح - تضمين |
تم تعديل هذا العمود ليستخدم قيم
يمكنك استرداد موارد
|
|
استهداف شركات الجوّال - استبعاد استهداف شركات الجوّال - تضمين |
تم تعديل هذا العمود ليستخدم قيم
يمكنك استرداد موارد
|
|
استهداف القنوات - استبعاد استهداف القنوات - تضمين |
تم تعديل هذا العمود ليستخدم القيمة
يمكنك استرداد موارد
|
|
استهداف الأجهزة - استثناء استهداف الأجهزة - تضمين |
تم تعديل هذا العمود لاستخدام موارد
يمكنك استرداد موارد
|
| قياس قناة DAR |
تم تعديل هذا العمود ليستخدم القيمة
يمكنك استرداد موارد
|
استهداف المواقع - استبعاد استهداف الموقع - تضمين |
تم تعديل هذا العمود لتحديد المواقع الإلكترونية من خلال سلاسل عناوين URL. |
عنصر
| الإصدار 7 من تعليمات نقل بيانات الأعمدة | |
|---|---|
|
استهداف التطبيقات - استثناء استهداف التطبيقات - تضمين |
تم تعديل هذه الأعمدة لتستخدم معرّفات التطبيقات المتوافقة مع التنسيق يتم تحديد منصات التطبيقات من خلال قيمة سلسلة. معرّفات التطبيقات هي المعرّفات التي تقدّمها المنصة المعنية، مثل معرّف الحزمة من "متجر Play" لنظام التشغيل Android أو رقم تعريف التطبيق من App Store الخاص بشركة Apple. |
| مضاعفات عروض الأسعار |
تم تعديل هذا العمود لاستخدام أرقام تعريف المعايير الجديدة لأنواع صفوف التطبيق والموقع. تم تعديل نوع الصف app لاستخدام قيم السلسلة المتسلسلة للمنصة الأساسية للتطبيق ورقم تعريف النظام الأساسي للتطبيق، مع الفصل بينها بنقطتَين، لأرقام تعريف المعايير. يتم تحديد منصات التطبيقات من خلال قيمة سلسلة. أرقام تعريف التطبيقات هي المعرّفات التي تقدّمها المنصة ذات الصلة، مثل معرّف الحزمة من "متجر Play" لنظام التشغيل Android أو رقم تعريف التطبيق من App Store الخاص بشركة Apple. تم تعديل نوع الصف site لاستخدام سلاسل عناوين URL كأرقام تعريف المعايير. |
|
استهداف المتصفح - استبعاد استهداف المتصفح - تضمين |
تم تعديل هذا العمود ليستخدم قيم
يمكنك استرداد موارد
|
|
استهداف شركات الجوّال - استبعاد استهداف شركات الجوّال - تضمين |
تم تعديل هذا العمود ليستخدم قيم
يمكنك استرداد موارد
|
|
استهداف القنوات - استبعاد استهداف القنوات - تضمين |
تم تعديل هذا العمود ليستخدم القيمة
يمكنك استرداد موارد
|
|
استهداف الأجهزة - استثناء استهداف الأجهزة - تضمين |
تم تعديل هذا العمود لاستخدام موارد
يمكنك استرداد موارد
|
استهداف المواقع - استبعاد استهداف الموقع - تضمين |
تم تعديل هذا العمود لتحديد المواقع الإلكترونية من خلال سلاسل عناوين URL. |
منتج الوسائط
| الإصدار 7 من تعليمات نقل بيانات الأعمدة | |
|---|---|
|
استهداف القنوات - استبعاد استهداف القنوات - تضمين |
تم تعديل هذا العمود ليستخدم القيمة
يمكنك استرداد موارد
|
| استهداف الأجهزة - تضمين |
تم تعديل هذا العمود لاستخدام موارد
يمكنك استرداد موارد
|
إضافة دمج مع الأعمدة المضافة منذ الإصدار 6
في حالة النقل من الإصدار 6 إلى الإصدار 7، تحتاج إلى إضافة الأعمدة التالية إلى الملفات ذات الصلة:
| نوع الملف | العمود |
|---|---|
| عنصر | عدد مرّات الظهور المستهدَف في TrueView |
| عنصر | النافذة الزمنية لعدد مرّات الظهور المستهدَف في TrueView |
| مجموعة الإعلانات على YouTube | الاستهداف المحسّن |
إذا كنت بصدد نقل البيانات من إصدار سابق من ملفات البيانات المنظَّمة، يُرجى الرجوع إلى ملاحظات إصدار ملفات البيانات المنظَّمة للحصول على معلومات عن الأعمدة الإضافية التي تمت إضافتها بين الإصدار الحالي والإصدار 6 من SDF.
تغييرات إضافية
في الإصدار 7، أجرينا أيضًا بعض التغييرات السطحية التي من شأنها مساعدتك في تبسيط عملية الدمج والتوقف عن استخدام ملفات "القراءة" المتوقّفة نهائيًا للرجوع إليها.
ترتيب جديد في القوائم لبعض الأعمدة
يضمن الإصدار 7 من SDF ترتيبًا مستقرًا لأعمدة قائمة معينة عند إنشاء الملف. وينتج عن ذلك سلوك أكثر اتساقًا ومراجعة أسهل. لا يتم فرض هذا الترتيب عند تحميل الملف، ولكن يتم تطبيقه لاحقًا عند إنشاء الملف المحدّث.
راجع ملاحظات إصدار الإصدار 7 للحصول على قائمة كاملة بالأعمدة التي يتم إنشاؤها الآن بترتيب تصاعدي رقمي أو أبجدي.
اقتراحات جديدة لمراجع المعرّفات
لقد عدّلنا تعريفات عدد من الأعمدة لإزالة المرجع إلى "ملفات قراءة الكيانات" المتوقّفة نهائيًا، ونقترح بدلاً من ذلك وسائل أخرى للبحث عن المعرّف.
لا تختلف القيم التي تعرضها الأعمدة التالية عن القيم في الإصدار 6 من SDF، لكننا نقترح عليك تعديل عملية الدمج لاسترداد أرقام التعريف باستخدام الطريقة الجديدة المقترَحة، والتي يمكن العثور عليها في أوصاف الأعمدة المستنِدة إلى الإصدار 7.
| أنواع الملفات وأعمدتها | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| الحملة |
|
|||||||||||||||||||||
| طلب الإدراج |
|
|||||||||||||||||||||
| العنصر |
|
|||||||||||||||||||||
| منتج الوسائط |
|
|||||||||||||||||||||
| المجموعة الإعلانية على YouTube |
|
|||||||||||||||||||||