এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

গোপনীয়তা & মেসেজিং জাভাস্ক্রিপ্ট API

ভূমিকা

এই API গোপনীয়তা এবং মেসেজিং ট্যাব দ্বারা অফার করা বার্তাগুলির সাথে ইন্টারঅ্যাক্ট করার জন্য সরঞ্জাম সরবরাহ করে। এটি দিয়ে, আপনি করতে পারেন:

যে কোনো ব্যবহারকারীর জন্য মেসেজিং দমন করুন
একজন ব্যবহারকারীর বিজ্ঞাপন ব্লকিং স্ট্যাটাস জিজ্ঞাসা করুন
একজন ব্যবহারকারীকে সম্মতি প্রত্যাহার করার অনুমতি দিন (যদি প্রযোজ্য হয়)

আপনি কিছু শিল্প মানক প্রোটোকল ব্যবহার করে ব্যবহারকারীর সম্মতি সংগ্রহ করতে এই সরঞ্জামগুলি ব্যবহার করতে পারেন:

IAB TCF v2 স্পেস ব্যবহার করে GDPR সম্মতি
IAB GPP CPRA স্পেক ব্যবহার করে CPRA অপ্ট-আউট করুন৷

এই ক্ষেত্রে, সম্মতির স্ট্যাটাস সেই API-এর মাধ্যমে জানানো হয়।

আপনি কয়েকটি উপায়ে আপনার সাইটে এই ব্যবহারকারীর মেসেজিং কার্যকারিতা স্থাপন করতে পারেন:

বেশীরভাগ ক্ষেত্রে, আপনাকে পুনরায় ট্যাগ করার দরকার নেই - আপনার বিদ্যমান Google প্রকাশক ট্যাগ বা AdSense ট্যাগ প্রাসঙ্গিক পণ্যে বার্তা প্রকাশিত হওয়ার পরে ব্যবহারকারীর বার্তাগুলি স্থাপন করে৷
আপনি যদি বিজ্ঞাপন ব্লকিং রিকভারি মেসেজ ব্যবহার করেন, তাহলে আপনার পৃষ্ঠায় বিজ্ঞাপন ব্লকিং ট্যাগটি স্পষ্টভাবে যোগ করতে হবে। আরও তথ্যের জন্য অ্যাড ম্যানেজার এবং AdSense ট্যাগিং নির্দেশাবলী দেখুন।

googlefc হল গ্লোবাল নেমস্পেস যা ব্যবহারকারীর মেসেজিং কার্যকারিতা জাভাস্ক্রিপ্ট Window তার API-এর জন্য ব্যবহার করে।

দ্রষ্টব্য: এই রেফারেন্সটি গুগল-ক্লোজার টাইপ টীকা ব্যবহার করে। এখানে উদাহরণ দ্বারা একটি সংক্ষিপ্ত ব্যাখ্যা:

boolean : জাভাস্ক্রিপ্ট বুলিয়ান টাইপ।
number|string : ইউনিয়ন টাইপ। মানটি হয় সংখ্যা বা স্ট্রিং।
?string : ইঙ্গিত করে যে একটি মান হল স্ট্রিং বা নাল টাইপ। স্ট্রিং, সংখ্যা এবং বুলিয়ান প্রকারগুলি ডিফল্টরূপে বাতিলযোগ্য নয়।
Array<string> : স্ট্রিংয়ের একটি অ্যারে।
googlefc.CallbackQueue : googlefc.CallbackQueue ক্লাসের অবজেক্ট।
!googlefc.CallbackQueue : নির্দেশ করে যে একটি মান হল googlefc.CallbackQueue টাইপ এবং শূন্য নয়৷ সমস্ত অবজেক্ট প্রকার ডিফল্টরূপে বাতিলযোগ্য।
!Array<!googlefc.CallbackQueue> : googlefc.CallbackQueue অবজেক্টের একটি অ্যারে। প্রতিটি বস্তু শূন্য নয়। অ্যারে নিজেই নাল নয়।
!googlefc.ConsentStatusEnum : ConsentStatusEnum-এ থাকা নম্বর।
!googlefc.AdBlockerStatusEnum : AdBlockerStatusEnum-এ থাকা নম্বর।
!googlefc.AllowAdsStatusEnum : AllowAdsStatusEnum-এ থাকা নম্বর।
!googlefc.ccpa.InitialCcpaStatusEnum : InitialCcpaStatusEnum-এ থাকা নম্বর।

