ফ্রিকোয়েন্সি দ্বারা একটি সৃজনশীল নির্বাচন করুন

একটি ইউআরএল নির্বাচন করতে একটি শেয়ার্ড স্টোরেজ ওয়ার্কলেট চালান এবং এটি একটি বেড়াযুক্ত ফ্রেমে রেন্ডার করুন৷

শেয়ার্ড স্টোরেজ API হল সাধারণ উদ্দেশ্যে, ক্রস-সাইট স্টোরেজের জন্য একটি গোপনীয়তা স্যান্ডবক্স প্রস্তাব, যা অনেক সম্ভাব্য ব্যবহারের ক্ষেত্রে সমর্থন করে। একটি উদাহরণ হল ফ্রিকোয়েন্সি কন্ট্রোল, যা Chrome বিটা 104.0.5086.0 এবং পরবর্তীতে পরীক্ষা করার জন্য উপলব্ধ।

একটি প্রদত্ত তালিকা থেকে একটি URL নির্বাচন করতে একটি ওয়ার্কলেট স্ক্রিপ্ট চালান, সঞ্চিত ডেটার উপর ভিত্তি করে, এবং তারপর সেই URLটিকে একটি বেড়াযুক্ত ফ্রেমে রেন্ডার করুন৷ ফ্রিকোয়েন্সি সীমা পৌঁছে গেলে এটি নতুন বিজ্ঞাপন বা অন্যান্য সামগ্রী নির্বাচন করতে ব্যবহার করা যেতে পারে।

ফ্রিকোয়েন্সি দ্বারা সৃজনশীল নির্বাচন পরীক্ষা করুন

শেয়ার্ড স্টোরেজ এবং ফেন্সড ফ্রেমগুলির সাথে ফ্রিকোয়েন্সি দ্বারা সৃজনশীল নির্বাচন পরীক্ষা করতে, আপনি Chrome 104.0.5086.0 বা তার পরে ব্যবহার করছেন তা নিশ্চিত করুন৷ chrome://settings/adPrivacy এর অধীনে সমস্ত বিজ্ঞাপন গোপনীয়তা API সক্রিয় করুন।

আপনি কমান্ড লাইনে --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames পতাকা সহ শেয়ার করা স্টোরেজ সক্ষম করতে পারেন।

কোড নমুনা সঙ্গে পরীক্ষা

একটি অস্বচ্ছ URL নির্বাচন এবং তৈরি করতে, শেয়ার করা স্টোরেজ ডেটা পড়ার জন্য একটি ওয়ার্কলেট মডিউল নিবন্ধন করুন৷ ওয়ার্কলেট ক্লাস আটটি ইউআরএল পর্যন্ত একটি তালিকা পায় এবং তারপর নির্বাচিত ইউআরএলের সূচী প্রদান করে।

যখন ক্লায়েন্ট sharedStorage.selectURL() কল করে, ওয়ার্কলেটটি কার্যকর করে এবং একটি অস্বচ্ছ URL প্রদান করে যা একটি বেড়াযুক্ত ফ্রেমে রেন্ডার করা হয়।

ধরুন আপনি একটি ভিন্ন বিজ্ঞাপন বা বিষয়বস্তু নির্বাচন করতে চান যা একজন ব্যবহারকারী আগে কতবার দেখেছেন তার ভিত্তিতে রেন্ডার করতে। একজন ব্যবহারকারী কতবার একটি বিষয়বস্তু দেখেছেন তা আপনি গণনা করতে পারেন এবং সেই মানটিকে শেয়ার্ড স্টোরেজে সঞ্চয় করতে পারেন। একবার সঞ্চয় করা হলে, শেয়ার্ড স্টোরেজের মান আপনার জন্য বিভিন্ন উত্স জুড়ে উপলব্ধ হয়ে যায়।

তারপর, শেয়ার্ড স্টোরেজ ওয়ার্কলেট শেয়ার্ড স্টোরেজের মানগুলি পড়ে এবং প্রতিটি অতিরিক্ত ভিউয়ের সাথে কাউন্টারকে বৃদ্ধি করে। গণনা পূর্বনির্ধারিত সীমাতে না পৌঁছালে, আপনি যে সামগ্রীটি রেন্ডার করতে চান তা ফেরত দেওয়া হবে (সূচী 1 )। যদি তা না হয়, ডিফল্ট URL ফেরত দেওয়া হয় (সূচক 0 )।

এই উদাহরণে:

  • creative-selection-by-frequencyjs বিষয়বস্তু প্রযোজক বা বিজ্ঞাপনদাতার আইফ্রেমের মাধ্যমে লোড করা হয় এবং শেয়ার্ড স্টোরেজ ওয়ার্কলেট লোড করার জন্য এবং ফিরে আসা অস্বচ্ছ উৎসকে একটি বেড়াযুক্ত ফ্রেমে রেন্ডার করার জন্য দায়ী।
  • creative-selection-by-frequency-worklet.js হল শেয়ার্ড স্টোরেজ ওয়ার্কলেট যা ফ্রিকোয়েন্সি গণনা পড়ে তা নির্ধারণ করে যে কোন কন্টেন্ট বা বিজ্ঞাপন ক্রিয়েটিভের জন্য কোন ইউআরএল ফেরত দেওয়া হবে।

creative-select-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();

ক্রিয়েটিভ-সিলেকশন-বাই-ফ্রিকোয়েন্সি-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);

使用场景

以上只是共享存储空间的一部分用例。我们将 我们会继续添加样本， 获取反馈 并发现新的应用场景

内容选择

在以下位置选择和显示不同网站上的不同内容： 围栏框架 共享存储空间这些用例的输出门控是网址选择。

  • 广告素材轮播： 存储广告素材 ID、观看次数和用户互动等数据，以确定哪个广告素材在不同网站上的呈现效果
  • A/B 测试： 您可以将用户分配到实验组，然后将该组存储在共享存储空间中，以便跨网站访问。
  • 自定义用户体验： 根据用户的注册状态或其他用户状态共享自定义内容和号召性用语

生成摘要报告

通过共享存储空间收集信息，并生成杂乱的汇总摘要报告。这些用例的输出门控是 Private Aggregation API。

  • 唯一身份用户覆盖面衡量： 许多内容制作者和广告客户都想知道 人查看了他们的内容。使用共享存储空间记录用户首次访问 用户看过您的广告、嵌入式视频或发布内容，并防止重复 统计不同网站上的同一用户然后，您可以使用 Private Aggregation API 输出覆盖面的摘要报告。
  • 受众特征衡量： 内容制作者通常希望了解其网站的受众特征 受众群体。您可以使用共享存储空间来记录 背景信息（例如您的第一方网站），并使用汇总的数据 以便在其他许多网站（例如嵌入式内容）中生成此报告。
  • K+ 频次衡量： 有时也称为“有效频次”通常会有一个 用户会认出或回想某些内容（通常在 广告观看情境）。您可以使用共享存储空间生成报告 的唯一身份用户中，特定内容至少浏览了 K 次。

互动和分享反馈

共享存储空间提案正在积极讨论，可能会发生变化 。如果您试用此 API 并有反馈意见，我们非常期待收到您的反馈意见。