اختبار الحلول المستندة إلى المواضيع ونشرها وتوسيع نطاقها

تتناول هذه الصفحة كيفية إنشاء عملية تنفيذ واجهة Topics API واختبارها وتوسيع نطاقها لتصبح جاهزة للاستخدام في مرحلة الإنتاج.

تنفيذ المواضيع في الواجهة الخلفية

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

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

استخدام Topics كإشارة إضافية

يمكن اعتبار بيانات المواضيع إلى جانب إشارات أخرى، مثل عناوين URL أو الكلمات الرئيسية أو البيانات الوصفية الأخرى، كإشارة إضافية حول جمهورك.

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

إنشاء التطبيق ونشره

  1. جمع المواضيع من خلال مراقبة المستخدِمين في مرحلة الإنتاج (الوقت المقدَّر للتنفيذ: أسبوع واحد تقريبًا):
    • التعرّف على خياراتك: كيفية طلب المواضيع باستخدام عناوين HTTP أو iframe وJavaScript
    • حدِّد نطاق إطار iframe الذي سيستدعي Topics API.
    • أنشئ الحلّ باستخدام العرض التوضيحي للرأس أو العرض التوضيحي لرمز JavaScript كمرجع للرمز.
    • دمج Topics في الرمز الذي يضمّنه الناشرون في مواقعهم الإلكترونية (مثل iframe الإعلاني). تأكَّد من طلب المواضيع من عملية التضمين.
    • لبدء مراقبة مواضيع المستخدمين، عليك تضمين أحدث إصدار من النص البرمجي في مواقعك الإلكترونية المباشرة. ننصحك باختبار عملية التنفيذ على مواقعك الإلكترونية التي تتلقّى عددًا قليلاً من الزيارات الشهرية أولاً. في هذه المرحلة، ننصحك بتضمين الحلّ الجديد المستند إلى المواضيع في خمسة مواقع إلكترونية على الأقل.
    • في هذه المرحلة، من المتوقّع أن تعرض واجهة برمجة التطبيقات مصفوفة فارغة كنتيجة. ويرجع ذلك إلى عدم رصد أي مواضيع للمستخدم حتى الآن. قد يستغرق الأمر ما يصل إلى ثلاثة أسابيع لبدء تلقّي مواضيع المستخدمين.
    • إجراء اختبارات وظيفية والتحقّق من صحة البيانات يمكنك اختبار الحلّ يدويًا أو تلقائيًا. على سبيل المثال:
      • افتح المتصفّح مع تفعيل العلامات واضبط الفترة الزمنية على 15 ثانية، كي يعيد المتصفّح احتساب المواضيع بشكل أسرع.
      • انتقِل إلى المواقع الإلكترونية التي تضمِّن النص البرمجي.
      • تحقَّق مما إذا كان النص البرمجي يرصد المواضيع على chrome://topics-internals/.
      • اطّلِع على النتائج التي يمكنك توقّعها.
  2. استخدام بيانات Topics مع إشارات سياقية أخرى (مثل عناوين URL والبيانات الوصفية وما إلى ذلك) (الوقت المقدَّر: حوالي 3 أيام).
    • بعد ثلاثة أسابيع من نشر النص البرمجي، من المفترض أن يكون قد رصد مواضيع بعض المستخدمين. في هذه المرحلة، من المفترض أن تتمكّن من استخدام بيانات Topics كإشارة إضافية.
    • بعد البدء في تلقّي قائمة غير فارغة من المواضيع، يمكنك إرسالها إلى الخلفية مع إشارات سياقية أخرى.

نشرها على المواقع الإلكترونية المستهدَفة

بعد دمج طلب Topics في النص البرمجي، احرص على تضمينه في بعض المواقع الإلكترونية المباشرة لإجراء الاختبار الأول. تأكَّد من أنّ عملية التنفيذ تعمل على النحو المتوقّع:

  • يتم طلب Topics API.
  • يمكن مراقبة المواضيع في هذه البيئة الخاضعة للرقابة.
  • يمكن الوصول إلى المواضيع (تعرض واجهة برمجة التطبيقات المواضيع التي تم رصدها للمستخدم).

اختيار المواقع الإلكترونية المستهدَفة

قبل نشر الحلّ على مواقع الناشرين الإلكترونية، ننصحك باختباره في بيئة خاضعة للرقابة على المواقع الإلكترونية التي تملكها. ننصحك باختيار المواقع الإلكترونية المستهدَفة على النحو التالي:

  • يتلقّى الموقع الإلكتروني عددًا قليلاً من الزيارات الشهرية (أقل من مليون زيارة شهريًا تقريبًا): عليك البدء بنشر واجهة برمجة التطبيقات لعدد صغير من الجمهور أولاً.
  • أنت تملك الموقع الإلكتروني وتتحكّم فيه: يمكنك إيقاف التنفيذ بسرعة إذا لزم الأمر بدون الحاجة إلى الحصول على موافقات معقّدة.
  • الموقع الإلكتروني ليس مهمًا للنشاط التجاري: ابدأ بالمواقع الإلكترونية المستهدَفة ذات المخاطر المنخفضة.
  • إجمالي عدد المواقع الإلكترونية لا يزيد عن خمسة: لن تحتاج إلى هذا القدر من الزيارات أو الظهور في الوقت الحالي.
  • تمثّل المواقع الإلكترونية المستهدَفة مواضيع مختلفة: اختَر مواقع إلكترونية تمثّل فئات مختلفة (على سبيل المثال، موقع إلكتروني عن الرياضة، وآخر عن الأخبار، وموقع إلكتروني آخر عن الطعام والشراب). يمكنك استخدام أداة المواضيع الداخلية في Chrome للتحقّق من صحة النطاقات وطريقة تصنيفها من خلال أداة التصنيف المستندة إلى تعلُّم الآلة في Topics.

