একটি ইউআরএল নির্বাচন করতে একটি শেয়ার্ড স্টোরেজ ওয়ার্কলেট চালান এবং এটি একটি বেড়াযুক্ত ফ্রেমে রেন্ডার করুন৷
শেয়ার্ড স্টোরেজ 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);
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.