প্রাইভেট অ্যাগ্রিগেশন API ওভারভিউ

সুরক্ষিত শ্রোতাদের ডেটা এবং শেয়ার্ড স্টোরেজ থেকে ক্রস-সাইট ডেটা ব্যবহার করে সামগ্রিক ডেটা প্রতিবেদন তৈরি করুন।

ওয়েব নির্ভরশীল গুরুত্বপূর্ণ বৈশিষ্ট্যগুলি প্রদানের জন্য, গোপনীয়তা-সংরক্ষণের পদ্ধতিতে ক্রস-সাইট ডেটা একত্রিত এবং প্রতিবেদন করার জন্য প্রাইভেট অ্যাগ্রিগেশন API তৈরি করা হয়েছে।

বাস্তবায়নের অবস্থা

প্রাইভেট এগ্রিগেশন এপিআই কী?

প্রাইভেট অ্যাগ্রিগেশন API ডেভেলপারদের প্রোটেক্টেড অডিয়েন্স API থেকে ডেটা এবং শেয়ার্ড স্টোরেজ থেকে ক্রস-সাইট ডেটা ব্যবহার করে সমষ্টিগত ডেটা রিপোর্ট তৈরি করতে দেয়।

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

উদাহরণস্বরূপ, যদি আপনি পূর্বে শেয়ার্ড স্টোরেজে ডেমোগ্রাফিক এবং ভৌগোলিক ডেটা রেকর্ড করে থাকেন, তাহলে আপনি প্রাইভেট অ্যাগ্রিগেশন API ব্যবহার করে একটি হিস্টোগ্রাম তৈরি করতে পারেন যা আপনাকে জানায় যে নিউ ইয়র্ক সিটিতে আনুমানিক কতজন ব্যবহারকারী আপনার কন্টেন্ট ক্রস-সাইট দেখেছেন। এই পরিমাপের জন্য একত্রিত করার জন্য, আপনি ভূগোলের মাত্রাটি একত্রিতকরণ কী-তে এনকোড করতে পারেন এবং একত্রিতযোগ্য মানের মধ্যে ব্যবহারকারীদের গণনা করতে পারেন।

মূল ধারণা

যখন আপনি একটি অ্যাগ্রিগেশন কী এবং একটি অ্যাগ্রিগেটেবল মান সহ প্রাইভেট অ্যাগ্রিগেশন API কল করেন, তখন ব্রাউজারটি একটি অ্যাগ্রিগেটেবল রিপোর্ট তৈরি করে।

সংগ্রহ এবং ব্যাচিংয়ের জন্য সমষ্টিগত প্রতিবেদনগুলি আপনার সার্ভারে পাঠানো হয়। ব্যাচ করা প্রতিবেদনগুলি পরে সমষ্টিগত পরিষেবা দ্বারা প্রক্রিয়া করা হয় এবং একটি সারাংশ প্রতিবেদন তৈরি করা হয়।

প্রাইভেট এগ্রিগেশন এপিআই-এর সাথে জড়িত মূল ধারণাগুলি সম্পর্কে আরও জানতে প্রাইভেট এগ্রিগেশন এপিআই ফান্ডামেন্টাল ডকুমেন্টটি দেখুন।

অ্যাট্রিবিউশন রিপোর্টিং থেকে পার্থক্য

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

অ্যাট্রিবিউশন রিপোর্টিং একটি ইম্প্রেশন ইভেন্ট এবং একটি রূপান্তর ইভেন্ট থেকে সংগৃহীত ডেটা সংযুক্ত করে, যা বিভিন্ন সময়ে ঘটে। প্রাইভেট অ্যাগ্রিগেশন একটি একক, ক্রস-সাইট ইভেন্ট পরিমাপ করে।

এই API পরীক্ষা করুন

স্থানীয়ভাবে Private Aggregation API পরীক্ষা করতে, chrome://settings/adPrivacy অধীনে সমস্ত Ad privacy API সক্ষম করুন।

পরীক্ষায় পরীক্ষা সম্পর্কে আরও পড়ুন এবং অংশগ্রহণ করুন ।

ডেমো ব্যবহার করুন

শেয়ার্ড স্টোরেজের জন্য প্রাইভেট অ্যাগ্রিগেশন API-এর ডেমো goo.gle/shared-storage-demo -এ অ্যাক্সেস করা যেতে পারে এবং কোডটি GitHub- এ উপলব্ধ। ডেমোটি ক্লায়েন্ট-সাইড অপারেশনগুলি বাস্তবায়ন করে এবং একটি সমষ্টিগত প্রতিবেদন তৈরি করে যা আপনার সার্ভারে পাঠানো হয়।