Google Closure ডক্সে আরও বিস্তারিত তথ্য খুঁজুন।

ক্ষেত্রের সারাংশ

নাম	টাইপ	সংজ্ঞা
`googlefc.controlledMessagingFunction`	ফাংশন(!বস্তু)	একটি ফাংশন যা নির্ধারণ করে যে কোনো মেসেজিং নিয়ে এগিয়ে যেতে হবে কিনা। এই কার্যকারিতা সমস্ত বার্তা ধরনের জন্য সমর্থিত.
`googlefc.callbackQueue`	!অ্যারে<!অবজেক্ট<স্ট্রিং, ফাংশন()>> \| !অ্যারে<ফাংশন()> \| !googlefc.CallbackQueue	ব্যবহারকারীর মেসেজিং প্রশ্নের অ্যাসিঙ্ক্রোনাস এক্সিকিউশনের জন্য কলব্যাক সারির রেফারেন্স।
`googlefc.CallbackQueue`	বস্তু	কলব্যাক সারি অবজেক্টের ধরন।
`googlefc.AdBlockerStatusEnum`	!অবজেক্ট<স্ট্রিং, সংখ্যা>	ব্যবহারকারীর বিজ্ঞাপন ব্লকার অবস্থার প্রতিনিধিত্ব করার জন্য একটি enum।
`googlefc.AllowAdsStatusEnum`	!অবজেক্ট<স্ট্রিং, সংখ্যা>	ব্যবহারকারীর অনুমতি-বিজ্ঞাপনের অবস্থার প্রতিনিধিত্ব করার জন্য একটি enum।
`googlefc.ccpa.InitialCcpaStatusEnum`	!অবজেক্ট<স্ট্রিং, সংখ্যা>	ব্যবহারকারীর প্রাথমিক CPRA অবস্থার প্রতিনিধিত্ব করার জন্য একটি enum।
`googlefc.ccpa.overrideDnsLink`	অনির্ধারিত\|বুলিয়ান	একটি বুলিয়ান যা একটি কাস্টম বিক্রি করবেন না লিঙ্ক ব্যবহার করতে সত্য সেট করা যেতে পারে।

পদ্ধতির সারাংশ

নাম	রিটার্ন টাইপ	সংজ্ঞা
`googlefc.showRevocationMessage()`	অনির্ধারিত	সম্মতি রেকর্ড সাফ করে এবং ব্যবহারকারীর জন্য প্রযোজ্য সম্মতি বার্তা দেখানোর জন্য `googlefc` স্ক্রিপ্ট পুনরায় লোড করে।
`googlefc.getAdBlockerStatus()`	সংখ্যা	ব্যবহারকারীর বিজ্ঞাপন ব্লক করার অবস্থার উপর নির্ভর করে `AdBlockerStatusEnum` এ একটি মান প্রদান করে।
`googlefc.getAllowAdsStatus()`	সংখ্যা	ব্যবহারকারীর অনুমতি-বিজ্ঞাপন স্থিতির উপর নির্ভর করে `AllowAdsStatusEnum` এ একটি মান প্রদান করে।
`googlefc.ccpa.getInitialCcpaStatus()`	সংখ্যা	ব্যবহারকারীর প্রাথমিক CPRA অবস্থার উপর নির্ভর করে `InitialCcpaStatusEnum` এ একটি মান প্রদান করে।
`googlefc.ccpa.openConfirmationDialog(function(boolean))`	অনির্ধারিত	ডিফল্ট বিক্রি করবেন না লিঙ্কটি ওভাররাইড করা থাকলে CPRA নিশ্চিতকরণ ডায়ালগ খোলে।

আপনার সাইটে পরীক্ষা এবং ডিবাগিং

গোপনীয়তা এবং মেসেজিং ডিবাগিং এবং টেস্টিং কার্যকারিতা প্রদান করে যা আপনাকে দেখতে দেয় যে নির্দিষ্ট বার্তাগুলি (বা বার্তাগুলির সংমিশ্রণ) আপনার প্রকৃত সাইটে কেমন দেখাচ্ছে৷

পূর্বশর্ত:

আপনি যে বার্তা(গুলি) এর পূর্বরূপ দেখতে চান সেই সাইটের অধীনে প্রকাশিত হতে হবে যার বিরুদ্ধে আপনি পরীক্ষা করছেন৷

আপনি নিম্নলিখিত ডিবাগিং URL প্যারামিটার ব্যবহার করে আপনার সাইটে একটি লাইভ পূর্বরূপ দেখতে পারেন:

