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

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

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

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

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

يمكنك الاطّلاع على مزيد من المعلومات عن إعداد تقارير تصحيح الأخطاء في اقتراح مرحلة التقييم الأصلي لـ FLEDGE من Chrome.

الاستخدام

يتم تنفيذ تقارير تصحيح الأخطاء باستخدام واجهات برمجة تطبيقات 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 مع نطاقك المسجَّل في "مبادرة حماية الخصوصية".
  • يجب ألا يتجاوز عنوان URL 4,096 حرفًا بما في ذلك النطاق والبادئة https:// وبيانات المزادات البديلة.
  • في الإصدارات المستقبلية، لا يتم إرسال إشعارات تصحيح الأخطاء إلا عند الاتصال بشبكة Wi-Fi.

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

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

تتحكم خصائص النظام التالية في معدل الدفعة وحجمها، والتي يمكن ضبطها على قيم أقل للتطوير:

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

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

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

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

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

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

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

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