ভবিষ্যতে সুরক্ষিত শ্রোতা API-এর জন্য Private Aggregation API-এর একটি ডেমো প্রকাশিত হবে।

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

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

শেয়ার্ড স্টোরেজ সহ

শেয়ার্ড স্টোরেজ আপনাকে লিকেজ প্রতিরোধের জন্য একটি নিরাপদ পরিবেশে ক্রস-সাইট ডেটা পড়তে এবং লিখতে দেয় এবং প্রাইভেট অ্যাগ্রিগেশন API আপনাকে শেয়ার্ড স্টোরেজে সংরক্ষিত ক্রস-সাইট ডেটা পরিমাপ করতে দেয়।

অনন্য নাগালের পরিমাপ

আপনি হয়তো কতজন অনন্য ব্যবহারকারী তাদের কন্টেন্ট দেখেছেন তা পরিমাপ করতে চাইতে পারেন। Private Aggregation API "প্রায় ৩১৭ জন অনন্য ব্যবহারকারী Content ID 861 দেখেছেন" এর মতো একটি উত্তর দিতে পারে।

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

জনসংখ্যা পরিমাপ

বিভিন্ন সাইট জুড়ে আপনার কন্টেন্ট দেখেছেন এমন ব্যবহারকারীদের জনসংখ্যার পরিমাপ আপনি করতে পারেন।

প্রাইভেট অ্যাগ্রিগেশন একটি উত্তর দিতে পারে, যেমন "প্রায় ৩১৭ জন অনন্য ব্যবহারকারী ১৮-৪৫ বছর বয়সী এবং জার্মানি থেকে এসেছেন।" তৃতীয় পক্ষের প্রেক্ষাপট থেকে জনসংখ্যার ডেটা অ্যাক্সেস করতে শেয়ার্ড স্টোরেজ ব্যবহার করুন। পরবর্তী সময়ে, আপনি অ্যাগ্রিগেশন কী-তে বয়স গ্রুপ এবং দেশের মাত্রা এনকোড করে প্রাইভেট অ্যাগ্রিগেশনের মাধ্যমে একটি প্রতিবেদন তৈরি করতে পারেন।

K+ ফ্রিকোয়েন্সি পরিমাপ

আপনি হয়তো একটি নির্দিষ্ট ব্রাউজারে কমপক্ষে K বার কোন কন্টেন্ট বা বিজ্ঞাপন দেখেছেন এমন ব্যবহারকারীর সংখ্যা পরিমাপ করতে চাইতে পারেন, K এর পূর্ব-নির্ধারিত মানের জন্য।

প্রাইভেট অ্যাগ্রিগেশন একটি উত্তর দিতে পারে যেমন "প্রায় ৮৯ জন ব্যবহারকারী কমপক্ষে ৩ বার কন্টেন্ট আইডি ৫৮১ দেখেছেন।" বিভিন্ন সাইট থেকে শেয়ার্ড স্টোরেজে একটি কাউন্টার বাড়ানো যেতে পারে এবং একটি ওয়ার্কলেটের মধ্যে পড়া যেতে পারে। গণনা K-তে পৌঁছালে, প্রাইভেট অ্যাগ্রিগেশন ব্যবহার করে একটি প্রতিবেদন জমা দেওয়া যেতে পারে।

মাল্টি-টাচ অ্যাট্রিবিউশন

মার্কেটিং অ্যাট্রিবিউশন হল বিজ্ঞাপনদাতাদের দ্বারা ব্যবহৃত একটি পদ্ধতি যা বিপণন কৌশল এবং পরবর্তী বিজ্ঞাপন মিথস্ক্রিয়ার বিক্রয় বা রূপান্তরে অবদান নির্ধারণ করে।

সুরক্ষিত শ্রোতা API সহ

প্রোটেক্টেড অডিয়েন্স এপিআই রিটার্গেটিং এবং কাস্টম অডিয়েন্স ব্যবহারের ক্ষেত্রে সক্ষম করে, এবং প্রাইভেট অ্যাগ্রিগেশন আপনাকে ক্রেতা এবং বিক্রেতার ওয়ার্কলেট থেকে ইভেন্ট রিপোর্ট করতে দেয়। এপিআই নিলাম বিডের বিতরণ পরিমাপের মতো কাজের জন্য ব্যবহার করা যেতে পারে।