ডিবাগ প্যারামিটার	অনুমোদিত মান
`fc`	`alwaysshow` (ডিবাগ/প্রিভিউ মোড ট্রিগার করতে)
`fctype`	`ab` (বিজ্ঞাপন ব্লকিং বার্তা), `ccpa` (CPRA অপ্ট-আউট বার্তা), `gdpr` (GDPR সম্মতি বার্তা), `monetization` (অফারওয়াল বার্তা)

আপনার সাইটে (foo.com) পূর্বরূপ দেখতে এটি কীভাবে ব্যবহার করবেন তার কিছু উদাহরণ:

CPRA মেসেজিং পরীক্ষা করুন -- http://foo.com/?fc=alwaysshow&fctype=ccpa
GDPR মেসেজিং পরীক্ষা করুন -- http://foo.com/?fc=alwaysshow&fctype=gdpr

ক্ষেত্র: ব্যাখ্যা এবং উদাহরণ

googlefc.controlledMessagingFunction {function(!Object)}

একটি ফাংশন যা বার্তাগুলি প্রদর্শন করা উচিত কিনা তা নির্ধারণ করে। এটি গ্রাহকের স্থিতি বা পৃষ্ঠার URL এর মতো প্রকাশক-নির্দিষ্ট শর্তে বার্তা রেন্ডারিং গেট করতে ব্যবহার করা যেতে পারে।

অন্যান্য স্ক্রিপ্ট লোড হওয়ার আগে আপনি যখন উইন্ডোতে googlefc.controlledMessagingFunction সংজ্ঞায়িত করেন, তখন আপনি message.proceed(boolean) কল না করা পর্যন্ত বার্তাগুলি প্রদর্শিত হয় না। calling message.proceed(true) মেসেজিংকে যথারীতি চলতে দেয়, যেখানে calling message.proceed(false) কোনো বার্তাকে পেজভিউ দেখাতে বাধা দেয়।

সতর্কতা: পৃষ্ঠায় googlefc.controlledMessagingFunction সংজ্ঞায়িত করা থাকলে, message.proceed() কল না করা পর্যন্ত কোনো গোপনীয়তা এবং বার্তাপ্রেরণ বার্তা প্রদর্শিত হবে না। এটি বিজ্ঞাপন পরিবেশন বিলম্বিত হতে পারে. অতএব, প্রত্যাশিত মেসেজিং এবং বিজ্ঞাপন পরিবেশন আচরণের গ্যারান্টি দেওয়ার জন্য পৃষ্ঠাটি লোড হওয়ার পরপরই message.proceed() কল করা হয়েছে তা নিশ্চিত করুন।

উদাহরণ: অনুমান করুন যে আপনার পৃষ্ঠায় এই স্ক্রিপ্টটি রয়েছে যা একটি অ্যাসিঙ্ক ফাংশন নির্ধারণ করে determineIfUserIsSubscriber() যেটি লগ-ইন করা ব্যবহারকারী একজন গ্রাহক কিনা তা পরীক্ষা করে।

<head>
  <script>
    window.isSubscriber = undefined;
    function determineIfUserIsSubscriber() {
      if (isSubscriber !== undefined) {
        return isSubscriber;
      }
      return new Promise(resolve => {
        setTimeout(() => {
          // Change this to true if you want to test what subscribers would see.
          window.isSubscriber = false;
          resolve(window.isSubscriber);
        }, 1000);
      });
    }
  </script>
</head>

এটি একটি উদাহরণ যে আপনি কীভাবে googlefc.controlledMessagingFunction ব্যবহার করতে পারেন শুধুমাত্র নন-সাবস্ক্রাইবারদের বার্তাটি দেখাতে।

<head>
  <script>
    // Define googlefc and the controlled messaging function on the Window.
    window.googlefc = window.googlefc || {};
    googlefc.controlledMessagingFunction = async (message) => {
      // Determine if the user is a subscriber asynchronously.
      const isSubscriber = await determineIfUserIsSubscriber();

      if (isSubscriber) {
        // If the user is a subscriber, don't show any messages.
        message.proceed(false);
      } else {
        // Otherwise, show messages as usual.
        message.proceed(true);
      }
    }
  </script>
</head>

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

অফারওয়াল-নির্দিষ্ট নিয়ন্ত্রিত মেসেজিং একটি অতিরিক্ত প্যারামিটার পাস করে message.proceed() , googlefc.MessageTypeEnum টাইপের একটি Array অর্জন করে।

