গ্রাহকদের সাথে প্রচারণার কার্যকারিতা উন্নত করার জন্য প্রয়োজনীয় কর্মক্ষমতা অন্তর্দৃষ্টিগুলি বিজ্ঞাপন প্রযুক্তিবিদদের প্রদান করে অ্যাগ্রিগেশন পরিষেবা ।
এই নথিতে অন্তর্ভুক্ত রয়েছে :
- মূল শব্দ এবং ধারণা
- কিভাবে অ্যাগ্রিগেশন সার্ভিস আপনাকে বিস্তারিত রূপান্তর ডেটা এবং কাঁচা অ্যাগ্রিগেটেবল রিপোর্ট থেকে পরিমাপ পৌঁছাতে সাহায্য করে
- সমষ্টিগত প্রতিবেদন ব্যাচিং ধারণাগত ওভারভিউ
- ক্লাউড উপাদানগুলির ধারণাগত ওভারভিউ
এই নথিটি কার জন্য?
এই পৃষ্ঠাটি বিজ্ঞাপন প্রযুক্তিবিদ এবং ডেভেলপারদের বুঝতে সাহায্য করে যে কীভাবে আমাদের API গুলি কার্যকর, গোপনীয়তা সংরক্ষণকারী বিজ্ঞাপন পরিমাপ সক্ষম করে।
এই ডকুমেন্টটি ধরে নিচ্ছে যে আপনি প্রাইভেট অ্যাগ্রিগেশন API , অ্যাট্রিবিউশন রিপোর্টিং API , প্রোটেক্টেড অডিয়েন্স API , শেয়ার্ড স্টোরেজ এবং ট্রাস্টেড এক্সিকিউশন এনভায়রনমেন্টের সাথে পরিচিত।
মূল শব্দ এবং ধারণা
এগিয়ে যাওয়ার আগে মূল শব্দগুলির সাথে পরিচিত হন:
শব্দকোষ
- বিজ্ঞাপন প্রযুক্তি
-
একটি বিজ্ঞাপন প্ল্যাটফর্ম এমন একটি কোম্পানি যা বিজ্ঞাপন প্রদানের জন্য পরিষেবা প্রদান করে।
- সমষ্টিগত প্রতিবেদন
-
সমষ্টিগত প্রতিবেদনগুলি পৃথক ব্যবহারকারী ডিভাইস থেকে পাঠানো এনক্রিপ্ট করা প্রতিবেদন। এই প্রতিবেদনগুলিতে ক্রস-সাইট ব্যবহারকারীর আচরণ এবং রূপান্তর সম্পর্কিত ডেটা রয়েছে। রূপান্তর (কখনও কখনও অ্যাট্রিবিউশন ট্রিগার ইভেন্ট বলা হয়) এবং সংশ্লিষ্ট মেট্রিক্স বিজ্ঞাপনদাতা বা বিজ্ঞাপন প্রযুক্তি দ্বারা সংজ্ঞায়িত করা হয়। প্রতিটি প্রতিবেদন বিভিন্ন পক্ষকে অন্তর্নিহিত ডেটা অ্যাক্সেস করতে বাধা দেওয়ার জন্য এনক্রিপ্ট করা হয়।
- সমষ্টিগত প্রতিবেদন হিসাবরক্ষণ
-
একটি বিতরণ করা খাতা, উভয় সমন্বয়কারীতে অবস্থিত, যা বরাদ্দকৃত গোপনীয়তা বাজেট ট্র্যাক করে এবং 'নো ডুপ্লিকেট' নিয়ম প্রয়োগ করে। এটি হল গোপনীয়তা সংরক্ষণের পদ্ধতি, যা সমন্বয়কারীদের মধ্যে অবস্থিত এবং চালিত হয়, যা নিশ্চিত করে যে কোনো প্রতিবেদন বরাদ্দকৃত গোপনীয়তা বাজেটের বাইরে এগ্রিগেশন সার্ভিসের মাধ্যমে পাস না হয়।
ব্যাচিং কৌশলগুলি কীভাবে সমষ্টিগত প্রতিবেদনের সাথে সম্পর্কিত সে সম্পর্কে আরও পড়ুন ।
- সমষ্টিগত প্রতিবেদন অ্যাকাউন্টিং বাজেট
-
বাজেটের রেফারেন্স যা নিশ্চিত করে যে পৃথক প্রতিবেদনগুলি একবারের বেশি প্রক্রিয়া করা হবে না।
- সমষ্টি পরিষেবা
-
একটি বিজ্ঞাপন প্রযুক্তি-চালিত পরিষেবা যা একটি সংক্ষিপ্ত প্রতিবেদন তৈরি করতে সমষ্টিগত প্রতিবেদনগুলি প্রক্রিয়া করে।
আমাদের ব্যাখ্যাকারী এবং সম্পূর্ণ শর্তাবলীর তালিকায় অ্যাগ্রিগেশন সার্ভিস ব্যাকস্টোরি সম্পর্কে আরও পড়ুন।
- প্রত্যয়ন
-
সাধারণত ক্রিপ্টোগ্রাফিক হ্যাশ বা স্বাক্ষর সহ সফ্টওয়্যার পরিচয় প্রমাণীকরণের একটি প্রক্রিয়া। একত্রীকরণ পরিষেবা প্রস্তাবের জন্য, ওপেন সোর্স কোডের সাথে আপনার বিজ্ঞাপন প্রযুক্তি-চালিত একত্রীকরণ পরিষেবাতে চলমান কোডের সাথে সত্যায়ন মেলে।
- অবদান বন্ধন
- সমন্বয়কারী
-
মূল ব্যবস্থাপনা এবং সমষ্টিগত প্রতিবেদন অ্যাকাউন্টিংয়ের জন্য দায়ী সত্তা। একজন সমন্বয়কারী অনুমোদিত সমষ্টি পরিষেবা কনফিগারেশনের হ্যাশগুলির একটি তালিকা বজায় রাখে এবং ডিক্রিপশন কীগুলিতে অ্যাক্সেস কনফিগার করে।
- শব্দ এবং স্কেলিং
-
পরিসংখ্যানগত গোলমাল যা গোপনীয়তা রক্ষা করার জন্য এবং চূড়ান্ত প্রতিবেদনগুলি বেনামী পরিমাপের তথ্য সরবরাহ করে তা নিশ্চিত করার জন্য একত্রিতকরণ প্রক্রিয়া চলাকালীন সারাংশ প্রতিবেদনে যোগ করা হয়।
অ্যাডিটিভ নয়েজ মেকানিজম সম্পর্কে আরও পড়ুন, যা ল্যাপ্লেস ডিস্ট্রিবিউশন থেকে নেওয়া হয়েছে।
- রিপোর্টিং উৎস
-
যে সত্তা সমষ্টিগত প্রতিবেদনগুলি গ্রহণ করে—অন্য কথায়, আপনি বা একটি বিজ্ঞাপন প্রযুক্তি যাকে অ্যাট্রিবিউশন রিপোর্টিং API বলা হয়। সমষ্টিগত প্রতিবেদনগুলি ব্যবহারকারীর ডিভাইসগুলি থেকে প্রতিবেদনের উত্সের সাথে যুক্ত একটি সুপরিচিত URL-এ পাঠানো হয়৷ নথিভুক্তকরণের সময় রিপোর্টিং মূল মনোনীত করা হয়।
- শেয়ার করা আইডি
-
একটি গণনা করা মান যা
shared_info,reporting_origin,destination_site(শুধুমাত্র Attribution Reporting API এর জন্য),source_registration-time(শুধুমাত্র Attribution Reporting API এর জন্য),scheduled_report_time, এবং সংস্করণ নিয়ে গঠিত।shared_infoফিল্ডে একই অ্যাট্রিবিউট শেয়ার করা একাধিক রিপোর্টের একই শেয়ার করা আইডি থাকা উচিত। শেয়ার্ড আইডি সমষ্টিগত রিপোর্ট অ্যাকাউন্টিং এর মধ্যে একটি গুরুত্বপূর্ণ ভূমিকা পালন করে। - সারাংশ প্রতিবেদন
-
একটি অ্যাট্রিবিউশন রিপোর্টিং এপিআই এবং প্রাইভেট অ্যাগ্রিগেশন এপিআই রিপোর্টের ধরন। একটি সংক্ষিপ্ত প্রতিবেদনে সমষ্টিগত ব্যবহারকারীর ডেটা অন্তর্ভুক্ত থাকে এবং এতে আওয়াজ যুক্ত বিশদ রূপান্তর ডেটা থাকতে পারে। সংক্ষিপ্ত প্রতিবেদনগুলি সমষ্টিগত প্রতিবেদনের সমন্বয়ে গঠিত। তারা বৃহত্তর নমনীয়তার জন্য অনুমতি দেয় এবং ইভেন্ট-লেভেল রিপোর্টিংয়ের তুলনায় একটি সমৃদ্ধ ডেটা মডেল প্রদান করে, বিশেষ করে রূপান্তর মানের মতো কিছু ব্যবহারের ক্ষেত্রে।
- বিশ্বস্ত এক্সিকিউশন এনভায়রনমেন্ট ( TEE )
-
কম্পিউটার হার্ডওয়্যার এবং সফ্টওয়্যারগুলির একটি সুরক্ষিত কনফিগারেশন যা বহিরাগত দলগুলিকে এক্সপোজারের ভয় ছাড়াই মেশিনে চলমান সফ্টওয়্যারের সঠিক সংস্করণগুলি যাচাই করতে দেয়৷ TEE গুলি বহিরাগত দলগুলিকে যাচাই করার অনুমতি দেয় যে সফ্টওয়্যারটি ঠিক যা করে সফ্টওয়্যার প্রস্তুতকারক দাবি করে যে এটি করে - কম বা বেশি কিছুই নয়।
গোপনীয়তা স্যান্ডবক্স প্রস্তাবগুলির জন্য ব্যবহৃত TEE সম্পর্কে আরও জানতে, Protected Audience API পরিষেবা ব্যাখ্যাকারী এবং Aggregation Service Explaner পড়ুন৷
একত্রীকরণ পরিষেবা কর্মপ্রবাহ
সমষ্টি পরিষেবা কাঁচা সমষ্টিগত প্রতিবেদন থেকে বিস্তারিত রূপান্তর এবং পৌঁছানোর ডেটার সারাংশ প্রতিবেদন তৈরি করে। প্রতিবেদন তৈরির প্রবাহ নিম্নলিখিত ধাপগুলি নিয়ে গঠিত:
- একটি ব্রাউজার এনক্রিপ্ট করা রিপোর্ট তৈরি করার জন্য একটি পাবলিক কী নিয়ে আসে।
- এনক্রিপ্ট করা সমষ্টিগত প্রতিবেদনগুলি বিজ্ঞাপন প্রযুক্তি সার্ভারে পাঠানো হয়।
- বিজ্ঞাপন প্রযুক্তি সার্ভার ব্যাচ রিপোর্ট ( অ্যাভ্রো ফর্ম্যাটে) এবং সেগুলি অ্যাগ্রিগেশন সার্ভিসে পাঠায়।
- একজন অ্যাগ্রিগেশন ওয়ার্কার ডিক্রিপ্ট করার জন্য সমষ্টিগত প্রতিবেদনগুলি পুনরুদ্ধার করে।
- অ্যাগ্রিগেশন ওয়ার্কার একজন কোঅর্ডিনেটরের কাছ থেকে ডিক্রিপশন কী উদ্ধার করে।
- অ্যাগ্রিগেশন ওয়ার্কার অ্যাগ্রিগেশন এবং নয়েজিংয়ের জন্য রিপোর্টগুলি ডিক্রিপ্ট করে।
- সমষ্টিগত প্রতিবেদন অ্যাকাউন্টিং পরিষেবা পরীক্ষা করে যে প্রদত্ত সমষ্টিগত প্রতিবেদনের জন্য একটি সারাংশ প্রতিবেদন তৈরি করার জন্য পর্যাপ্ত গোপনীয়তা বাজেট আছে কিনা।
- সমষ্টি পরিষেবা একটি চূড়ান্ত সারসংক্ষেপ প্রতিবেদন জমা দেয়।
নিচের চিত্রটি ওয়েব এবং মোবাইল ডিভাইস থেকে প্রতিবেদন প্রাপ্তির সময় থেকে শুরু করে সমষ্টি পরিষেবা দ্বারা একটি সারাংশ প্রতিবেদন তৈরির সময় পর্যন্ত, সমষ্টি পরিষেবার কার্যকারিতা দেখায়।
সংক্ষেপে, অ্যাট্রিবিউশন রিপোর্টিং API অথবা প্রাইভেট অ্যাগ্রিগেশন API একাধিক ব্রাউজার ইনস্ট্যান্স থেকে রিপোর্ট তৈরি করে। ক্রোম একটি পাবলিক কী পায়, যা প্রতি সাত দিনে একবার ঘোরানো হয়, কোঅর্ডিনেটরের কী হোস্টিং সার্ভিস থেকে, যাতে রিপোর্টগুলিকে এনক্রিপ্ট করে বিজ্ঞাপন প্রযুক্তি রিপোর্টিং অরিজিনে পাঠানোর আগে। বিজ্ঞাপন প্রযুক্তি রিপোর্টিং অরিজিন ইনকামিং রিপোর্টগুলি সংগ্রহ করে এবং avro ফর্ম্যাটে রূপান্তর করে এবং সেগুলিকে একত্রিতকরণ পরিষেবাতে পাঠায়। যখন একটি ব্যাচ অনুরোধ একত্রিতকরণ পরিষেবাতে পাঠানো হয়, তখন এটি কী হোস্টিং পরিষেবা থেকে ডিক্রিপশন কীগুলি নিয়ে আসে, প্রতিবেদনগুলি ডিক্রিপ্ট করে এবং একটি সারাংশ প্রতিবেদন তৈরি করার জন্য সেগুলিকে একত্রিত করে এবং শব্দ করে, যতক্ষণ না সেগুলি তৈরি করার জন্য পর্যাপ্ত গোপনীয়তা বাজেট থাকে।
বাস্তবায়ন বিভাগে আপনার সমষ্টিগত প্রতিবেদনগুলি কীভাবে প্রস্তুত করবেন সে সম্পর্কে আরও জানুন।
সমষ্টিগত প্রতিবেদনের ব্যাচিং
নথিভুক্তিকরণ প্রক্রিয়ার সময় আপনি যে নির্দিষ্ট রিপোর্টিং অরিজিন সার্ভারটি নির্দিষ্ট করেছিলেন, তার সাহায্য ছাড়া রিপোর্টিং প্রবাহ সম্পূর্ণ হত না। রিপোর্টিং অরিজিন অ্যাগ্রিগেটেবল রিপোর্ট সংগ্রহ, রূপান্তর এবং ব্যাচ করার জন্য এবং গুগল ক্লাউড বা অ্যামাজন ওয়েব সার্ভিসে আপনার অ্যাগ্রিগেশন সার্ভিসে পাঠানোর জন্য প্রস্তুত করার জন্য দায়ী। আপনার অ্যাগ্রিগেটেবল রিপোর্টগুলি কীভাবে প্রস্তুত করবেন সে সম্পর্কে আরও পড়ুন।
ক্লাউড উপাদান
অ্যাগ্রিগেশন সার্ভিসে বেশ কয়েকটি ক্লাউড সার্ভিস কম্পোনেন্ট থাকে। আপনি সমস্ত প্রয়োজনীয় ক্লাউড সার্ভিস কম্পোনেন্ট তৈরি এবং কনফিগার করার জন্য প্রদত্ত টেরাফর্ম স্ক্রিপ্ট ব্যবহার করেন।
ফ্রন্টএন্ড পরিষেবা
পরিচালিত ক্লাউড পরিষেবা: ক্লাউড ফাংশন (গুগল ক্লাউড) / এপিআই গেটওয়ে (অ্যামাজন ওয়েব পরিষেবা)
ফ্রন্টএন্ড সার্ভিস হল একটি সার্ভারলেস গেটওয়ে যা চাকরি তৈরি এবং চাকরির অবস্থা পুনরুদ্ধারের জন্য অ্যাগ্রিগেশন API কলের প্রাথমিক প্রবেশ বিন্দু। এটি অ্যাগ্রিগেশন সার্ভিস ব্যবহারকারীদের কাছ থেকে অনুরোধ গ্রহণ, ইনপুট প্যারামিটার যাচাই এবং অ্যাগ্রিগেশন জব শিডিউলিং প্রক্রিয়া শুরু করার জন্য দায়ী।
ফ্রন্টএন্ড সার্ভিসের দুটি উপলব্ধ API রয়েছে:
| শেষবিন্দু | বিবরণ |
|---|---|
createJob | এই API একটি Aggregation Service জব ট্রিগার করে। জব ট্রিগার করার জন্য, জব আইডি, ইনপুট স্টোরেজের বিবরণ, আউটপুট স্টোরেজের বিবরণ এবং রিপোর্টিং অরিজিনের মতো তথ্যের প্রয়োজন হয়। |
getJob | এই API একটি নির্দিষ্ট জব আইডি সহ কাজের অবস্থা প্রদান করে। এটি কাজের অবস্থা সম্পর্কে তথ্য প্রদান করে, যেমন "প্রাপ্ত," "প্রগতিতে," অথবা "সমাপ্ত।" যদি কাজটি সম্পন্ন হয়, তাহলে এটি জব এক্সিকিউশনের সময় সম্মুখীন হওয়া যেকোনো ত্রুটির বার্তা সহ জব ফলাফলও প্রদান করে। |
অ্যাগ্রিগেশন সার্ভিস এপিআই ডকুমেন্টেশন দেখুন।
চাকরির সারি
পরিচালিত ক্লাউড পরিষেবা: পাব/সাব (গুগল ক্লাউড) / অ্যামাজন এসকিউএস (অ্যামাজন ওয়েব পরিষেবা)
জব কিউ হল একটি বার্তা সারি যেখানে অ্যাগ্রিগেশন সার্ভিসের জন্য জব রিকোয়েস্ট থাকে। ফ্রন্টএন্ড সার্ভিস জব রিকোয়েস্টগুলিকে কিউতে সন্নিবেশ করায়, যা পরে অ্যাগ্রিগেশন ওয়ার্কাররা ব্যবহার করে যারা সেগুলি প্রক্রিয়া করে।
ক্লাউড স্টোরেজ
পরিচালিত ক্লাউড পরিষেবা: গুগল ক্লাউড স্টোরেজ (গুগল ক্লাউড) / অ্যামাজন এস৩ (অ্যামাজন ওয়েব সার্ভিসেস)
অ্যাগ্রিগেশন সার্ভিস দ্বারা ব্যবহৃত ইনপুট এবং আউটপুট ফাইল, যেমন এনক্রিপ্ট করা রিপোর্ট ফাইল এবং আউটপুট সারাংশ রিপোর্ট, ক্লাউড স্টোরেজে রাখা হয়।
চাকরির মেটাডেটা ডাটাবেস
পরিচালিত ক্লাউড পরিষেবা: স্প্যানার (গুগল ক্লাউড) / ডায়নামোডিবি (অ্যামাজন ওয়েব পরিষেবা)
জব মেটাডেটা ডাটাবেস অ্যাগ্রিগেশন কাজের অবস্থা সংরক্ষণ এবং ট্র্যাক করার জন্য ব্যবহৃত হয়। এটি তৈরির সময়, অনুরোধ করা সময়, আপডেটের সময় এবং প্রাপ্ত, অগ্রগতিতে, বা সমাপ্তির মতো অবস্থা রেকর্ড করে। জব মেটাডেটা ডাটাবেস কাজের অগ্রগতির সাথে সাথে আপডেট করে।
সমষ্টি কর্মী
পরিচালিত ক্লাউড পরিষেবা: গোপনীয় স্থান (গুগল ক্লাউড) সহ কম্পিউট ইঞ্জিন / নাইট্রো এনক্লেভ (অ্যামাজন ওয়েব পরিষেবা) সহ অ্যামাজন ওয়েব পরিষেবা EC2।
একজন অ্যাগ্রিগেশন ওয়ার্কার জব কিউতে জব রিকোয়েস্ট প্রসেস করেন এবং কোঅর্ডিনেটরে কী জেনারেশন অ্যান্ড ডিস্ট্রিবিউশন সার্ভিস (KGDS) থেকে আনা কী ব্যবহার করে এনক্রিপ্ট করা ইনপুটগুলি ডিক্রিপ্ট করেন। জব প্রসেসিং লেটেন্সি কমাতে, অ্যাগ্রিগেশন ওয়ার্কার্স আট ঘন্টার জন্য ডিক্রিপশন কী ক্যাশে করে এবং তাদের প্রক্রিয়াজাতকরণ করা বিভিন্ন কাজের জন্য সেগুলি ব্যবহার করেন।
অ্যাগ্রিগেশন ওয়ার্কার্স একটি ট্রাস্টেড এক্সিকিউশন এনভায়রনমেন্ট (TEE) ইনস্ট্যান্সের মধ্যে কাজ করে। একজন কর্মী একবারে শুধুমাত্র একটি কাজ পরিচালনা করে। অটো স্কেলিং কনফিগারেশন সেট করে আপনি একাধিক কর্মীকে সমান্তরালভাবে কাজ প্রক্রিয়া করার জন্য কনফিগার করতে পারেন। যদি ব্যবহার করা হয়, তাহলে অটো স্কেলিং কাজের সারিতে থাকা বার্তার সংখ্যা অনুসারে কর্মীর সংখ্যা গতিশীলভাবে সামঞ্জস্য করে। আপনি টেরাফর্ম এনভায়রনমেন্ট ফাইলের মাধ্যমে অটো স্কেলিং এর জন্য কর্মীর সর্বনিম্ন এবং সর্বাধিক সংখ্যা কনফিগার করতে পারেন। অটোস্কেলিং সম্পর্কে আরও তথ্য এই টেরাফর্ম স্ক্রিপ্টগুলিতে পাওয়া যাবে: অ্যামাজন ওয়েব সার্ভিসেস বা গুগল ক্লাউড ।
সমষ্টিগত কর্মীরা সমষ্টিগত প্রতিবেদন হিসাবরক্ষণের জন্য সমষ্টিগত প্রতিবেদন হিসাবরক্ষণ পরিষেবাকে কল করে। এই পরিষেবাটি যাচাই করে যে গোপনীয়তা বাজেটের সীমা অতিক্রম না করা হলেই কাজগুলি পরিচালিত হয়। ( "কোনও সদৃশ নয়" নিয়ম দেখুন।) যদি বাজেট উপলব্ধ থাকে, তাহলে নয়েজ সমষ্টি ব্যবহার করে একটি সারাংশ প্রতিবেদন তৈরি করা হয়। সমষ্টিগত প্রতিবেদন হিসাবরক্ষণ সম্পর্কিত অতিরিক্ত বিবরণ পড়ুন।
জব মেটাডেটা ডাটাবেসে অ্যাগ্রিগেশন ওয়ার্কার্স জব মেটাডেটা আপডেট করে। এই তথ্যে জব রিটার্ন কোড এবং আংশিক রিপোর্ট ব্যর্থতার ক্ষেত্রে রিপোর্ট ত্রুটি কাউন্টার অন্তর্ভুক্ত থাকে। ব্যবহারকারীরা getJob জব স্টেট রিট্রিভাল API ব্যবহার করে স্টেটটি আনতে পারেন।
সমষ্টি পরিষেবা সম্পর্কে আরও বিস্তারিত বিবরণের জন্য এই ব্যাখ্যাকারীটি দেখুন।
পরবর্তী পদক্ষেপ
এখন যেহেতু আপনি জানেন যে অ্যাগ্রিগেশন সার্ভিস কীভাবে কাজ করে, গুগল ক্লাউড বা অ্যামাজন ওয়েব সার্ভিসের মাধ্যমে আপনার নিজস্ব ইনস্ট্যান্স স্থাপন করতে শুরু করার নির্দেশিকা অনুসরণ করুন।