একটি Protected Audience API ওয়ার্কলেট থেকে, আপনি contributeToHistogram() ব্যবহার করে সরাসরি আপনার ডেটা একত্রিত করতে পারেন এবং contributeToHistogramOnEvent() ব্যবহার করে একটি ট্রিগারের উপর ভিত্তি করে আপনার ডেটা রিপোর্ট করতে পারেন, যা Protected Audience API এর জন্য একটি বিশেষ এক্সটেনশন।

উপলব্ধ ফাংশন

নিম্নলিখিত ফাংশনগুলি শেয়ার্ড স্টোরেজ এবং প্রোটেক্টেড অডিয়েন্স API ওয়ার্কলেটে উপলব্ধ privateAggregation অবজেক্টে উপলব্ধ।

হিস্টোগ্রামে অবদান রাখুন()

আপনি privateAggregation.contributeToHistogram({ bucket: <bucket>, value: <value> }) কল করতে পারেন, যেখানে অ্যাগ্রিগেশন কী হল bucket এবং অ্যাগ্রিগেটেবল মান হল value । bucket প্যারামিটারের জন্য, একটি BigInt প্রয়োজন। value প্যারামিটারের জন্য, একটি পূর্ণসংখ্যা Number প্রয়োজন।

পৌঁছানোর পরিমাপের জন্য শেয়ার্ড স্টোরেজে এটিকে কীভাবে বলা যেতে পারে তার একটি উদাহরণ এখানে দেওয়া হল:

iframe.js

// Cross-site iframe code

async function measureReach() {
 // Register worklet
 await window.sharedStorage.worklet.addModule('worklet.js');

 // Run reach measurement operation
 await window.sharedStorage.run('reach-measurement', {
  data: { contentId: '1234' }
 });
}

measureReach();

worklet.js

// Shared storage worklet code

function convertContentIdToBucket(campaignId){
  // Generate aggregation key
}

// The scale factor is multiplied by the aggregatable value to
// maximize the signal-to-noise ratio. See "Noise and scaling"
// section in the Aggregation Fundamentals document to learn more.
const SCALE_FACTOR = 65536;

class ReachMeasurementOperation {
  async run(data) {
    const key = 'has-reported-content';
    // Read the flag from Shared Storage
    const hasReportedContent = await sharedStorage.get(key) === 'true';

    // Don't send report if the flag is set
    if (hasReportedContent) {
      return;
    }

    // Send histogram report
    // Set the aggregation key in `bucket`
    // Bucket examples: 54153254n or BigInt(54153254)
    // Set the scaled aggregatable value in `value`
    privateAggregation.contributeToHistogram({
      bucket: convertContentIdToBucket(data.contentId),
      value: 1 * SCALE_FACTOR
    });

    // Set the flag in Shared Storage
    await sharedStorage.set(key, true);
  }
}

register('reach-measurement', ReachMeasurementOperation);

পূর্ববর্তী কোড উদাহরণে ক্রস-সাইট আইফ্রেম কন্টেন্ট লোড হলেই প্রাইভেট এগ্রিগেশন কল করা হবে। আইফ্রেম কোডটি ওয়ার্কলেট লোড করে এবং ওয়ার্কলেটটি প্রাইভেট এগ্রিগেশন API কল করে কন্টেন্ট আইডিটি একটি অ্যাগ্রিগেশন কী (বাকেট) তে রূপান্তরিত করে।

অবদান রাখুন হিস্টোগ্রামঅনইভেন্ট()

শুধুমাত্র Protected Audience API ওয়ার্কলেটের মধ্যে, আমরা একটি ট্রিগার-ভিত্তিক প্রক্রিয়া প্রদান করি যা শুধুমাত্র একটি নির্দিষ্ট ঘটনা ঘটলে রিপোর্ট পাঠানোর জন্য। এই ফাংশনটি বাকেট এবং মানকে সেই সংকেতগুলির উপর নির্ভর করার অনুমতি দেয় যা নিলামের সেই সময়ে এখনও উপলব্ধ নয়।

privateAggregation.contributeToHistogramOnEvent(eventType, contribution) পদ্ধতিটি একটি eventType নেয় যা ট্রিগারিং ইভেন্ট এবং ইভেন্টটি ট্রিগার হওয়ার সময় জমা দেওয়া contribution নির্দিষ্ট করে। ট্রিগারিং ইভেন্টটি নিলাম শেষ হওয়ার পরে নিলাম থেকে আসতে পারে, যেমন নিলামে জয় বা পরাজয়ের ঘটনা, অথবা এটি একটি বেড়াযুক্ত ফ্রেম থেকে আসতে পারে যা বিজ্ঞাপনটি রেন্ডার করেছে।

