إعداد تقارير تصحيح الأخطاء للجمهور المحمي

تسمح ميزة إعداد تقارير تصحيح الأخطاء في Protected Audience لمطوّري تكنولوجيا الإعلان بإعلان عن عناوين URL عن بُعد لتلقّي طلب GET من الأجهزة عند الفوز بمزاد أو خسارته. يتيح ذلك حالات الاستخدام التالية:

  • تلقّي تقارير عن نتائج المزاد التي تم الفوز بها والخسارة فيها
  • فهم أسباب خسارة المزادات على سبيل المثال: معرفة ما إذا كانت المشكلة تتعلّق بتنفيذ نص برمجي لعروض الأسعار أو التقييم أو مشكلة في المنطق الأساسي
  • اكتشاف المشاكل عند تعديل منطق JavaScript

تتوفّر ميزة إعداد تقارير تصحيح الأخطاء على مستوى الحدث للاختبار في "مبادرة حماية الخصوصية" الإصدار 9 من "الإصدار التجريبي للمطوّر". تتوفّر ميزة إعداد تقارير تصحيح الأخطاء على جميع الأجهزة التي يتوفّر فيها AdId.

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

اطّلِع على مزيد من المعلومات عن [تقرير تصحيح الأخطاء في مرحلة تقييم وتجربة FLEDGE الأصلية في Chrome الاقتراح][10].

الاستخدام

يتم تنفيذ ميزة إعداد تقارير تصحيح الأخطاء باستخدام واجهات برمجة تطبيقات JavaScript التالية، وكلاهما يأخذان سلسلة عنوان URL كوسيطة:

  • forDebuggingOnly.reportAdAuctionWin(String url)
  • forDebuggingOnly.reportAdAuctionLoss(String url)

يُبلِغ المثال التالي عن خسارة مزاد إعلان مع عرض السعر الفائز ومقاييس متغيّر داخلي. ويمكن استخدام هذه البيانات بعد ذلك لأغراض تصحيح الأخطاء.

let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);

يتم استبدال نموذج ${winningBid} بالقيمة الفعلية بعد اكتمال المزاد.

يمكن للبائعين اختياريًا عرض rejectReason من دالة scoreAds:

function scoreAd(ad, bid, auction_config, seller_signals,
                 trusted_scoring_signals, contextual_signal,
                 custom_audience_signal) {
  let score = ...
  return {
    'status': 0,
    'score': score,
    'rejectReason': 'blocked-by-publisher'
  }
}

إذا لم يحدّد البائع سببًا للرفض، يتم إرسال not-available بدلاً من ذلك.

متغيّرات عناوين URL

إنّ المتغيّرات التي يمكن إضافتها إلى عنوان URL لتصحيح الأخطاء تتوافق مع مقابلاتها في Chrome (على الرغم من أنّ ${topLevelWinningBid} و ${topLevelMadeWinningBid} غير متوفّرَين لأنّه لا يتوفّر مفهوم مزادات المكوّنات على Android).

اسم المتغيّر الوصف
winningBid قيمة عرض السعر الفائز.
madeWinningBid قيمة منطقية تمثّل ما إذا كان مشتري هذا الجمهور المخصّص قد قدّم العرض الفائز، إما من خلال هذا الجمهور المخصّص أو من خلال جمهور مخصّص آخر للمشتري نفسه.
highestScoringOtherBid قيمة عرض السعر الذي حصل على ثاني أعلى نتيجة من قِبل ملف برمجي لحساب تقييم البائع يُرجى العِلم أنّ هذه القيمة قد لا تكون ثاني أعلى قيمة لعرض سعر ، لأنّ النتائج وعروض الأسعار قد تكون مستقلة.
madeHighestScoringOtherBid قيمة منطقية تمثّل ما إذا كان مشتري هذا الجمهور المخصّص قد قدّم عرض السعر ${highestScoringOtherBid}، إمّا من خلال هذا الجمهور المخصّص أو من خلال جمهور مخصّص آخر للمشتري نفسه.
rejectReason سلسلة يضبطها البائع اختياريًا لشرح سبب رفضه عرض سعر. يمكن أن تكون أيًّا ممّا يلي:

  • not-available
  • invalid-bid
  • bid-below-auction-floor
  • pending-approval-by-exchange
  • disapproved-by-exchange
  • blocked-by-publisher
  • language-exclusions
  • category-exclusions

القيود

  • يجب أن يتطابق مضيف عنوان URL مع نطاق Privacy Sandbox المسجّل.
  • يجب ألا يتجاوز عنوان URL 4096 حرفًا، بما في ذلك النطاق والبادئة https:// وبيانات المزاد التي تم استبدالها.
  • في الإصدارات المستقبلية، لن يتم إرسال إشارات تصحيح الأخطاء إلا عند الاتصال بشبكة Wi-Fi.

السلوك على الجهاز فقط

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

تتحكّم سمات النظام التالية في معدّل دفعات البيانات وحجمها، ويمكن تعديلها لقيم أقل أثناء مرحلة التطوير:

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

تتراوح الفترة الزمنية المتوقّعة لظهور تقرير تصحيح الأخطاء بين 15 و60 دقيقة بعد اكتمال المزاد.

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

يمكن لكلّ تقنية إعلانية استخدام 75 عنوان URL مسجّلاً كحدّ أقصى لأغراض تصحيح الأخطاء في كل مزاد. ويتم حذف عناوين URL المسجَّلة بعد بلوغ هذا الحدّ الأقصى بدون إشعار.

أخيرًا، إذا أوقف المستخدم AdId، يتم إرسال تقارير تصحيح الأخطاء. لم يتم تنفيذ هذه الميزة في الإصدار 9 من "إصدار المطوّر"، ولكن سيتم تنفيذها في الإصدارات القادمة.

سلوك خادم تقنية الإعلان

يجب أن تتضمّن خوادم تكنولوجيا الإعلان السلوكيات التالية لإعداد تقارير تصحيح الأخطاء:

  • يُرسِل الجهاز طلبات GET إلى الخادم الذي تحدّده باستخدام واجهات برمجة تطبيقات forDebuggingOnly.*.
  • يمثّل كلّ طلب تقرير تصحيح أخطاء واحدًا على مستوى الحدث: فوز واحد في مزاد إعلاني أو خسارة مزاد.
  • لا يتضمّن كل طلب نصًا أساسيًا. تكون جميع البيانات في مَعلمات طلب البحث.
  • يمكن أن تؤثّر حِزم بيانات الاستجابة الكبيرة سلبًا في الأداء واستخدام البيانات، ويتم تجاهلها.