تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نقل البيانات إلى الإصدار 8 من "ملفات البيانات المنظَّمة"

تاريخ آخر تعديل: 12‏/11‏/2024

يرشدك هذا الدليل خلال عملية نقل البيانات من استخدام "ملفّات البيانات المنظَّمة" في الإصدار 7.1 إلى الإصدار 8، ويوضّح التغييرات بين الإصدارَين التي قد تؤثر في عملية الدمج.

اطّلِع على ملاحظات الإصدار للحصول على قائمة شاملة بالاختلافات بين الإصدارَين 7.1 و8.

نقل إصدار ملفات البيانات المنظَّمة

لنقل البيانات إلى الإصدار 8 من "ملفات البيانات المنظَّمة" (SDF) من إصدار سابق:

عدِّل مواردك وإجراءات إنشاء ملفات SDF لاستخدام الإصدار 8.
تعديل منطق مورد الإعلان لتحديد نوع عند الإنشاء
إضافة منطق جديد لقراءة موارد "الحملات لزيادة الطلب" وإنشائها وتعديلها

تعديل إصدار ملفات البيانات المنظَّمة

لاستخدام إصدار جديد من "ملفات البيانات المنسّقة"، عدِّل الإصدار المحدّد في موارد الشركاء والمعلنين الرئيسية واستخدِم الإصدار الجديد عند إنشاء مهام تنزيل فردية في Display & Video 360 API.

تعديل إعدادات المورد الرئيسي

يتم ضبط إصدار تلقائي لملفات البيانات المنظَّمة على مستوى موارد العميل والشريك. يتم استخدام هذا الإصدار كخيار تلقائي عند تنزيل "ملفّات البيانات من الموقع" من خلال الواجهة أو واجهة برمجة التطبيقات.

الإعداد في الواجهة

على مستوى الشريك

انتقِل إلى الشريك المعنيّ.
وسِّع قائمة إعدادات الشريك في قائمة التنقّل اليمنى وانتقِل إلى صفحة التفاصيل الأساسية.
عدِّل إعدادات إصدار SDF في قسم ملفات البيانات المنظَّمة ليصبح v8.

على مستوى المعلِن

انتقِل إلى المعلِن المقصود.
وسِّع قائمة إعدادات المعلِن في قائمة التنقّل اليمنى، ثم انتقِل إلى صفحة التفاصيل الأساسية.
عدِّل إعدادات إصدار SDF في قسم ملفات البيانات المنظَّمة إلى الإصدار 8. إذا تم ضبط الإصدار التلقائي على مستوى الشريك، قد لا يكون هذا الإعداد قابلاً للتعديل.

الإعداد في واجهة برمجة التطبيقات

على مستوى الشريك: لا يمكنك ضبط إصدار SDF التلقائي على مستوى الشريك في واجهة برمجة التطبيقات.
على مستوى المعلِن: قدِّم طلبًا إلى advertisers.patch لتعديل dataAccessConfig.sdfConfig.sdfConfig.version إلى SDF_VERSION_8، وإذا لزم الأمر، dataAccessConfig.sdfConfig.overridePartnerSdfConfig إلى True.

تعديل طلبات `sdfdownloadtasks.create` في واجهة برمجة التطبيقات

عند إجراء طلب sdfdownloadtasks.create باستخدام واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"، اضبط الحقل version في نص الطلب على SDF_VERSION_8.

تحديد النوع في "موارد الإعلانات"

تُضيف الإصدارة 8 عمود Ad Type إلى ملفات Ad، ما يعرض نوع الإعلان الذي يمثّله كل صف. هذا العمود الجديد مطلوب وسيتمّ تعبئته للموارد الحالية عند تنزيل ملفات الإعلانات بتنسيق الإصدار 8.

عند تعديل الإعلانات الحالية، يجب عدم تغيير قيمة هذا العمود.

عند إنشاء إعلانات جديدة، عليك ملء هذا العمود بإحدى القيم المُدرَجة في وصف العمود.

تعديل منطق موارد "زيادة الطلب"

تتيح الإصدار 8 إنشاء "الحملات لزيادة الطلب" واستردادها وتعديلها باستخدامملفّات العنصر والمجموعة الإعلانية والإعلان. تستخدِم موارد Demand Gen منطقًا مختلفًا للتحقّق من الطابع الزمني، وتتطلّب تعبئة أعمدة إضافية، وتفرض قيودًا جديدة على أنواع الملفات الثلاثة.

إثبات صحة الطابع الزمني

بالنسبة إلى جميع العناصر غير المخصّصة لزيادة الطلب، يتمّ ملء عمود Timestamp في ملف تفاصيل الإعلان عند تنزيله بآخر مرة تمّ فيها تعديل ملف Timestamp. تُستخدَم هذه القيمة عند تعديل عنصر باستخدام تنسيق SDF للتحقّق مما يلي: لم يتم تعديل عنصر منذ تنزيل الملف الأصلي. في هذه الحالة، يتعذّر إجراء التعديل.

بالنسبة إلى عناصر "حملات زيادة الطلب"، يعمل عمود Timestamp وعمود التحقّق المصاحب له بطريقة مختلفة. بالنسبة إلى إدخالات عناصر "الحملات لزيادة الطلب"، تتم تعبئة العمود بالوقت الحالي عند التنزيل. عند التحميل، تتحقق "مساحة العرض والفيديو 360" مما إذا كان قد مرّ أكثر من 24 ساعة على الطابع الزمني المحدّد. وإذا مرت أكثر من 24 ساعة، يتم اعتبار إدخال الملف الأصلي قديمًا وتفشل عملية الادخال. في هذه الحالة، نزِّل الملف مرة أخرى وأدخِل التعديلات استنادًا إلى الإصدار الأحدث. لا تمنع طريقة إثبات الملكية الجديدة استبدال التغييرات التي تم إجراؤها في آخر 24 ساعة. لتجنُّب التبديل العميق غير المقصود، يجب تضمين العناصر التي تريد تعديلها في ملفاتك التي تحمّلها فقط، والتي تخصّ "زيادة الطلب".

الأعمدة المطلوبة

تحتوي أنواع الملفات التالية على أعمدة مطلوبة الآن لبعض موارد Demand Gen، بالإضافة إلى الأعمدة المطلوبة لجميع كيانات نوع الملف هذا.

العنصر

الأعمدة المطلوبة للقيم التالية في عمود "البند" Type

الحملات لزيادة الطلب

Pacing Amount

TrueView Bid Strategy Type

TrueView Bid Strategy Value

القيود المعدَّلة

بالإضافة إلى الأعمدة المطلوبة الجديدة لبعض مواد عرض و إعلانات "الحملات لزيادة الطلب"، تفرض أعمدة متعدّدة في أنواع ملفات مواد العرض والمجموعات الإعلانية و الإعلانات قيود استخدام جديدة تنطبق على موارد "الحملات لزيادة الطلب".

هذه القيود كثيرة ومخصّصة للأعمدة المعنيّة، لذا لا يقدّم هذا الدليل قائمة شاملة بالقيود. ننصحك بقراءة مستندات الإصدار 8 المرجعية بعناية لأنواع ملفات العنصر ومجموعة الإعلانات والإعلان قبل إنشاء موارد الحملات لزيادة الطلب أو تعديلها باستخدام عملية تحميل SDF.