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

ভূমিকা

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

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

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

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

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

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

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

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

নাম টাইপ সংজ্ঞা
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) কোনো বার্তাকে পেজভিউ দেখাতে বাধা দেয়।

উদাহরণ: অনুমান করুন যে আপনার পৃষ্ঠায় এই স্ক্রিপ্টটি রয়েছে যা একটি অ্যাসিঙ্ক ফাংশন নির্ধারণ করে 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 । আজকে সমর্থিত একমাত্র enum হল OFFERWALL , কিন্তু ভবিষ্যতে অতিরিক্ত বার্তা প্রকার যোগ করা হতে পারে৷

উদাহরণ: ধরে নিন উপরের মত আপনার কাছে একই determineIfUserIsSubscriber() ফাংশন আছে। এটি অন্যান্য বার্তার ধরনকে দমন না করে শুধুমাত্র গ্রাহকদের জন্য অফারওয়াল পরিবেশন দমন করতে 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>

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 ) এ কল করে প্রাপ্ত করা উচিত। মধ্যম

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>}

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

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' কমান্ডের সাথে ব্যবহার করা উচিত কারণ সিঙ্ক্রোনাস '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_API_READY key on the callbackQueue.
  window.googlefc.callbackQueue.push({
    'CONSENT_API_READY':
    () => __tcfapi('addEventListener', 2.0, (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 ব্যবহার করে ব্যবহারকারীর সম্মতি সংগ্রহ করা এবং অ্যাক্সেসযোগ্য হলেই সংশ্লিষ্ট কলব্যাকগুলি আহ্বান করা হয়েছে তা নিশ্চিত করতে কলব্যাক সারি কী। এটি '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('getTCData', 2.0, (data, success) => {
      // Do something with consent data value.
    })
  });
</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>