উদাহরণ: এটি শুধুমাত্র গ্রাহকদের জন্য অফারওয়াল পরিবেশন দমন করার জন্য googlefc.controlledMessagingFunction ব্যবহার করার একটি উদাহরণ, অন্যান্য বার্তার ধরনকে দমন না করে:

<head>
  <script>
    // Define googlefc and the controlled messaging function on the Window.
    window.googlefc = window.googlefc || {};
    googlefc.controlledMessagingFunction = async (message) => {
     // Determine if the Offerwall should display or not.
     const shouldDisplayOfferwall = await determineIfUserIsSubscriber();
     const applicableMessageTypes = [];

     if (!shouldDisplayOfferwall) {
       // Do not show the Offerwall, but allow other message types to display.
       applicableMessageTypes.push(window.googlefc.MessageTypeEnum.OFFERWALL);
       message.proceed(false, applicableMessageTypes);
     } else {
       // Otherwise, show messages as usual.
       message.proceed(true);
     }
    }
  </script>
</head>

পরামর্শ: calling message.proceed(true) শুধুমাত্র অফারওয়ালকে প্রদর্শনের অনুমতি দেয়- এটি গ্যারান্টি দেয় না যে একটি অফারওয়াল প্রদর্শন করবে । অফারওয়াল অনেকগুলি কাস্টমাইজেশন সমর্থন করে যা বার্তা রেন্ডার করার সময় প্রভাবিত করতে পারে, যা নিয়ন্ত্রিত মেসেজিং ফাংশন ব্যবহার করার সময় বিবেচনা করা উচিত। উদাহরণস্বরূপ, বার্তাটির ফ্রিকোয়েন্সি সেটিংস পরিবর্তন করে 2টি পেজভিউয়ের পরে দেখানো থেকে 0 পেজভিউয়ের পরে দেখানোর জন্য বৈশিষ্ট্যটিকে আপনার অফারওয়ালের পরিবেশনকে প্রভাবিত করতে না করতে বিবেচনা করুন৷

googlefc.callbackQueue {!Array<!Object<string, function()>> | !Array<function()> | !googlefc.CallbackQueue}

মেসেজিং-সম্পর্কিত কলগুলির অ্যাসিঙ্ক্রোনাস নির্বাহের জন্য বিশ্বব্যাপী কলব্যাক সারির রেফারেন্স। যেকোনো ফাংশন চালু করার একমাত্র সমর্থিত উপায় হল এটি callbackQueue যোগ করা।

যেহেতু বিভিন্ন সময়ে বিভিন্ন ধরনের ডেটা পাওয়া যায়, তাই একটি ফাংশন একটি মানচিত্র হিসেবে যুক্ত করা উচিত, নিচের স্ট্রিংগুলির মধ্যে একটি কী হিসাবে এবং ফাংশনটিকে মান হিসাবে কার্যকর করতে হবে।

সমর্থিত কী:

মূল নাম	ব্যবহার	আপেক্ষিক বিলম্ব
`CONSENT_API_READY`	`CONSENT_API_READY` কী সহ কলব্যাক সারিতে পুশ করা ফাংশনগুলি কার্যকর করা হয় যখন সমর্থিত সম্মতি ফ্রেমওয়ার্কগুলির জন্য APIগুলি সংজ্ঞায়িত এবং কলযোগ্য হয়৷ এই বিন্দু থেকে, পরবর্তীতে যোগ করা যেকোন `CONSENT_API_READY` কীড ফাংশনগুলির সম্পাদন সিঙ্ক্রোনাস। ফ্রেমওয়ার্ক-নির্দিষ্ট বিবরণের জন্য IAB ফ্রেমওয়ার্কের বিভাগগুলি দেখুন।	কম
`CONSENT_DATA_READY`	`CONSENT_DATA_READY` কী দিয়ে কলব্যাক সারিতে ঠেলে দেওয়া ফাংশনগুলি কার্যকর করা হয় যখন সমর্থিত সম্মতি কাঠামোর অধীনে সংগৃহীত ব্যবহারকারীর সম্মতি জানা যায় (হয় পূর্বের সম্পাদন থেকে বা একবার ব্যবহারকারী সম্মতি বার্তার সাথে ইন্টারঅ্যাক্ট করে)। এই বিন্দু থেকে, পরবর্তীতে যোগ করা যেকোন `CONSENT_DATA_READY` কীড ফাংশনগুলির সম্পাদন সিঙ্ক্রোনাস।	উচ্চ
`AD_BLOCK_DATA_READY`	`AD_BLOCK_DATA_READY` কী দিয়ে কলব্যাক সারিতে পুশ করা ফাংশনগুলি কার্যকর করা হয় যখন বিজ্ঞাপন ব্লকিং ডেটা প্রবাহে উপলব্ধ হয়। এই বিন্দু থেকে, পরবর্তীতে যোগ করা `AD_BLOCK_DATA_READY` কীড ফাংশনগুলির সম্পাদন সিঙ্ক্রোনাস।	উচ্চ
`INITIAL_CCPA_DATA_READY`	`INITIAL_CCPA_DATA_READY` সহ কলব্যাক সারিতে পুশ করা ফাংশনগুলি কার্যকর করা হয় যখন CPRA ডেটা প্রবাহে উপলব্ধ হয়। মনে রাখবেন যে CPRA ডেটার জন্য পরবর্তী যেকোনো অনুরোধ সরাসরি US Privacy API ( `__uspapi` ) এ কল করে প্রাপ্ত করা উচিত।	মাঝারি

