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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لا يمكنك ضبط إصدار 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، ما يعرض نوع Ad الممثّل بكل صف. هذا العمود الجديد مطلوب وسيتمّ تعبئته للموارد الحالية عند تنزيل ملفات الإعلانات بتنسيق الإصدار 8.

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

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

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

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

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

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

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

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

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

العنصر

الأعمدة المطلوبة للقيم التالية في عمود "البند" Type
الحملات لزيادة الطلب	Pacing Amount TrueView Bid Strategy Type TrueView Bid Strategy Value

إعلان

الأعمدة المطلوبة لقيم عمود Ad Type التالية Ad
الإعلان المتبدّل لزيادة الطلب	Business Name Call to Action Demand Gen Cards Description 1 Headline In-feed Video Headline Landing Page URL Logo Asset IDs
صورة لزيادة الطلب	Business Name Call to Action Description 1 Headline In-feed Video Headline Landing Page URL Logo Asset IDs Marketing Image Asset Id
منتج لزيادة الطلب	Business Name Description 1 Headline In-feed Video Headline Landing Page URL Logo Asset IDs
إعلان فيديو لزيادة الطلب	Business Name Call to Action Description 1 Headline In-feed Video Headline Landing Page URL Logo Asset IDs Video Id

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

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

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