নিলাম ইভেন্টের জন্য একটি রিপোর্ট পাঠাতে, আপনি দুটি সংরক্ষিত কীওয়ার্ড ব্যবহার করতে পারেন, reserved.win , reserved.loss , এবং reserved.always । একটি ফেন্সড ফ্রেম থেকে একটি ইভেন্ট দ্বারা ট্রিগার করা একটি রিপোর্ট জমা দিতে, একটি কাস্টম ইভেন্টের ধরণ নির্ধারণ করুন। একটি ফেন্সড ফ্রেম থেকে ইভেন্টটি ট্রিগার করতে, Fenced Frames Ads Reporting API থেকে উপলব্ধ fence.reportEvent() পদ্ধতিটি ব্যবহার করুন।

নিচের উদাহরণটি নিলাম জয়ের ইভেন্টটি ট্রিগার করা হলে একটি ইম্প্রেশন রিপোর্ট পাঠায় এবং বিজ্ঞাপনটি রেন্ডার করা ফেন্সড ফ্রেম থেকে যদি কোনও click ইভেন্ট ট্রিগার করা হয় তবে একটি ক্লিক রিপোর্ট পাঠায়। ক্লিকথ্রু রেট গণনা করতে এই দুটি মান ব্যবহার করা যেতে পারে।