গুরুত্বপূর্ণ: CONSENT_API_READY শুধুমাত্র নির্দেশ করে যে সমর্থিত সম্মতি ফ্রেমওয়ার্ক APIগুলি সংজ্ঞায়িত করা হয়েছে; ব্যবহারকারী সম্মতি স্ট্রিং এখনও উপলব্ধ নাও হতে পারে. CONSENT_DATA_READY কী ব্যবহারকারীর সম্মতি স্ট্রিংগুলি উপলব্ধ হওয়ার সাথে সম্পর্কিত, কিন্তু CONSENT_DATA_READY -কীড ফাংশনগুলি সবসময় CONSENT_API_READY -কীড ফাংশনের চেয়ে প্রবাহে পরে কার্যকর করা হয়৷

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

googlefc.CallbackQueue {!Object}

পদ্ধতির সারাংশ:

নাম	টাইপ	প্যারামিটার	রিটার্ন টাইপ	ভূমিকা
`push(data)`	সংখ্যা	`data` : ডাটা উপলভ্যতার ধরনগুলির মধ্যে একটি হিসাবে কী সহ একটি কী-মানের জোড়া এবং একটি জাভাস্ক্রিপ্ট ফাংশন হিসাবে কার্যকর করা হবে। গ্রহণযোগ্য ডেটা উপলব্ধতা কীগুলি হল `CONSENT_API_READY` , `CONSENT_DATA_READY` , `AD_BLOCK_DATA_READY` এবং `INITIAL_CCPA_DATA_READY` ৷	এখন পর্যন্ত যোগ করা কমান্ডের সংখ্যা। এটি অ্যারের বর্তমান দৈর্ঘ্য প্রদান করে।	যে ক্রমে ডেটা পাওয়া যায় সেই ক্রমে পাস করা ফাংশনটি কার্যকর করে, তারপর এই ফাংশনগুলি সারিতে যোগ করা হয় সেই ক্রমে।

উদাহরণ:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {}
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'AD_BLOCK_DATA_READY':
    () => {
      if (googlefc.getAdBlockerStatus() == googlefc.AdBlockerStatusEnum.NO_AD_BLOCKER) {
        // Handle a non-ad blocking user.
      }
    }
  });
</script>

googlefc.AdBlockerStatusEnum {!Object<string, number>}

ব্যবহারকারীর বিভিন্ন বিজ্ঞাপন ব্লকিং অবস্থার প্রতিনিধিত্ব করে। বিভিন্ন রাজ্য হল:

googlefc.AdBlockerStatusEnum = {
  // Something failed, in an unknown state.
  UNKNOWN: 0,
  // The user was running an extension level ad blocker.
  EXTENSION_AD_BLOCKER: 1,
  // The user was running a network level ad blocker.
  NETWORK_LEVEL_AD_BLOCKER: 2,
  // The user was not blocking ads.
  NO_AD_BLOCKER: 3,
};

googlefc.AllowAdsStatusEnum {!Object<string, number>}

ব্যবহারকারীর বিভিন্ন বিজ্ঞাপন ব্লক করার অনুমতি-বিজ্ঞাপন অবস্থার প্রতিনিধিত্ব করে। বিভিন্ন রাজ্য হল:

