تاريخ التعديل الأخير: 18/10/2023
يرشدك هذا الدليل خلال عملية الانتقال إلى الإصدار 7 من ملفات البيانات المنظَّمة (SDF) من إصدار سابق والتغييرات المطلوبة والمقترَحة على حد سواء، والتي يمكنك إجراؤها لتحسين عملية الدمج.
يمكنك مراجعة ملاحظات الإصدار للحصول على قائمة شاملة بالاختلافات بين الإصدارين 6 و7.
نقل إصدار ملفات البيانات المنظَّمة
لنقل البيانات إلى الإصدار 7 من ملفات البيانات المنظَّمة من إصدار سابق، يجب تحديد الإصدار الجديد وتعديل مساحات أرقام التعريف لمجموعة فرعية من الأعمدة الحالية وإضافة عملية دمج مع أعمدة جديدة.
تحديث إصدار ملفات البيانات المنظَّمة
للتحديث إلى إصدار جديد من "ملفات البيانات المنظَّمة"، عليك تحديث الإصدار الذي تحدّده لموارد الشريك والمعلِن الرئيسي ومهام التنزيل الفردية في واجهة برمجة التطبيقات لمساحة العرض والفيديو 360.
تعديل إعدادات المراجع الرئيسية
ويتم ضبط نسخة تلقائية من "ملفات البيانات المنظَّمة" على مستوى موارد الشريك والمعلِن. يتم استخدام هذا الإصدار كإعداد تلقائي عند تنزيل ملفات البيانات المنظَّمة من خلال الواجهة أو واجهة برمجة التطبيقات.
الضبط في الواجهة
- على مستوى الشركاء
- انتقِل إلى الشريك المعنيّ. انتقِل إلى صفحة التفاصيل الأساسية ضمن القائمة إعدادات الشركاء في شريط التنقّل الأيمن. حدِّث إعداد إصدار SDF في قسم ملفات البيانات المنظَّمة إلى v7.
- على مستوى المعلِن
- انتقِل إلى المعلِن المقصود. انتقِل إلى صفحة التفاصيل الأساسية ضمن القائمة إعدادات المعلِن في شريط التنقّل الأيمن. حدِّث إعداد إصدار SDF في قسم ملفات البيانات المنظَّمة إلى v7. وإذا تم ضبط النسخة التلقائية على مستوى الشريك، قد لا يكون هذا الإعداد قابلاً للتعديل.
الضبط في واجهة برمجة التطبيقات
- على مستوى المعلِن
- يمكنك تقديم طلب في
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 أو رقم تعريف التطبيق من متجر تطبيقات Apple. |
|
استهداف المتصفّحات - استبعاد استهداف المتصفّحات - تضمين |
تم تعديل هذا العمود لاستخدام قيم
استرِدّ موارد
|
|
استهداف شركات الجوّال - استبعاد استهداف شركات الجوّال - تضمين |
تم تعديل هذا العمود لاستخدام قيم
استرِدّ موارد
|
|
استهداف القنوات - استبعاد استهداف القنوات - تضمين |
تم تعديل هذا العمود لاستخدام القيمة
يمكنك استرداد موارد
|
|
استهداف الأجهزة - استبعاد استهداف الأجهزة - تضمين |
تم تعديل هذا العمود لاستخدام قيم
استرِدّ موارد
|
| قياس قناة DAR |
تم تعديل هذا العمود لاستخدام القيمة
يمكنك استرداد موارد
|
استهداف المواقع - استبعاد استهداف المواقع - تضمين |
تم تعديل هذا العمود لتحديد المواقع الإلكترونية من خلال سلاسل عناوين URL. |
البند
| الإصدار 7 من تعليمات نقل بيانات الأعمدة | |
|---|---|
|
استهداف التطبيقات - استبعاد استهداف التطبيقات - تضمين |
تم تعديل هذه الأعمدة لاستخدام معرّفات التطبيقات التي تتبع
التنسيق " يتم تحديد الأنظمة الأساسية للتطبيقات من خلال قيمة سلسلة. أرقام تعريف التطبيقات هي أرقام التعريف التي يقدّمها النظام الأساسي ذو الصلة، مثل معرّف الحزمة من "متجر Play" الخاص بأجهزة Android أو رقم تعريف التطبيق من متجر تطبيقات Apple. |
| مضاعفات عروض الأسعار |
تم تعديل هذا العمود لاستخدام أرقام تعريف معايير جديدة لأنواع الصفوف app وsite. تم تعديل نوع صف app لاستخدام قيم سلسلة تسلسلية للنظام الأساسي للتطبيق ورقم تعريف النظام الأساسي للتطبيق، مع الفصل بينهما بنقطتين، لأرقام تعريف المعايير. يتم تحديد الأنظمة الأساسية للتطبيقات من خلال قيمة سلسلة. معرّفات التطبيقات هي المعرّفات التي يقدّمها النظام الأساسي ذو الصلة، مثل معرّف الحزمة من "متجر Play" الخاص بنظام التشغيل Android أو رقم تعريف التطبيق من App Store من Apple. تم تعديل نوع الصفّ site لاستخدام سلاسل عناوين URL كأرقام تعريف المعايير. |
|
استهداف المتصفّحات - استبعاد استهداف المتصفّحات - تضمين |
تم تعديل هذا العمود لاستخدام قيم
استرِدّ موارد
|
|
استهداف شركات الجوّال - استبعاد استهداف شركات الجوّال - تضمين |
تم تعديل هذا العمود لاستخدام قيم
استرِدّ موارد
|
|
استهداف القنوات - استبعاد استهداف القنوات - تضمين |
تم تعديل هذا العمود لاستخدام القيمة
يمكنك استرداد موارد
|
|
استهداف الأجهزة - استبعاد استهداف الأجهزة - تضمين |
تم تعديل هذا العمود لاستخدام قيم
استرِدّ موارد
|
استهداف المواقع - استبعاد استهداف المواقع - تضمين |
تم تعديل هذا العمود لتحديد المواقع الإلكترونية من خلال سلاسل عناوين URL. |
منتج الوسائط
| الإصدار 7 من تعليمات نقل بيانات الأعمدة | |
|---|---|
|
استهداف القنوات - استبعاد استهداف القنوات - تضمين |
تم تعديل هذا العمود لاستخدام القيمة
يمكنك استرداد موارد
|
| استهداف الأجهزة - تضمين |
تم تعديل هذا العمود لاستخدام قيم
استرِدّ موارد
|
إضافة عملية دمج مع الأعمدة المُضافة منذ الإصدار 6
في حال الانتقال من إصدار v6 إلى v7، عليك إضافة الأعمدة التالية إلى الملفات ذات الصلة:
| نوع الملف | العمود |
|---|---|
| البند | عدد مرّات الظهور المستهدَف في TrueView |
| البند | الفترة الزمنية لمعدل التكرار المستهدَف في TrueView |
| مجموعة الإعلانات على YouTube | الاستهداف المحسّن |
إذا كنت تريد نقل البيانات من إصدار سابق من "ملفات البيانات المنظَّمة"، راجِع ملاحظات إصدار ملفات البيانات المنظَّمة للحصول على معلومات حول الأعمدة الإضافية التي تمت إضافتها بين الإصدار الحالي والإصدار 6 من SDF.
تغييرات إضافية
في الإصدار 7، أجرينا أيضًا بعض التغييرات السطحية التي من شأنها مساعدتك في تبسيط عملية الدمج والابتعاد عن استخدام "ملفات قراءة الكيان" المتوقّفة كمرجع.
ترتيب جديد لمجموعة فرعية من الأعمدة
يضمن الإصدار 7 من SDF ترتيبًا ثابتًا لبعض أعمدة القائمة عند إنشاء الملف. ينتج عن ذلك سلوك أكثر اتساقًا ومراجعة أسهل. لا يتم فرض هذا الترتيب على تحميل الملف، ولكن يتم تطبيقه لاحقًا عند إنشاء الملف المحدّث.
راجِع ملاحظات الإصدار 7 للحصول على قائمة كاملة بالأعمدة التي يتم إنشاؤها الآن إما بترتيب رقمي أو أبجدي ترتيبي تصاعدي.
اقتراحات جديدة بشأن مستندات تعريف الهوية
لقد عدّلنا تعريفات عدد من الأعمدة لإزالة الإشارة إلى ملفات قراءة الكيان المتوقّفة نهائيًا واقتراح طرق أخرى للبحث بدلاً من ذلك.
لا تختلف القيم التي تعرضها الأعمدة التالية عن القيم الموجودة في الإصدار 6 من SDF، ولكننا نقترح عليك تحديث عملية الدمج لاسترداد المعرّفات باستخدام الطريقة الجديدة الموصى بها، والتي يمكن العثور عليها في أوصاف أعمدة الإصدار 7.
| أنواع الملفات وأعمدتها | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| الحملة |
|
|||||||||||||||||||||
| طلب إدراج |
|
|||||||||||||||||||||
| تفاصيل الإعلان |
|
|||||||||||||||||||||
| منتج إعلامي |
|
|||||||||||||||||||||
| المجموعة الإعلانية على YouTube |
|
|||||||||||||||||||||