تعديل بيانات الجمهور وإعادة تحميل الإعلانات

عند إنشاء جمهور مخصّص، يمكنك تحديد بعض أو كل البيانات الوصفية للجمهور المخصّص. يمكن تمرير هذه المعلومات مباشرةً عند إنشاء عنصر CustomAudience. يتيح CustomAudience.Builder أيضًا استخدام حقل dailyUpdateUri الذي يمكنه توفير البيانات الوصفية وتعديلها. ستنفّذ المنصة مهمة في الخلفية كل 24 ساعة لجلب البيانات الوصفية المعدَّلة من dailyUpdateUri، أو كل أربع ساعات إذا كان الجمهور المخصّص لا يملك بعد AdData اللازم للمشاركة في مزاد. يمكن للمنصة تعديل الأجزاء التالية من البيانات الوصفية لشرائح الجمهور المخصّصة:

• إشارات عروض أسعار المستخدمين
• بيانات عروض الأسعار الموثوق بها
• قائمة واحدة (AdData)

لتعديل هذه البيانات الوصفية، يتم تنفيذ عملية تعديل يومية في الخلفية من خلال طلب بحث مقابل dailyUpdateUri المحدّد في شريحة الجمهور المخصّصة، ما قد يؤدي إلى عرض استجابة بتنسيق JSON.

• قد تتضمّن استجابة JSON أيًا من حقول البيانات الوصفية المتوافقة التي يجب تعديلها.
• يتم التحقّق من صحة كل حقل JSON بشكل مستقل. يتجاهل العميل أي حقول مكتوبة بشكلٍ غير صحيح، ما يؤدي إلى عدم إجراء أي تعديلات على هذا الحقل المعيّن في الردّ.
• يؤدي تلقّي استجابة HTTP فارغة أو كائن JSON فارغ "{}" إلى عدم تعديل البيانات الوصفية.
• يجب ألا يتجاوز حجم رسالة الرد 10 كيلوبايت.
• يجب أن تستخدم جميع معرّفات الموارد المنتظمة (URI) بروتوكول HTTPS.
• يجب أن يتشارك trusted_bidding_uri مع المشتري في اسم النطاق ذي المستوى الأعلى الفعّال + 1.

مثال: استجابة JSON لتحديث يومي في الخلفية

{
    "user_bidding_signals" : { ... },  // Valid JSON object
    "trusted_bidding_data" : {
        "trusted_bidding_uri" : "example-dsp1-key-value-service.com",
        "trusted_bidding_keys" : [ "campaign123", "campaign456", ... ]
    },
    "ads" : [
        {
            "render_uri" : "www.example-dsp1.com/.../campaign123.html",
            "metadata" : { ... }  // Valid JSON object
        },
        {
            "render_uri" : "www.example-dsp1.com/.../campaign456.html",
            "metadata" : { ... }  // Valid JSON object
        },
        ...
    ]
}

يمكنك الاطّلاع على تعريف الخادم الوهمي هذا للحصول على مثال على نوع البيانات التي قد يتم تضمينها في الاستجابة.