توفّر Google قوائم مجمّعة لإعدادات الناشرين من خلال تحميلها إلى حزمة Google Cloud Storage الخاصة بالحساب (ضمن مشروع تملكه Google). ويمكنك تنزيلها للاستخدام مع الاستهداف الذي لا يمكن تنفيذه في وقت عروض الأسعار. يمكنك التواصل مع المدير التقني للحسابات لتفعيل هذه الميزة في حسابك.
يمكن تنزيل الملفات التي تحتوي على إعدادات الناشرين آليًا باستخدام واجهة برمجة تطبيقات Cloud Storage، يدويًا من خلال واجهة مستخدم Google Developer Console أو باستخدام أداة سطر الأوامر gsutil. يُرجى الاطّلاع على مستندات Google Cloud Storage لمزيد من التفاصيل حول الوصول إلى البيانات المُخزَّنة في Google Cloud Storage.
يتم ضغط الملف باستخدام gzip وفقًا لمعيار RFC 1952. لاستخراج الملف من
سطر الأوامر، شغِّل gzip -d <filename>. لاستخراج الملف آليًا، يمكنك استخدام zlib أو مكتبة ضغط مشابهة متوافقة مع تنسيق gzip. وتكون النتيجة عبارة عن مخزن مؤقت لبروتوكول تسلسلي، يشبه الحمولة في طلب POST في BidRequest، ويمكن تحليله بالمقتطف التالي:
string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
PublisherSettingsList publisher_settings;
if (publisher_settings.ParseFromString(uncompressed)) {
// Process the publisher settings.
}
يمكن تنزيل تعريف المخزن المؤقت للبروتوكول PublisherSettingsList من صفحة البيانات المرجعية. يمكنك أيضًا طلب ملف publisher-settings.pb.gz مضغوط من ممثل الحساب. ويحتوي الملف على تعريف التخزين المؤقت للبروتوكول، بالإضافة إلى مثال لملف إعدادات الناشر.
ويمكن أن يتغيّر ترتيب PublisherSettingsList في أي وقت.
لا يتم ضمان أي ترتيب أو ترتيب معيّن. يحتوي كل إدخال في قائمة إعدادات الناشر على معرّف، والعديد من الإعدادات التي تنطبق على
BidRequests التي تم وضع علامة عليها باستخدام ذلك المعرّف. يمكنك إضافة ميزة إلى
أنظمة عروض الأسعار لديك للبحث بشكل دوري عن قائمة إعدادات ناشر جديدة.
عندما تتلقّى Google مرة ظهور مؤهَّلة لعرض الأسعار في الوقت الفعلي، تُدرِج Google معرّفات في طلب عرض السعر تتوافق مع الإدخالات في قائمة إعدادات الناشر. يمكن لنظام عروض الأسعار استخدام إعدادات الناشر لفلترة إعلانات المرشح لمرة الظهور هذه. لكي يصبح الإعلان المرشح مؤهّلاً للظهور مرة معيّنة، يجب أن يلتزم بجميع إدخالات إعدادات الناشر التي تم إرسال المعرّفات لها في الطلب.
تجدر الإشارة إلى أنّ أي إعدادات مفقودة للناشر من الملف سببها المعرّفات غير المرتبطة بعناوين URL المحظورة.
يتم تقسيم ملف إعدادات الناشر إلى عدة ملفات أصغر لتقليل مقدار البيانات التي يجب تنزيلها في عملية واحدة. وتُقسَّم الملفات إلى أجزاء بحجم 5 ميغابايت تقريبًا وتتضمّن أسماء مثل publisher-settings.0.pb.gz حتى publisher-settings.n.pb.gz (حيث n هو عدد الملفات ناقص ملف واحد). يُرجى التواصل مع ممثل حسابك للحصول على
هذه الملفات.