AdChoices আইকন ও ওভারলে

Google হোস্ট করে এমন বিজ্ঞাপন দেখানো সব অ্যাপকে Google-এর দেওয়া AdChoices আইকন ও ওভারলে প্রয়োগ করতে হবে। AdChoices (এছাড়াও "এই বিজ্ঞাপন কেন?" নামে পরিচিত) হল একটি স্বচ্ছতা ফিচার যা ব্যবহারকারীদের ব্যাখ্যা করে যে কেন তাদের একটি নির্দিষ্ট বিজ্ঞাপন দেখানো হচ্ছে এবং তাদের গোপনীয়তা কীভাবে সুরক্ষিত রাখা হয় সেই সম্পর্কে তথ্য প্রদান করে। বিস্তারিত জানতে, Google Ad Manager-এর জন্য AdChoices দেখুন।

আরও তথ্যের জন্য, আপনি কেন বিজ্ঞাপন দেখছেন দেখুন।

এই নির্দেশিকা থেকে জানা যায় যে কীভাবে আপনার বিজ্ঞাপনের VAST XML রেসপন্স বা আপনার DAI স্ট্রিমের মেটাডেটা রেসপন্স থেকে AdChoices সঠিকভাবে প্রয়োগ করার জন্য প্রয়োজনীয় তথ্য এক্সট্র্যাক্ট করতে হয়।

AdChoices রেন্ডার করার জন্য প্রয়োজনীয়তা

AdChoices আইকন রেন্ডার করার জন্য Google-এর প্রয়োজনীয়তা মেনে চলতে, আপনার অ্যাপ বা ওয়েবসাইটকে নিম্নলিখিত মান পূরণ করতে হবে:

  1. AdChoices আইকনটি অবশ্যই সেইসব বিজ্ঞাপনের উপরে ওভারলে হিসেবে দেখাতে হবে যেগুলির জন্য এটি প্রদান করা হয়েছে
  2. আইকন ডেটাতে অন্তর্ভুক্ত "X location" এবং "Y location" প্রপার্টি দ্বারা নির্দেশিত অবস্থানে এবং Density-independent Pixels (DP)-এ প্রস্থ ও উচ্চতা প্রপার্টি দ্বারা নির্ধারিত সাইজে AdChoices আইকনটি অবশ্যই দেখাতে হবে।
  3. অন্যান্য বিজ্ঞাপন ওভারলে বা ইন্টারফেস এলিমেন্ট দিয়ে AdChoices আইকন আড়াল করা যাবে না।
  4. ক্লিক করার সুবিধা বা সমতুল্য সুবিধা (যেমন, টাচ বা রিমোট সিলেক্ট) আছে এমন প্ল্যাটফর্মে, AdChoices আইকনে ক্লিক করা যেতে হবে।
  5. ব্রাউজার সাপোর্ট করে এমন প্ল্যাটফর্মে, AdChoices আইকনে ক্লিক করলে "ClickThrough" বা "click_data" প্রপার্টিতে উল্লেখ করা URL সহ একটি ব্রাউজার ট্যাব বা উইন্ডো খুলতে হবে।
  6. ব্রাউজার কাজ করে না এমন প্ল্যাটফর্মে, AdChoices আইকনে ক্লিক করলে অবশ্যই একটি মডাল ওভারলে খুলতে হবে, যা "IconClickFallbackImage" বা "click_fallback_images" প্রপার্টিতে উল্লেখ করা ছবিগুলির মধ্যে একটি দেখাবে।
  7. যেসব প্ল্যাটফর্মে ব্রাউজার কাজ করে না, সেখানে ফলব্যাক ছবিকে অবশ্যই "IconClickFallbackImage" বা "click_fallback_images" প্রপার্টির মধ্যে নির্দিষ্ট করা সাইজে, ঘনত্ব-নিরপেক্ষ পিক্সেল (DP)-এ দেখাতে হবে।

VAST XML রেসপন্স থেকে AdChoices পার্স করা

XML বিজ্ঞাপন রেসপন্স নিয়ে কাজ করার সময়, AdChoices শুধুমাত্র VAST ভার্সন 3.0 ও তার পরবর্তী যেকোনও ভার্সনে কাজ করে। AdChoices একটি VAST আইকন হিসেবে প্রয়োগ করা হয়।

