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

تسمح ميزة "إعداد تقارير تصحيح أخطاء الجمهور المحمي" لمطوّري تكنولوجيا الإعلان بالإعلان عن بُعد. عناوين 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 4096 حرفًا، بما في ذلك النطاق و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.*.
  • يمثّل كل طلب تقرير تصحيح أخطاء واحد على مستوى الحدث، أو مزاد إعلانات واحد. الفوز أو الخسارة في المزاد.
  • لا يحتوي كل طلب على نص. تتوفر جميع البيانات في معلَمات طلب البحث.
  • يمكن أن تؤثر حمولات الاستجابة الكبيرة سلبًا في الأداء واستخدام البيانات وتجاهلها.