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

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

تنفيذ Topics في الخلفية

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

// 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. جمع المواضيع من خلال مراقبة المستخدمين في مرحلة الإنتاج (وقت التنفيذ المقدَّر: أسبوع واحد تقريبًا):
    • فهم الخيارات المتاحة لك: كيفية استدعاء Topics باستخدام عناوين 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() موضوع بعد تلقّي المواضيع.

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

التوسّع في مسار الإنتاج

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

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

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

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

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

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

انظر أيضًا

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