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

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

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

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

  • قد يحتوي ردّ JSON على أيّ من حقول البيانات الوصفية المتوافقة التي تحتاج إلى التحديث.
  • يتم التحقّق من صحة كل حقل JSON بشكل مستقل. يتجاهل العميل أيّ حقول ذات تنسيق غير صحيح، ما يؤدي إلى عدم إجراء أي تعديلات على ذلك الحقل المحدّد في الاستجابة.
  • لا يؤدي استجابة HTTP فارغة أو كائن JSON فارغ "{}" إلى تعديل البيانات الوصفية.
  • يجب ألا يزيد حجم رسالة الردّ عن 10 كيلوبايت.
  • يجب استخدام بروتوكول HTTPS في جميع معرّفات الموارد المنتظمة (URI).
  • يجب أن يتشارك trusted_bidding_uri مع المشتري عنوان ETLD+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
        },
        ...
    ]
}

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