اختيار تصميم إعلان حسب معدّل التكرار

يمكنك تشغيل أداة عمل مساحة التخزين المشتركة لاختيار عنوان URL وعرضه في إطار محاط بحدود.

Shared Storage API هي واجهة برمجة تطبيقات للخصوصية وضع الحماية للغرض العام، والتخزين على مواقع إلكترونية متعددة، ويدعم العديد من حالات الاستخدام المحتملة. أحد الأمثلة على ذلك هو التحكم في التكرار، وهو متاح في الإصدار التجريبي 104.0.5086.0 من Chrome والإصدارات الأحدث.

شغِّل نصًا برمجيًا لـ Worklet لتحديد عنوان URL من قائمة متوفرة، بناءً على ملف ثم عرض عنوان URL هذا في إطار محاط بحدود. يمكن استخدام هذا لتحديد إعلانات جديدة أو محتوى آخر عند بلوغ الحدّ الأقصى لعدد مرات الظهور

اختبار اختيار تصميم الإعلان حسب فترة التكرار

لاختبار اختيار تصاميم الإعلانات حسب معدّل التكرار من خلال "مساحة التخزين المشتركة" و"الإطارات المحدودة"، يجب تأكيد يستخدمون Chrome 104.0.5086.0 أو إصدار أحدث. تفعيل جميع واجهات برمجة تطبيقات الخصوصية في عرض الإعلانات ضمن "chrome://settings/adPrivacy"

يمكنك أيضًا تفعيل "مساحة التخزين المشتركة" باستخدام العلامة --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames في سطر الأوامر.

اختبار نماذج الرموز

لتحديد عنوان URL مبهم وإنشائه، سجّل وحدة بيئة العمل لقراءة بيانات التخزين. تتلقى فئة Worklet قائمة تضم ما يصل إلى ثمانية عناوين URL، ثم يؤدي إلى إرجاع فهرس عنوان URL المحدد.

عندما يستدعي العميل الدالة sharedStorage.selectURL()، ينفذ ويعرض عنوان URL مبهمًا لعرضه في إطار محاط بحدود.

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

بعد ذلك، تقرأ الوظيفة المصغّرة لمساحة التخزين المشتركة القيم في مساحة التخزين المشتركة، وتزيد من العدّاد مع كل طريقة عرض إضافية. وإذا لم يصل العدد إلى الحد الأقصى مسبق التحديد، يتم عرض المحتوى الذي تريد عرضه (الفهرس 1). وإذا لم يكن الأمر كذلك، سيتم عرض عنوان URL التلقائي (الفهرس 0).

في هذا المثال:

  • يتم تحميل creative-selection-by-frequencyjs عبر إطار iframe الخاص بصانع المحتوى أو المعلن، وهو مسؤول لتحميل وظيفة التخزين المشتركة وعرض القيمة المعروضة المصدر في إطار مسيّج.
  • creative-selection-by-frequency-worklet.js هو وظيفة التخزين المشتركة التي تقرأ عدد مرّات الظهور لتحديد عنوان URL الذي يتم عرضه لمحتوى أو تصميم إعلان.

creative-selection-by-frequency.js

// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
  { url: `https://${contentProducerUrl}/default-content.html` },
  { url: `https://${contentProducerUrl}/example-content.html` },
];

async function injectAd() {
  // Load the worklet module.
  await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');

  // Set the initial frequency count
  window.sharedStorage.set('frequency-count', 0, {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation to choose an ad based on the frequency count in shared storage.
  const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
    resolveToConfig: true
  });

  // Render the opaque URL into a fenced frame
  document.getElementById('content-slot').config = fencedFrameConfig;
}

injectAd();

creative-selection-by-frequency-worklet.js

const FREQUENCY_LIMIT = 5;

class CreativeSelectionByFrequencyOperation {
  async run(urls, data) {
    // Read the current frequency limit in shared storage
    const count = parseInt(await sharedStorage.get('frequency-count'));

    // Check if the frequency limit has been reached.
    if (count === FREQUENCY_LIMIT) {
      console.log('Frequency limit has been reached, and the default content will be rendered.');
      return 0;
    }

    // Set the new frequency count in shared storage
    await sharedStorage.set('frequency-count', count + 1);
    return 1;
  }
}

// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);

حالات الاستخدام

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

اختيار المحتوى

اختيار محتوى مختلف وعرضه على مواقع إلكترونية مختلفة في إطارات محدودة استنادًا إلى المعلومات التي يتم جمعها في "مساحة التخزين المشتركة" بوابة الإخراج لحالات الاستخدام هذه هي اختيار عنوان URL.

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

إنشاء تقارير موجزة

جمع المعلومات باستخدام "مساحة التخزين المشتركة" وإنشاء تقرير ملخّص مجمّع ومزدحم بوابة الإخراج لحالات الاستخدام هذه هي Private Aggregation API.

  • قياس مدى الوصول الفريد: يريد العديد من صنّاع المحتوى والمعلنين معرفة عدد الأشخاص الفرديين الذين شاهدوا المحتوى الخاص بهم. استخدِم ميزة "مساحة التخزين المشتركة" لتسجيل المرة الأولى التي رأى فيها أحد المستخدِمين إعلانك أو الفيديو المضمّن أو النشر، ومنع تكرار احتساب هذا المستخدِم نفسه على مواقع إلكترونية مختلفة. يمكنك بعد ذلك استخدام Private Aggregation API لعرض تقرير تلخيصي لمستوى وصولك إلى الجمهور.
  • قياس الخصائص الديمغرافية: غالبًا ما يريد صنّاع المحتوى فهم الخصائص الديمغرافية لجمهورهم. يمكنك استخدام "مساحة التخزين المشتركة" لتسجيل البيانات الديمغرافية للمستخدمين في سياق يتوفر فيه هذا النوع من البيانات، مثل موقعك الإلكتروني التابع للطرف الأول، واستخدام تقارير ملفّقة لإعداد تقارير عن هذه البيانات على العديد من المواقع الإلكترونية الأخرى، مثل المحتوى المضمّن.
  • قياس عدد مرّات الظهور التي تزيد عن 1,000: يُشار إليه أحيانًا باسم "عدد مرّات الظهور الفعّالة"، وغالبًا ما يكون هناك حدّ أدنى لعدد المرّات المشاهدة قبل أن يتعرّف المستخدِم على محتوى معيّن أو يتذكره (غالبًا في سياق مشاهدات الإعلانات). يمكنك استخدام "مساحة التخزين المشتركة" لإنشاء تقارير عن المستخدمين الفرديين الذين شاهدوا محتوى معيّنًا عددًا من المرات لا يقل عن K.

التفاعل مع الملاحظات ومشاركتها

يُرجى العِلم أنّ اقتراح Shared Storage API قيد المناقشة والتطوير بشكل نشط، وبالتالي يخضع للتغيير.

يسرّنا معرفة رأيك بشأن Shared Storage API.

الاطّلاع على آخر الأخبار

  • القائمة البريدية: يمكنك الاشتراك في قائمتنا البريدية لتلقّي آخر الأخبار والإشعارات المتعلّقة بواجهة برمجة التطبيقات Shared Storage API.

هل أنت بحاجة إلى مساعدة؟