הפעלה של בדיקת A/B

שימוש ב-worklet של Shared Storage כדי להריץ בדיקות A/B.

Shared Storage API מאפשר פרטיות הצעת Sandbox למטרה כללית, אחסון באתרים שונים, שתומך בהרבה ותרחישים לדוגמה אפשריים. אחת הדוגמאות לכך היא בדיקת A/B, שזמינה לבדיקה. ב-Chrome מגרסה 104.0.5086.0 ואילך.

אפשר להקצות משתמש לקבוצת ניסוי, ולאחר מכן לאחסן את הקבוצה בכרטיסייה 'שיתופים' אחסון שאפשר לגשת אליו בסביבה חוצת-אתרים.

ביצוע בדיקות A/B

כדי להתנסות בבדיקות A/B עם נפח אחסון משותף, צריך לוודא שמשתמשים ב-Chrome מגרסה 104.0.5086.0 ואילך. הפעלת כל ממשקי ה-API לשמירה על פרטיות בפרסום במסגרת chrome://settings/adPrivacy.

אפשר להפעיל אחסון משותף גם באמצעות הדגל --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames בשורת הפקודה.

התנסות עם דוגמאות קוד

כדי לראות אם לניסוי יש את ההשפעה הרצויה, אפשר להפעיל בדיקת A/B במספר אתרים. מפרסמים או יצרני תוכן יכולים להציג מודעות או תכנים שונים בהתאם לקבוצה שאליה המשתמש משויך. ההקצאה של הקבוצה נשמרת באחסון משותף, אבל אי אפשר לזלוג אותה.

בדוגמה הזו:

• ab-testing.js צריך להיות מוטמע במסגרת, שממפה תוכן בקרה ושני תוכן של ניסוי. הסקריפט מפעיל את ה-worklet של האחסון המשותף של הניסוי.
• ab-testing-worklet.js הוא ה-worklet של נפח אחסון משותף, שמחזיר את הקבוצה שאליה משויך המשתמש, שקובע איזו מודעה תוצג.

ab-testing.js

// Randomly assigns a user to a group 0 or 1
function getExperimentGroup() {
  return Math.round(Math.random());
}

async function injectContent() {
  // Register the Shared Storage worklet
  await window.sharedStorage.worklet.addModule('ab-testing-worklet.js');

  // Assign user to a random group (0 or 1) and store it in Shared Storage
  window.sharedStorage.set('ab-testing-group', getExperimentGroup(), {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation
  const fencedFrameConfig = await window.sharedStorage.selectURL(
    'ab-testing',
    [
      { url: `https://your-server.example/content/default-content.html` },
      { url: `https://your-server.example/content/experiment-content-a.html` }
    ],
    {
      resolveToConfig: true
    }
  );

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

injectContent();

ab-testing-worklet.js

class SelectURLOperation {
  async run(urls, data) {
    // Read the user's experiment group from Shared Storage
    const experimentGroup = await sharedStorage.get('ab-testing-group');

    // Return the corresponding URL (first or second item in the array)
    return urls.indexOf(experimentGroup);
  }
}

register('ab-testing', SelectURLOperation);

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.

• Rotate ad creatives: Store data, such as creative ID and user interaction, to determine which creative users' see across different sites.
• Select ad creatives by frequency: Use view count data to determine which creative users' see across different sites.
• Run A/B testing: You can assign a user to an experiment group, then store that group in Shared Storage to be accessed cross-site.
• Customize experience for known customers: Share custom content and calls-to-action based on a user's registration status or other user states.

Engage and share feedback

Note that the Select URL API proposal is under active discussion and development and subject to change.

We're eager to hear your thoughts on the Select URL API.

• Proposal: Review the detailed proposal.
• Discussion: Join the ongoing discussion to ask questions and share your insights.

Stay Informed

• Mailing List: Subscribe to our mailing list for the latest updates and announcements related to the Select URL and Shared Storage APIs.

Need Help?

• Developer Support: Connect with other developers and get answers to your questions in the Privacy Sandbox Developer Support repository.