الاختبار الوظيفي والتحقّق من الصحة

عند طلب Topics API في هذه البيئة المحدودة، يمكنك توقّع النتائج التالية:

  • صفيف فارغ من المواضيع []، إذا كانت هذه هي المكالمة الأولى لهذا الجهاز، لهذا الموقع الإلكتروني والمتصل خلال الأيام السبعة الأخيرة.

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

    • موضوع واحد يتم اختياره من بين أهم خمسة مواضيع للمستخدم، ويتم احتسابه من أسماء مضيفي الصفحات التي رصد فيها المتصل المواضيع خلال ذلك الأسبوع.

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

  • موضوع جديد يحلّ محلّ أحد المواضيع القديمة الثلاثة إذا كنت تستخدم Topics بعد أربعة أسابيع من المراقبة

  • إذا لم يتم رصد مواضيع للمستخدم خلال الأسابيع الثلاثة السابقة أو أكثر، ستعرض Topics API مصفوفة فارغة [] مرة أخرى.

اجمع مقاييس الأداء لتقييم تجربة المستخدم:

  • يجب قياس وقت تشغيل طلبات JavaScript إلى Topics API داخل إطار iframe من مصادر متعددة لاستخدامه في تحليل الأداء المستقبلي.
  • الوقت المستغرَق لإنشاء إطار iframe وpostMessage() مواضيع، بعد تلقّي المواضيع

لتحديد المشاكل وحلّها، يُرجى الرجوع إلى قسم الدعم.

الترقية إلى الإصدار العلني

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

في ما يلي ملخّص مفصّل حول كيفية التوسّع إلى مرحلة الإنتاج:

  1. اختبِر الحل المستند إلى المواضيع على عدد أكبر من الزيارات.
    • أضِف إطار iframe إلى المزيد من المواقع الإلكترونية التي تملكها والتي تحقّق عددًا أكبر من الزيارات، واتّبِع التعليمات أدناه لإجراء اختبار التحميل.
  2. نشر الحلّ على مواقع الناشرين الإلكترونية
    • بعد التأكّد من أنّ الحلّ يعمل بشكلٍ صحيح في بيئة الاختبار الخاصة بك، تعاون مع الناشرين لدمج إطار iframe في مواقعهم الإلكترونية. على سبيل المثال، قد يحتاجون إلى تعديل المكتبة التي تتضمّن إطار iframe.
  3. معالجة بيانات المواضيع واستخدامها (الوقت المقدَّر: حوالي أربعة أسابيع)
    • دمج بيانات المواضيع كإشارة إضافية إلى جانب البيانات الأخرى
    • تحديد شركاء لاختبار عروض أسعار الوقت الفعلي
    • إجراء اختبارات الفائدة باستخدام المواضيع كإشارة إضافية إلى بياناتك الأخرى

اختبار التحميل

لضمان قدرة نظامك على التعامل مع عدد الزيارات، ننصحك بإجراء اختبار التحميل قبل نشر الحل المستند إلى المواضيع على المواقع الإلكترونية للناشرين.

  1. يمكنك نشرها تدريجيًا على المزيد من المواقع الإلكترونية المستهدَفة التي تملكها، لا سيّما تلك التي تجذب عددًا أكبر من الزيارات.
  2. إجراء اختبارات الاستجابة للأحمال لبيانات المواضيع، وفقًا لعدد الزيارات المتوقّع
    • عليك إرسال معلومات المواضيع من إطار iframe إلى الخادم الخلفي. يتيح لك ذلك معالجة نتائج Topics API بشكل أكبر واستخدامها كإشارة إضافية للمساعدة في اختيار الإعلانات الأكثر ملاءمةً للمستخدم. ومع تضمين المزيد من المواقع الإلكترونية لرمز التضمين، سيزداد عدد الطلبات إلى الخلفية بشكلٍ كبير. تأكَّد من أنّ الخلفية يمكنها التعامل مع عدد كبير من الطلبات من الإطار iframe.
    • إعداد عملية جمع المقاييس والسجلّات لتحليلها
  3. بعد نشر Topics API مباشرةً، راجِع مقاييسك لرصد أي مشاكل خطيرة يواجهها المستخدمون النهائيون. واصِل التحقّق من مقاييسك بانتظام.
  4. في حال حدوث انقطاع أو سلوك غير متوقّع، عليك التراجع عن عملية النشر وتحليل السجلّات لفهم المشكلة وحلّها.

انظر أيضًا

يمكنك الاطّلاع على مراجعنا لفهم Topics API على الويب بشكل أفضل.