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

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

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

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

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

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

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

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

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

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

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

এই উদাহরণে:

• 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 this.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 this.sharedStorage.get('creative-rotation-index');
        index = parseInt(currentIndex, 10);
        const nextIndex = (index + 1) % urls.length;

        await this.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);

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

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

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

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

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

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

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

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

,

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

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

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

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

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

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

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

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

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

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

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