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

يمكنك تشغيل أداة عمل مساحة التخزين المشتركة لاختيار عنوان 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);

Use cases

All available use cases for Select URL API can be found in this section. We'll continue to add examples as we receive feedback and discover new test cases.

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

يُرجى العلم أنّ اقتراح Select URL API قيد المناقشة والتطوير ويخضَع للتغيير.

يسرّنا معرفة رأيك في Select URL API.

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

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

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