function generateBid(interestGroup, auctionSignals, perBuyerSignals, trustedBiddingSignals, browserSignals) {
  // …
  privateAggregation.contributeToHistogramOnEvent("reserved.win", {
      bucket: getImpressionReportBucket(),
      value: 1
  });
  privateAggregation.contributeToHistogramOnEvent("click", {
      bucket: getClickReportBuckets(), // 128-bit integer as BigInt
      value: 1
  });

আরও জানতে এক্সটেন্ডেড প্রাইভেট অ্যাগ্রিগেশন রিপোর্টিং ব্যাখ্যাকারী দেখুন।

ডিবাগমোড সক্ষম করুন()

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

ওয়ার্কলেটে privateAggregation.enableDebugMode() কল করলে ডিবাগ মোড সক্রিয় হয় যার ফলে অ্যাগ্রিগেটেবল রিপোর্টগুলিতে আনএনক্রিপ্টেড (ক্লিয়ারটেক্সট) পেলোড অন্তর্ভুক্ত হয়। এরপর আপনি অ্যাগ্রিগেশন সার্ভিস লোকাল টেস্টিং টুল ব্যবহার করে এই পেলোডগুলি প্রক্রিয়া করতে পারেন।

ডিবাগ মোড শুধুমাত্র সেইসব কলারদের জন্য উপলব্ধ যাদের তৃতীয় পক্ষের কুকিজ অ্যাক্সেস করার অনুমতি রয়েছে। যদি কলার তৃতীয় পক্ষের কুকিজ অ্যাক্সেস না করে, তাহলে enableDebugMode() নীরবে ব্যর্থ হবে।

আপনি privateAggregation.enableDebugMode({ <debugKey: debugKey> }) কল করেও ডিবাগ কী সেট করতে পারেন যেখানে একটি BigInt ডিবাগ কী হিসেবে ব্যবহার করা যেতে পারে। ডিবাগ কীটি কুকি-ভিত্তিক পরিমাপ থেকে ডেটা এবং ব্যক্তিগত একত্রীকরণ পরিমাপ থেকে ডেটা সংযুক্ত করতে ব্যবহার করা যেতে পারে।

প্রতিটি প্রসঙ্গে কেবল একবারই এগুলি কল করা যেতে পারে। পরবর্তী যেকোনো কল একটি ব্যতিক্রম দেবে।

// Enables debug mode
privateAggregation.enableDebugMode();

// Enables debug mode and sets a debug key
privateAggregation.enableDebugMode({ debugKey: BigInt(1234) });

রিপোর্ট যাচাইকরণ

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

একটি প্রসঙ্গ আইডি সেট করলে চূড়ান্ত সমষ্টিগত ফলাফলে অবদান রাখার সময় ডেটা সঠিক কিনা তা নিশ্চিত করতে সাহায্য করে। এটি অর্জন করা হয়:

• অবৈধ বা অপ্রমাণিত প্রতিবেদন প্রতিরোধ করা: যাচাই করুন যে প্রতিবেদনগুলি বৈধ এবং খাঁটি API কলের মাধ্যমে তৈরি করা হয়েছে, যা খারাপ ব্যক্তিদের জন্য প্রতিবেদন তৈরি করা কঠিন করে তোলে।
• রিপোর্ট রিপ্লে প্রতিরোধ করা: পুরানো রিপোর্ট পুনঃব্যবহারের যেকোনো প্রচেষ্টা সনাক্ত করুন এবং প্রত্যাখ্যান করুন, নিশ্চিত করুন যে প্রতিটি রিপোর্ট শুধুমাত্র একবারই সামগ্রিক ফলাফলে অবদান রাখা হয়েছে।

শেয়ার্ড স্টোরেজ

যখন শেয়ার্ড স্টোরেজ ব্যবহার করে এমন কোনও অপারেশন চালানো হয় যা একটি সমষ্টিগত প্রতিবেদন পাঠাতে পারে, তখন আপনি ওয়ার্কলেটের বাইরে একটি অপ্রত্যাশিত আইডি সেট করতে পারেন।

এই আইডিটি ওয়ার্কলেট থেকে তৈরি রিপোর্টে এমবেড করা আছে। privateAggregationConfig কী-এর অধীনে অপশন অবজেক্টের মধ্যে run() অথবা selectURL() Shared Storage পদ্ধতি কল করার সময় আপনি এটি নির্দিষ্ট করতে পারেন।

উদাহরণস্বরূপ:

sharedStorage.run('measurement-operation', {
  privateAggregationConfig: {
    contextId: 'exampleId123456789abcdeFGHijk'
  }
});

এই আইডি সেট করার পরে, আপনি এটি ব্যবহার করে যাচাই করতে পারেন যে রিপোর্টটি আপনার শেয়ার্ড স্টোরেজ অপারেশন থেকে পাঠানো হয়েছে। তথ্য ফাঁস রোধ করার জন্য, contributeToHistogram() কলের সংখ্যা নির্বিশেষে, প্রতিটি শেয়ার্ড স্টোরেজ অপারেশনে (যদিও কোনও অবদান না থাকে) ঠিক একটি রিপোর্ট পাঠানো হয়।

প্রাইভেট এগ্রিগেশন এপিআই এক ঘন্টা পর্যন্ত এলোমেলো বিলম্বের সাথে সমষ্টিগত প্রতিবেদন পাঠায়। তবে, প্রতিবেদন যাচাই করার জন্য একটি প্রসঙ্গ আইডি সেট করলে এই বিলম্ব হ্রাস পায়। এই ক্ষেত্রে, শেয়ার্ড স্টোরেজ অপারেশন শুরু হওয়ার পর থেকে ৫ সেকেন্ডের একটি নির্দিষ্ট, ছোট বিলম্ব থাকে।

একটি উদাহরণ কর্মপ্রবাহ (উপরের চিত্রে দেখানো হয়েছে):

1. শেয়ার্ড স্টোরেজ অপারেশনটি একটি প্রাইভেট অ্যাগ্রিগেশন কনফিগারেশনের মাধ্যমে পরিচালিত হয় যা একটি প্রসঙ্গ আইডি নির্দিষ্ট করে এবং একটি অ্যাগ্রিগেটেবল রিপোর্ট তৈরি করা হয়।
2. আপনার সার্ভারে পাঠানো জেনারেট করা সমষ্টিগত প্রতিবেদনে প্রসঙ্গ আইডিটি এমবেড করা থাকে।
3. আপনার সার্ভার জেনারেট করা সমষ্টিগত প্রতিবেদন সংগ্রহ করে।
4. আপনার সার্ভারের প্রসেসগুলি প্রতিটি অ্যাগ্রিগেটেবল রিপোর্টের কনটেক্সট আইডি আপনার সঞ্চিত কনটেক্সট আইডির সাথে পরীক্ষা করে রিপোর্টগুলি ব্যাচ করে আপনার অ্যাগ্রিগেশন সার্ভিসে পাঠানোর আগে এর বৈধতা যাচাই করে।

প্রসঙ্গ আইডি যাচাইকরণ

আপনার সংগ্রাহক সার্ভারে আগত প্রতিবেদনগুলি অ্যাগ্রিগেশন সার্ভিসে পাঠানোর আগে কয়েকটি ভিন্ন উপায়ে যাচাই করা যেতে পারে। অবৈধ প্রসঙ্গ আইডি সহ প্রতিবেদনগুলি প্রত্যাখ্যান করা যেতে পারে যখন প্রসঙ্গ আইডি হল:

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

অংশগ্রহণ করুন এবং মতামত শেয়ার করুন

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

• গিটহাব : ব্যাখ্যাকারী পড়ুন, প্রশ্ন উত্থাপন করুন এবং আলোচনায় অংশগ্রহণ করুন ।