تخصيص تجربة المستخدم للعملاء المعروفين

استخدِم أداة "مساحة التخزين المشتركة" لتحديد العملاء المعروفين.

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

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

إعداد العملاء المعروفين

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

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

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

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

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

  • تم تضمين known-customer.js في إطار. يحدّد هذا النص البرمجي خيارات الزر الذي يجب عرضه في الموقع الإلكتروني، وهي "تسجيل" أو "اشترِ الآن".
  • known-customer-worklet.js هي الوظيفة المصغّرة لمساحة التخزين المشتركة التي تحدِّد ما إذا كان المستخدم معروفًا. إذا كان المستخدم معروفًا، سيتم عرض المعلومات. إذا كان المستخدم غير معروف، ستُرجع هذه المعلومات لعرض "التسجيل" ويتم وضع علامة على المستخدم بأنه معروف للمستقبل.

known-customer.js

// The first URL for the "register" button is rendered for unknown users.
const BUTTON_URLS = [
  { url: `https://${advertiserUrl}/ads/register-button.html` },
  { url: `https://${advertiserUrl}/ads/buy-now-button.html` },
];

async function injectButton() {
  // Load the worklet module
  await window.sharedStorage.worklet.addModule('known-customer-worklet.js');

  // Set the initial status to unknown ('0' is unknown and '1' is known)
  window.sharedStorage.set('known-customer', 0, {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation to choose the button based on the user status
  const fencedFrameConfig = await window.sharedStorage.selectURL('known-customer', BUTTON_URLS, {
    resolveToConfig: true
  });

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

injectButton();

known-customer-worklet.js

class SelectURLOperation {
  async run(urls) {
    const knownCustomer = await sharedStorage.get('known-customer');

    // '0' is unknown and '1' is known
    return parseInt(knownCustomer);
  }
}

register('known-customer', SelectURLOperation);

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

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

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

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

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

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

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

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

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

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

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

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

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

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