googlefc.AllowAdsStatusEnum = {
  // Something failed, in an unknown state.
  UNKNOWN: 0,
  // User is currently using an ad blocker, was never using an ad blocker, or
  // allowed ads, but not because they saw the Privacy & messaging message.
  ADS_NOT_ALLOWED: 1,
  // User is no longer using an ad blocker after seeing the ad blocking message.
  ADS_ALLOWED: 2,
};

googlefc.ccpa.InitialCcpaStatusEnum{!Object<string, number>}

googlefc.ccpa.InitialCcpaStatusEnum = {
  // Something failed, in an unknown state.
  UNKNOWN: 0,
  // CPRA does not apply to this user.
  CCPA_DOES_NOT_APPLY: 1,
  // CPPA applies to this user, and the user has not opted out yet.
  NOT_OPTED_OUT: 2,
  // CPPA applies to this user, and the user has opted out.
  OPTED_OUT: 3,
};

googlefc.ccpa.overrideDnsLink{undefined|boolean}

ডিফল্ট বিক্রি করবেন না লিঙ্কটি লুকাতে এবং একটি কাস্টম বিক্রি করবেন না লিঙ্ক ব্যবহার করার জন্য এই ক্ষেত্রটিকে সত্য হিসাবে সেট করুন৷

উদাহরণ:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {}
  // Signals that the default DNS link will be overridden.
  googlefc.ccpa.overrideDnsLink = true;
</script>

পদ্ধতি: ব্যাখ্যা এবং উদাহরণ

googlefc.getConsentStatus(): {number}

googlefc.getConsentedProviderIds(): {!Array<string>}

কল করা হলে এটি এখন সর্বদা একটি খালি তালিকা প্রদান করে।

googlefc.showRevocationMessage(): {undefined}

বর্তমান সম্মতির রেকর্ড সাফ করে এবং এই ব্যবহারকারীর জন্য প্রযোজ্য সম্মতি বার্তা দেখায়। এই ফাংশনের জন্য যে কীটি নির্দিষ্ট করা উচিত তা হল CONSENT_DATA_READY ।

উদাহরণ:

<button type="button" onclick="googlefc.callbackQueue.push({'CONSENT_DATA_READY': () => googlefc.showRevocationMessage()});">
  Click here to revoke
</button>

googlefc.getAdBlockerStatus(): {number}

ব্যবহারকারীর বিজ্ঞাপন ব্লক করার অবস্থার উপর নির্ভর করে AdBlockerStatusEnum-এ একটি মান প্রদান করে। এই ফাংশনের জন্য যে কীটি নির্দিষ্ট করা উচিত তা হল AD_BLOCK_DATA_READY ।

উদাহরণ:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {}
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'AD_BLOCK_DATA_READY':
    () => {
      switch (googlefc.getAdBlockerStatus()) {
          case googlefc.AdBlockerStatusEnum.EXTENSION_LEVEL_AD_BLOCKER:
          case googlefc.AdBlockerStatusEnum.NETWORK_LEVEL_AD_BLOCKER:
            // Insert handling for cases where the user is blocking ads.
            break;
          case googlefc.AdBlockerStatusEnum.NO_AD_BLOCKER:
            // Insert handling for cases where the user is not blocking ads.
            break;
          case googlefc.AdBlockerStatusEnum.UNKNOWN:
            // Insert handling for unknown cases.
            break;
      }
    }
  });
</script>

googlefc.getAllowAdsStatus(): {number}

ব্যবহারকারীর অনুমতি-বিজ্ঞাপন স্থিতির উপর নির্ভর করে AllowAdsStatusEnum এ একটি মান প্রদান করে। এই ফাংশনের জন্য যে কীটি নির্দিষ্ট করা উচিত তা হল AD_BLOCK_DATA_READY ।

উদাহরণ:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {}
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'AD_BLOCK_DATA_READY':
    () => {
      switch (googlefc.getAllowAdsStatus()) {
        case googlefc.AllowAdsStatusEnum.ADS_NOT_ALLOWED:
          // Insert handling for cases where the user has not allowed ads.
          // The user may have never been an ad blocker.
          break;
        case googlefc.AllowAdsStatusEnum.ADS_ALLOWED:
          // Insert handling for cases where the user saw the ad blocking
          // message and allowed ads on the site.
          break;
        case googlefc.AllowAdsStatusEnum.UNKNOWN:
          // Insert handling for unknown cases.
          break;
      }
    }
  });
</script>

googlefc.ccpa.getInitialCcpaStatus(): {number}

