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