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

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

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

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

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

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

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

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

দ্রষ্টব্য: প্রদত্ত ব্যবহারের ক্ষেত্রে API কীভাবে ব্যবহার করা যেতে পারে তা প্রদর্শন করার জন্য নিম্নলিখিত কোড নমুনাগুলি তৈরি করা হয়েছিল। এগুলো উৎপাদনে ব্যবহার করার জন্য নয়।

একটি অস্বচ্ছ 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 this.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 this.sharedStorage.set('frequency-count', count + 1);
    return 1;
  }
}

// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);

ব্যবহারের ক্ষেত্রে

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

বিষয়বস্তু নির্বাচন

শেয়ার্ড স্টোরেজে সংগৃহীত তথ্যের ভিত্তিতে বেড়াযুক্ত ফ্রেমে বিভিন্ন ওয়েবসাইটে বিভিন্ন বিষয়বস্তু নির্বাচন করুন এবং প্রদর্শন করুন। এই ব্যবহারের ক্ষেত্রে আউটপুট গেট হল URL নির্বাচন।

• সৃজনশীল ঘূর্ণন : সৃজনশীল ব্যবহারকারীরা বিভিন্ন সাইট জুড়ে কোনটি দেখে তা নির্ধারণ করতে সৃজনশীল আইডি, ভিউ সংখ্যা এবং ব্যবহারকারীর ইন্টারঅ্যাকশনের মতো ডেটা সঞ্চয় করুন।
• A/B পরীক্ষা : আপনি একটি ব্যবহারকারীকে একটি পরীক্ষামূলক গোষ্ঠীতে বরাদ্দ করতে পারেন, তারপর ক্রস-সাইটে অ্যাক্সেস করার জন্য সেই গোষ্ঠীটিকে শেয়ার্ড স্টোরেজে সঞ্চয় করতে পারেন।
• কাস্টম ব্যবহারকারীর অভিজ্ঞতা : ব্যবহারকারীর নিবন্ধন স্থিতি বা অন্যান্য ব্যবহারকারীর অবস্থার উপর ভিত্তি করে কাস্টম সামগ্রী এবং কল-টু-অ্যাকশন শেয়ার করুন

সংক্ষিপ্ত প্রতিবেদন তৈরি করুন

শেয়ার্ড স্টোরেজের সাথে তথ্য সংগ্রহ করুন এবং একটি শোরগোল, সমষ্টিগত সারাংশ প্রতিবেদন তৈরি করুন। এই ব্যবহারের ক্ষেত্রে আউটপুট গেট হল Private Aggregation API ।

• অনন্য নাগালের পরিমাপ : অনেক সামগ্রী প্রযোজক এবং বিজ্ঞাপনদাতারা জানতে চান কতজন অনন্য লোক তাদের সামগ্রী দেখেছে। কোনো ব্যবহারকারী প্রথমবার আপনার বিজ্ঞাপন, এম্বেড করা ভিডিও বা প্রকাশনা দেখে রেকর্ড করতে শেয়ার্ড স্টোরেজ ব্যবহার করুন এবং বিভিন্ন সাইটে একই ব্যবহারকারীর সদৃশ গণনা প্রতিরোধ করুন। তারপর আপনি আপনার নাগালের জন্য একটি সারাংশ রিপোর্ট আউটপুট করতে ব্যক্তিগত সমষ্টি API ব্যবহার করতে পারেন।
• জনসংখ্যার পরিমাপ : বিষয়বস্তু প্রযোজকরা প্রায়ই তাদের দর্শকদের জনসংখ্যা বুঝতে চান। আপনি শেয়ার্ড স্টোরেজ ব্যবহার করতে পারেন ব্যবহারকারীর জনসংখ্যা সংক্রান্ত ডেটা রেকর্ড করার জন্য যেখানে আপনার কাছে এটি রয়েছে, যেমন আপনার প্রথম-পক্ষের সাইট, এবং এম্বেড করা সামগ্রীর মতো অন্যান্য অনেক সাইট জুড়ে প্রতিবেদন করতে সমষ্টিগত প্রতিবেদন ব্যবহার করতে পারেন।
• K+ ফ্রিকোয়েন্সি পরিমাপ : কখনও কখনও "কার্যকর ফ্রিকোয়েন্সি" হিসাবে বর্ণনা করা হয়, কোনও ব্যবহারকারী নির্দিষ্ট বিষয়বস্তু চিনতে বা স্মরণ করার আগে প্রায়শই ন্যূনতম সংখ্যক ভিউ থাকে (প্রায়শই বিজ্ঞাপনের দৃশ্যের প্রসঙ্গে)। আপনি শেয়ার্ড স্টোরেজ ব্যবহার করতে পারেন এমন অনন্য ব্যবহারকারীদের রিপোর্ট তৈরি করতে যারা কন্টেন্টের একটি অংশ কমপক্ষে K বার দেখেছেন।

,

ব্যবহারের ক্ষেত্রে

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