ব্যবহারকারীর CPRA অবস্থার উপর নির্ভর করে InitialCcpaStatusEnum এ একটি মান প্রদান করে। এই ফাংশনের জন্য যে কীটি নির্দিষ্ট করা উচিত তা হল INITIAL_CCPA_DATA_READY । মনে রাখবেন যে CPRA ডেটার জন্য পরবর্তী যেকোনো অনুরোধ সরাসরি US Privacy API ( __uspapi ) এ কল করে প্রাপ্ত করা উচিত।

উদাহরণ:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {}
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'INITIAL_CCPA_DATA_READY':
    () => {
      switch (googlefc.ccpa.getInitialCcpaStatus()) {
        case googlefc.ccpa.InitialCcpaStatusEnum.CCPA_DOES_NOT_APPLY:
          // Insert handling for cases where the user is not CPRA eligible.
          break;
        case googlefc.ccpa.InitialCcpaStatusEnum.NOT_OPTED_OUT:
          // Insert handling for cases where the user is CPRA eligible and has
          // not opted out.
          break;
        case googlefc.ccpa.InitialCcpaStatusEnum.OPTED_OUT:
          // Insert handling for cases where the user is CPRA eligible and has
          // opted out.
          break;
      }
    }
  });
</script>

googlefc.ccpa.openConfirmationDialog(function(boolean)): {undefined}

ডিফল্ট বিক্রি করবেন না লিঙ্কটি ওভাররাইড করা থাকলে CPRA নিশ্চিতকরণ ডায়ালগ খোলে। একবার ব্যবহারকারী নিশ্চিতকরণ ডায়ালগের সাথে ইন্টারঅ্যাক্ট করলে, প্রদত্ত কলব্যাক ফাংশনটি true সাথে কল করা হয় যদি ব্যবহারকারী অপ্ট-আউট করার সিদ্ধান্ত নেয় এবং অন্যথায় false ।

উদাহরণ:

<script>
// This callback will be called with the user CPRA decision.
const ccpaCompletionCallback = (userOptedOut) => {
  // Insert handling for user opt-out status here.
}
// Invoke the CPRA confirmation dialog when the user clicks the link.
document.getElementById("your-custom-ccpa-do-not-sell-link").addEventListener(
  "click", () => googlefc.ccpa.openConfirmationDialog(ccpaCompletionCallback));
</script>

আপনি যদি IAB TCF v2 ফ্রেমওয়ার্কের অধীনে GDPR সম্মতি সংগ্রহ করতে Google সম্মতি ব্যবস্থাপনা সমাধান ব্যবহার করেন, তাহলে আপনার IAB TCF v2 API ব্যবহার করা উচিত।

আপনি CONSENT_API_READY কলব্যাক সারি কী ব্যবহার করতে পারেন যাতে পৃষ্ঠায় IAB TCF v2 API সংজ্ঞায়িত করা থাকলেই সংশ্লিষ্ট কলব্যাকগুলিকে আহ্বান করা হয়। এটি IAB TCF v2 API-এর 'addEventListener' কমান্ডের সাথে ব্যবহার করা উচিত।

উদাহরণ:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback using the CONSENT_API_READY key on the callbackQueue.
  window.googlefc.callbackQueue.push({
    'CONSENT_API_READY':
    () => __tcfapi('addEventListener', 2.2, (data, success) => {
      // Do something with consent data value; this callback may be invoked
      // multiple times as user completes consent flow.
    })
  });
</script>

আপনি CONSENT_DATA_READY কলব্যাক সারি কী ব্যবহার করতে পারেন যে সংশ্লিষ্ট কলব্যাকগুলি শুধুমাত্র যখন ব্যবহারকারীর সম্মতি সংগ্রহ করা হয় এবং IAB TCF v2 API ব্যবহার করে অ্যাক্সেসযোগ্য হয় তখনই তা নিশ্চিত করতে পারেন৷ এটি 'addEventListener' কমান্ডের সাথে একত্রে ব্যবহার করা যেতে পারে - আপনার দেওয়া কলব্যাকের প্রথম আহ্বানে প্রদত্ত ডেটাতে ব্যবহারকারীর সম্মতি নির্বাচন থাকবে (যতক্ষণ TCF v2 এই ব্যবহারকারীর ক্ষেত্রে প্রযোজ্য হবে)। মনে রাখবেন যে TCF v2.2 প্রকাশের সাথে, 'getTCData' কমান্ডটি এখন অবমূল্যায়িত হয়েছে।

