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

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

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.

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

إنشاء تقارير ملخّصة

جمع المعلومات باستخدام "مساحة التخزين المشتركة" وإنشاء تقرير ملخص مجمّع صاخب تتمثل بوابة المخرجات لحالات الاستخدام هذه في واجهة برمجة تطبيقات التجميع الخاص:

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

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

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