বিজ্ঞাপন ক্রিয়েটিভ ঘোরান

একজন ব্যবহারকারী সাইট জুড়ে কি সৃজনশীল দেখেন তা নির্ধারণ করতে একটি শেয়ার্ড স্টোরেজ ব্যবহার করুন৷

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

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

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

সৃজনশীল ঘূর্ণন চেষ্টা করুন

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

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

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

একজন বিজ্ঞাপনদাতা বা বিষয়বস্তু প্রযোজক একটি প্রচারাভিযানে বিভিন্ন কৌশল প্রয়োগ করতে এবং কার্যকারিতা বাড়ানোর জন্য বিষয়বস্তু বা সৃজনশীলকে ঘোরাতে চাইতে পারেন। ভাগ করা সঞ্চয়স্থান বিভিন্ন ঘূর্ণন কৌশলগুলি চালানোর জন্য ব্যবহার করা যেতে পারে, যেমন অনুক্রমিক ঘূর্ণন এবং সমানভাবে বিতরণ করা ঘূর্ণন, বিভিন্ন সাইট জুড়ে।

এই উদাহরণে:

  • creative-rotation.js একটি ফ্রেমে এম্বেড করা আছে। এই স্ক্রিপ্ট কোন বিজ্ঞাপনগুলি সবচেয়ে গুরুত্বপূর্ণ (ওজন) সেট করে এবং কোন বিষয়বস্তু প্রদর্শন করা উচিত তা নির্ধারণ করতে ওয়ার্কলেটে কল করে।
  • creative-rotation-worklet.js হল শেয়ার্ড স্টোরেজ ওয়ার্কলেট যা প্রদর্শন করা উচিত বিষয়বস্তু এবং রিটার্নগুলির জন্য ওজনযুক্ত বিতরণ নির্ধারণ করে।

creative-rotation.js

// Ad config with the URL of the content, a probability weight for rotation, and the clickthrough rate.
const DEMO_CONTENT_CONFIG = [
  {
    url: 'https://your-server.example/contents/content-1.html',
    weight: 0.7,
  },
  {
    url: 'https://your-server.example/contents/content-2.html',
    weight: 0.2,
  },
  {
    url: 'https://your-server.example/contents/content-3.html',
    weight: 0.1,
  },
];

// Set the mode to sequential and set the starting index to 0.
async function seedStorage() {
  await window.sharedStorage.set('content-rotation-mode', 'sequential', {
    ignoreIfPresent: true,
  });

  await window.sharedStorage.set('content-rotation-index', 0, {
    ignoreIfPresent: true,
  });
}

async function injectAd() {
  // Load the worklet module
  await window.sharedStorage.worklet.addModule('content-rotation-worklet.js');

  // Initially set the storage to sequential mode for the demo
  seedStorage();

  // Run the URL selection operation to determine the next content rendered.
  const urls = DEMO_CONTENT_CONFIG.map(({ url }) => ({ url }));
  const fencedFrameConfig = await window.sharedStorage.selectURL('content-rotation', urls, { 
    data: DEMO_CONTENT_CONFIG,
    resolveToConfig: true
  });

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

injectAd();

creative-rotation-worklet.js

class SelectURLOperation {
  async run(urls, data) {
    // Read the rotation mode from Shared Storage
    const rotationMode = await sharedStorage.get('content-rotation-mode');

    // Generate a random number to be used for rotation
    const randomNumber = Math.random();

    let index;

    switch (rotationMode) {
      /**
       * Sequential rotation
       * - Rotates the contents in order
       * - Example: A -> B -> C -> A ...
       */
      case 'sequential':
        const currentIndex = await sharedStorage.get('creative-rotation-index');
        index = parseInt(currentIndex, 10);
        const nextIndex = (index + 1) % urls.length;

        await sharedStorage.set('content-rotation-index', nextIndex);
        break;

      /**
       * Weighted rotation
       * - Rotates the contentswith weighted probability
       * - Example: A=70% / B=20% / C=10%
       */
      case 'weighted-distribution':
        
        // Sum the weights cumulatively, and find the first URL where the
        // sum exceeds the random number. The array is sorted in
        // descending order first.
        let weightSum = 0;
        const { url } = data
          .sort((a, b) => b.weight - a.weight)
          .find(({ weight }) => {
            weightSum += weight;
            return weightSum > randomNumber;
          });

        index = urls.indexOf(url);
        break;

      default:
        index = 0;
    }
    return index;
  }
}

register('content-rotation', SelectURLOperation);

Use cases

These are only some of the possible use cases for Shared Storage. We'll continue to add examples as we receive feedback and discover new use cases.

Content selection

Select and display different content on different websites in fenced frames based on information collected in Shared Storage. The output gate for these use cases is URL selection.

  • Creative rotation: Store data, such as creative ID, view counts, and user interaction, to determine which creative users' see across different sites.
  • A/B testing: You can assign a user to an experiment group, then store that group in Shared Storage to be accessed cross-site.
  • Custom user experiences: Share custom content and calls-to-action based on a user's registration status or other user states

Generate summary reports

Collect information with Shared Storage and generated a noisy, aggregated summary report. The output gate for these use cases is the Private Aggregation API.

  • Unique reach measurement: Many content producers and advertisers want to know how many unique people saw their content. Use Shared Storage to record the first time a user saw your ad, embedded video, or publication, and prevent duplicative counting of that same user on different sites. You can then use the Private Aggregation API to output a summary report for your reach.
  • Demographics measurement: Content producers often want to understand the demographics of their audience. You can use Shared Storage to record user demographic data in a context where you have it, such as your first-party site, and use aggregated reporting to report on it across many other sites, such as embedded content.
  • K+ frequency measurement: Sometimes described as "effective frequency," there is often a minimum number views before a user will recognize or recall certain content (often in the context of advertisement views). You can use Shared Storage to build reports of unique users that have seen a piece of content at least K number of times.

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

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