VAST 4.2

আপনার XML বিজ্ঞাপন রেসপন্স VAST 4.2 স্ট্যান্ডার্ড মেনে চললে, AdChoices একটি VAST আইকন হিসেবে ডেলিভার করা হয়। আপনার অ্যাপ বা ওয়েবসাইট যদি VAST 4.2 আইকন (VAST 4.2 স্ট্যান্ডার্ডের ৩.১১ বিভাগ) সম্পূর্ণভাবে সাপোর্ট করে, তাহলে AdChoices সাপোর্ট করার জন্য আর কোনও কাজ করতে হবে না।

আপনার অ্যাপ VAST 4.2 আইকন সাপোর্ট না করলে, আপনাকে VAST রেসপন্স থেকে "GoogleWhyThisAd" প্রোগ্রাম নামের সাথে আইকন ম্যানুয়ালি পার্স করতে হবে। এটি এই স্ট্যান্ডার্ডের উপর ভিত্তি করে করতে হবে। আপনার অ্যাপে অতিরিক্ত পরীক্ষার জন্য আপনি এই নমুনা VAST 4.2 xml ব্যবহার করতে পারেন।

VAST 4.2 উত্তরের নমুনা

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="4.2">
  <Ad id="20011">
    <Wrapper>
      ...
      <Creatives>
        ...
        <Creative id="5480" sequence="1">
          ...
          <Linear>
            ...
            <Icons>
              ...
              <Icon program="GoogleWhyThisAd" width="40" height="30" xPosition="left" yPosition="100" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="AdChoices icon">
                <StaticResource creativeType="image/png">
                  <![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png ]]>
                </StaticResource>
                <IconClicks>
                  <IconClickThrough>
                    <![CDATA[ https://g.co/adsettings ]]>
                  </IconClickThrough>
                  <IconClickFallbackImages>
                    <IconClickFallbackImage width="950" height="600">
                      <AltText>
                        <![CDATA[ This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing. ]]>
                      </AltText>
                      <StaticResource creativeType="image/png">
                        <![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png ]]>
                      </StaticResource>
                    </IconClickFallbackImage>
                    ...
                  </IconClickFallbackImages>
                </IconClicks>
              </Icon>
              ...
            </Icons>
            ...
          </Linear>
          ...
        </Creative>
        ...
      </Creatives>
      ...
    </Wrapper>
    ...
  </Ad>
</VAST>

VAST 3.0

আপনার XML বিজ্ঞাপন রেসপন্স VAST 3.0 স্ট্যান্ডার্ড মেনে চললে, AdChoices একটি VAST আইকন ও কাস্টম VAST এক্সটেনশনের সংমিশ্রণ হিসেবে ডেলিভার করা হয়। আপনার অ্যাপ বা ওয়েবসাইট VAST 3.0 আইকন স্ট্যান্ডার্ড সম্পূর্ণভাবে মেনে চললে এবং প্ল্যাটফর্ম যদি আইকন ক্লিকথ্রু URL-এ নেভিগেট করতে ও সেটি দেখাতে পারে, তাহলে AdChoices সাপোর্ট এর জন্য আর কোনও কাজ করতে হবে না।

আপনার প্ল্যাটফর্ম যদি ক্লিকথ্রু URL-এ নেভিগেট করতে ও তা দেখাতে না পারে—এটি মূলত সেইসব ডিভাইসের ক্ষেত্রে প্রযোজ্য যেগুলিতে ইন্টিগ্রেটেড ওয়েব ব্রাউজার নেই—আপনাকে অবশ্যই "IconFallbackImages" এক্সটেনশনের জন্য সহায়তা প্রয়োগ করতে হবে। এই এক্সটেনশনে "IconFallbackImages" ট্যাগের একটি সেট থাকে যেখানে "program" অ্যাট্রিবিউট VAST-এ অন্তর্ভুক্ত একটি আইকনের সাথে ম্যাচ করে।

AdChoices-কে সম্পূর্ণভাবে সাপোর্ট করতে, প্রোগ্রাম নাম "GoogleWhyThisAd" সহ IconFallbackImages ট্যাগকে প্রোগ্রাম নাম "GoogleWhyThisAd" সহ আইকনের সাথে যুক্ত থাকতে হবে, যাতে ব্যবহারকারী আইকনের সাথে ইন্টার‍্যাক্ট করলে, যুক্ত ফলব্যাক ছবি দেখানো হয়।

AdChoices স্ট্যান্ডার্ডে সম্ভাব্য ভবিষ্যতের পরিবর্তনকে সমর্থন করতে, উপলভ্য হলে, আমরা সমস্ত VAST আইকনের জন্য ফলব্যাক ইমেজ সাপোর্ট অন্তর্ভুক্ত করার জন্য অত্যন্ত সুপারিশ করি। আপনার অ্যাপে অতিরিক্ত পরীক্ষার জন্য আপনি এই নমুনা VAST 3.0 xml ব্যবহার করতে পারেন।

IconFallbackImages এক্সটেনশন স্ট্রাকচার

ট্যাগ করুন অ্যাট্রিবিউট বিবরণ
এক্সটেনশন ধরন এই এক্সটেনশনের জন্য, টাইপে সবসময় IconClickFallbackImages ভ্যালু থাকে।
-IconClickFallbackImages প্রোগ্রাম এই অ্যাট্রিবিউট সবসময় সংশ্লিষ্ট VAST 3.0 আইকনের প্রোগ্রাম অ্যাট্রিবিউটের সাথে ম্যাচ করে।
এই নোডের স্ট্রাকচারটি VAST 4.2 স্ট্যান্ডার্ডের IconClickFallbackImages-এর সাথে মেলে, তবে program অ্যাট্রিবিউট যোগ করা হয়েছে।
--IconClickFallbackImage প্রস্থ ছবি দেখানোর জন্য পছন্দের প্রস্থ।
উচ্চতা ছবি দেখানোর জন্য পছন্দসই উচ্চতা।
---AltText ছবির অ্যাক্সেসিবল বিবরণ।
---StaticResource creativeType ফলব্যাক ছবির mime-টাইপ।
ফলব্যাক ছবির URL সহ CDATA ভ্যালু।

VAST 3.0 উত্তরের নমুনা

<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
 <Ad id="123456">
  <InLine>
   ...
   <Creatives>
    ...
    <Creative id="7891011" AdID="ABCD123456EF" sequence="1">
     ...
     <Linear>
      ...
      <Icons>
       ...
       <Icon program="GoogleWhyThisAd" width="50" height="50" xPosition="20" yPosition="bottom" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="Why This Ad?">
        <StaticResource creativeType="image/png">
         <![CDATA[https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png]]>
        </StaticResource>
        <IconClicks>
         ...
         <IconClickThrough><![CDATA[https://g.co/adsettings]]></IconClickThrough>
        </IconClicks>
       </Icon>
       ...
      </Icons>
     ...
     </Linear>
     ...
    </Creative>
    ...
   </Creatives>
   <Extensions>
    ...
    <Extension type="IconClickFallbackImages">
     ...
     <IconClickFallbackImages program="GoogleWhyThisAd">
      <IconClickFallbackImage width="400" height="150">
       <AltText>Alt icon fallback</AltText>
       <StaticResource creativeType="image/png"><![CDATA[https://storage.googleapis.com/gvabox/nickchavez/media/png/wta_dialog.png]]></StaticResource>
      </IconClickFallbackImage>
      ...
     </IconClickFallbackImages>
     ...
    </Extension>
    ...
   </Extensions>
   ...
  </InLine>
  ...
 </Ad>
</VAST>

DAI API মেটাডেটা JSON থেকে AdChoices পার্স করা

DAI API-এর সাথে কাজ করার সময়, AdChoices সংক্রান্ত বিবরণ metadata URL-এ করা অনুরোধের মাধ্যমে ফিরে আসা JSON অবজেক্টের মধ্যে দিয়ে পাস করা হয়।

Metadata JSON অবজেক্টে adID দ্বারা কী করা বিজ্ঞাপনের একটি তালিকা থাকে। প্রতিটি বিজ্ঞাপন অবজেক্টের মধ্যে আইকনের অ্যারে থাকে। আলোচ্য বিজ্ঞাপনটি AdChoices ব্যবহার করলে, সেই অ্যারেতে AdChoices আইকন থাকে।

JSON আইকন ফর্ম্যাট

JSON আইকন ফর্ম্যাট হল VAST 4.2 আইকন স্ট্যান্ডার্ড (বিভাগ 3.11) থেকে ১:১ অনুবাদ, যেখানে সম্ভব। তবে, আরও কঠোর JSON ফর্ম্যাটকে সমর্থন করার জন্য, যেখানে প্রয়োজন সেখানে কিছু অ্যাট্রিবিউটের নাম পরিবর্তন করা হয়েছে।

আইকন JSON ফর্ম্যাট

প্রোগ্রাম AdChoices আইকনের জন্য, এই ভ্যালুতে সবসময় "GoogleWhyThisAd" স্ট্রিং থাকে।
x_position ভিডিও ক্রিয়েটিভের উপরে বাঁদিকের কোণের সাপেক্ষে আইকনের উপরে বাঁদিকের কোণের আনুভূমিক পজিশন, পিক্সেলে। এছাড়াও, এই ফিল্ডে রেসপন্সিভ পজিশন ভ্যালু "ডানদিকে" বা "বাঁদিকে" লেখা যায়।
y_position ভিডিও ক্রিয়েটিভের উপরে বাঁদিকের কোণের সাপেক্ষে আইকনের উপরে বাঁদিকের কোণের ভার্টিক্যাল পজিশন, পিক্সেলে। এছাড়াও, এই ফিল্ডে রেসপন্সিভ পজিশন ভ্যালু "top" বা "bottom" লেখা যায়।
প্রস্থ পিক্সেলে আইকনের প্রস্থ।
উচ্চতা পিক্সেলে আইকনের দৈর্ঘ্য।
creative_type আইকনের জন্য দেওয়া ছবির মাইমটাইপ। ডিফল্ট হিসেবে "image/png" থাকে।
রিসোর্স AdChoices আইকন পাওয়ার URL.
alt_text AdChoices আইকনের জন্য রেন্ডার করা অল্টারনেট টেক্সট।
click_data এমন একটি অবজেক্ট যাতে click_data.url প্রপার্টি আছে, যা ওয়েব ব্রাউজিং কাজ করে এমন কোনও প্ল্যাটফর্মে AdChoices আইকনে ক্লিক করলে দর্শকদের যে URL-এ ডাইরেক্ট করা হবে সেটি দেখায়।
click_fallback_images ওয়েব ব্রাউজিং কাজ করে না এমন প্ল্যাটফর্মে AdChoices আইকনে ক্লিক করা দর্শকদের দেখানোর জন্য ছবির অবজেক্টের একটি অ্যারে।

ফলব্যাক ছবির JSON ফর্ম্যাট

প্রস্থ ফলব্যাক ছবির প্রস্থ, পিক্সেলে।
উচ্চতা ফলব্যাক ছবির উচ্চতা, পিক্সেলে।
creative_type ফলব্যাক ছবির mime-টাইপ। ডিফল্ট হিসেবে "image/png" থাকে।
রিসোর্স ফলব্যাক ছবি ফিরিয়ে আনার URL.
alt_text ফলব্যাক ছবির জন্য রেন্ডার করার বিকল্প টেক্সট।

স্যাম্পেল মেটাডেটা JSON

{
  ...
  "ads": {
    ...
    "0002640412_ad1": {
      ...
      "icons": [
        ...
        {
          "alt_text": "AdChoices icon",
          "click_data": {
            "url": "https://g.co/adsettings"
          },
          "click_fallback_images": [
            {
              "alt_text": "This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing.",
              "creative_type": "image/jpg",
              "height": 600,
              "resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png",
              "width": 950
            }
          ],
          "creative_type": "image/png",
          "height": 30,
          "program": "AdChoices",
          "resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png",
          "type": "static",
          "width": 40,
          "x_position": "0",
          "y_position": "100"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}