উদাহরণ:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback using the CONSENT_DATA_READY key on the callbackQueue.
  window.googlefc.callbackQueue.push({
    'CONSENT_DATA_READY':
    () => __tcfapi('addEventListener', 2.2, (data, success) => {
      // Do something with consent data value; this callback may be invoked
      // multiple times if user consent selections change.
    })
  });
</script>

CPRA-এর জন্য IAB GPP ফ্রেমওয়ার্কের সাথে Google সম্মতি ব্যবস্থাপনা সমাধান ব্যবহার করা

আপনি যদি IAB GPP ফ্রেমওয়ার্কের অধীনে CPRA অপ্ট-আউট সংগ্রহ করতে Google সম্মতি ব্যবস্থাপনা সমাধান ব্যবহার করেন, তাহলে আপনার IAB GPP API ব্যবহার করা উচিত।

CPRA প্রবিধানের অপ্ট-আউট প্রকৃতির কারণে, আপনি হয় CONSENT_API_READY বা CONSENT_DATA_READY কলব্যাক সারি কী ব্যবহার করতে পারেন যাতে IAB GPP API কল করা যায় এবং কলব্যাক করার সময় সম্মতি ডেটা ফেরত দেওয়া হয়।

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {}
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  window.googlefc.callbackQueue.push({
    'CONSENT_DATA_READY':
    () => __uspapi('getUSPData', 1, (data, success) => {
      // Do something with consent data value.
    })
  });
</script>

একটি কাস্টম বিক্রি করবেন না লিঙ্ক সহ CPRA-এর জন্য IAB GPP ফ্রেমওয়ার্কের সাথে Google সম্মতি ব্যবস্থাপনা সমাধানগুলি ব্যবহার করা

আপনি যদি IAB GPP ফ্রেমওয়ার্কের অধীনে CPRA অপ্ট-আউট সংগ্রহ করতে Google সম্মতি ব্যবস্থাপনা সমাধানগুলি ব্যবহার করেন, তাহলে googlefc.ccpa.overrideDnsLink পতাকাকে true সেট করে একটি কাস্টম বিক্রি করবেন না লিঙ্ক প্রদান করা সম্ভব।

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {}
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Signals that the default DNS link will be overridden.
  window.googlefc.ccpa.overrideDnsLink = true;

  // Register the callback for the initial CPRA data.
  window.googlefc.callbackQueue.push({
      'INITIAL_CCPA_DATA_READY': () => {
        if (googlefc.ccpa.getInitialCcpaStatus() ===
            googlefc.ccpa.InitialCcpaStatusEnum.NOT_OPTED_OUT) {
          // TODO: Display custom CPRA Do Not Sell link here.
        }
      }
    });
</script>

এটি নিশ্চিত করে যে ডিফল্ট বিক্রি করবেন না লিঙ্কটি রেন্ডার হয় না। মনে রাখবেন যে আপনি CPRA-এর সাথে সঙ্গতিপূর্ণ হওয়ার জন্য আপনার নিজের বিক্রয় করবেন না লিঙ্কটি রেন্ডার করার জন্য দায়ী। তারপরে, আপনাকে CPRA নিশ্চিতকরণ ডায়ালগ দিয়ে আপনার কাস্টম Do not Sell লিঙ্কের সাথে ব্যবহারকারীর মিথস্ক্রিয়া পরিচালনা করতে হবে।

<script>
// This callback will be called with the user CPRA decision.
const ccpaCompletionCallback = (userOptedOut) => {
  if (userOptedOut) {
    // TODO: Hide custom CPRA Do Not Sell link here.
  }
}
// Invoke the CPRA confirmation dialog when the user clicks the link.
document.getElementById("your-custom-ccpa-do-not-sell-link").addEventListener(
  "click", () => googlefc.ccpa.openConfirmationDialog(ccpaCompletionCallback));
</script>

গোপনীয়তা & মেসেজিং জাভাস্ক্রিপ্ট API

ভূমিকা

ক্ষেত্রের সারাংশ

পদ্ধতির সারাংশ

আপনার সাইটে পরীক্ষা এবং ডিবাগিং

ক্ষেত্র: ব্যাখ্যা এবং উদাহরণ

পদ্ধতি: ব্যাখ্যা এবং উদাহরণ

GDPR-এর জন্য IAB TCF v2-এর সাথে Google সম্মতি ব্যবস্থাপনা সমাধান ব্যবহার করা

CPRA-এর জন্য IAB GPP ফ্রেমওয়ার্কের সাথে Google সম্মতি ব্যবস্থাপনা সমাধান ব্যবহার করা