বিষয়বস্তু নির্বাচন

শেয়ার্ড স্টোরেজে সংগৃহীত তথ্যের ভিত্তিতে বেড়াযুক্ত ফ্রেমে বিভিন্ন ওয়েবসাইটে বিভিন্ন বিষয়বস্তু নির্বাচন করুন এবং প্রদর্শন করুন। এই ব্যবহারের ক্ষেত্রে আউটপুট গেট হল URL নির্বাচন।

• সৃজনশীল ঘূর্ণন : সৃজনশীল ব্যবহারকারীরা বিভিন্ন সাইট জুড়ে কোনটি দেখে তা নির্ধারণ করতে সৃজনশীল আইডি, ভিউ সংখ্যা এবং ব্যবহারকারীর ইন্টারঅ্যাকশনের মতো ডেটা সঞ্চয় করুন।
• A/B পরীক্ষা : আপনি একটি ব্যবহারকারীকে একটি পরীক্ষামূলক গোষ্ঠীতে বরাদ্দ করতে পারেন, তারপর ক্রস-সাইটে অ্যাক্সেস করার জন্য সেই গোষ্ঠীটিকে শেয়ার্ড স্টোরেজে সঞ্চয় করতে পারেন।
• কাস্টম ব্যবহারকারীর অভিজ্ঞতা : ব্যবহারকারীর নিবন্ধন স্থিতি বা অন্যান্য ব্যবহারকারীর অবস্থার উপর ভিত্তি করে কাস্টম সামগ্রী এবং কল-টু-অ্যাকশন শেয়ার করুন

সংক্ষিপ্ত প্রতিবেদন তৈরি করুন

শেয়ার্ড স্টোরেজের সাথে তথ্য সংগ্রহ করুন এবং একটি শোরগোল, সমষ্টিগত সারাংশ প্রতিবেদন তৈরি করুন। এই ব্যবহারের ক্ষেত্রে আউটপুট গেট হল Private Aggregation API ।

• অনন্য নাগালের পরিমাপ : অনেক সামগ্রী প্রযোজক এবং বিজ্ঞাপনদাতারা জানতে চান কতজন অনন্য লোক তাদের সামগ্রী দেখেছে। কোনো ব্যবহারকারী প্রথমবার আপনার বিজ্ঞাপন, এম্বেড করা ভিডিও বা প্রকাশনা দেখে রেকর্ড করতে শেয়ার্ড স্টোরেজ ব্যবহার করুন এবং বিভিন্ন সাইটে একই ব্যবহারকারীর সদৃশ গণনা প্রতিরোধ করুন। তারপর আপনি আপনার নাগালের জন্য একটি সারাংশ রিপোর্ট আউটপুট করতে ব্যক্তিগত সমষ্টি API ব্যবহার করতে পারেন।
• জনসংখ্যার পরিমাপ : বিষয়বস্তু প্রযোজকরা প্রায়ই তাদের দর্শকদের জনসংখ্যা বুঝতে চান। আপনি শেয়ার্ড স্টোরেজ ব্যবহার করতে পারেন ব্যবহারকারীর জনসংখ্যা সংক্রান্ত ডেটা রেকর্ড করার জন্য যেখানে আপনার কাছে এটি রয়েছে, যেমন আপনার প্রথম-পক্ষের সাইট, এবং এম্বেড করা সামগ্রীর মতো অন্যান্য অনেক সাইট জুড়ে প্রতিবেদন করতে সমষ্টিগত প্রতিবেদন ব্যবহার করতে পারেন।
• K+ ফ্রিকোয়েন্সি পরিমাপ : কখনও কখনও "কার্যকর ফ্রিকোয়েন্সি" হিসাবে বর্ণনা করা হয়, কোনও ব্যবহারকারী নির্দিষ্ট বিষয়বস্তু চিনতে বা স্মরণ করার আগে প্রায়শই ন্যূনতম সংখ্যক ভিউ থাকে (প্রায়শই বিজ্ঞাপনের দৃশ্যের প্রসঙ্গে)। আপনি শেয়ার্ড স্টোরেজ ব্যবহার করতে পারেন এমন অনন্য ব্যবহারকারীদের রিপোর্ট তৈরি করতে যারা কন্টেন্টের একটি অংশ কমপক্ষে K বার দেখেছেন।

জড়িত এবং মতামত শেয়ার করুন

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

• গিটহাব : প্রস্তাব পড়ুন, প্রশ্ন উত্থাপন করুন এবং আলোচনায় অংশগ্রহণ করুন ।
• শেয়ার্ড স্টোরেজ API ঘোষণা : যোগ দিন বা আমাদের মেলিং তালিকায় অতীতের ঘোষণা দেখুন
• বিকাশকারী সমর্থন : প্রশ্ন জিজ্ঞাসা করুন এবং গোপনীয়তা স্যান্ডবক্স বিকাশকারী সমর্থন রেপোতে আলোচনায় যোগ দিন।