AdChoices আইকন এবং ওভারলে

যেসব অ্যাপ গুগল দ্বারা হোস্ট করা ব্যক্তিগতকৃত বিজ্ঞাপন প্রদর্শন করে, গুগল কর্তৃক প্রদত্ত হলে সেগুলোকে অবশ্যই AdChoices আইকন এবং ওভারলে প্রয়োগ করতে হবে। AdChoices (যা 'Why this Ad?' নামেও পরিচিত) হলো একটি স্বচ্ছতা বৈশিষ্ট্য, যা ব্যবহারকারীদের কাছে ব্যাখ্যা করে যে কেন তাদের একটি নির্দিষ্ট বিজ্ঞাপন দেখানো হচ্ছে এবং তাদের গোপনীয়তা কীভাবে সুরক্ষিত রাখা হয় সে সম্পর্কে তথ্য প্রদান করে।

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

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

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

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

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

একটি বিশাল XML প্রতিক্রিয়া থেকে AdChoices পার্স করুন

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

ভাস্ট ৪.২

যদি আপনার 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>

ভাস্ট ৩.০

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

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

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

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

আইকনফলব্যাকইমেজ এক্সটেনশন কাঠামো

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

নমুনা 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 ব্যবহার করার সময়, মেটাডেটা URL- এ করা অনুরোধের মাধ্যমে প্রাপ্ত JSON অবজেক্টের মধ্য দিয়ে AdChoices-এর বিবরণ পাঠানো হয়।

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

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

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

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

প্রোগ্রাম AdChoices আইকনের ক্ষেত্রে, এই মানটিতে সর্বদা "GoogleWhyThisAd" স্ট্রিংটি থাকে।
x_অবস্থান ভিডিও ক্রিয়েটিভের উপরের বাম কোণার সাপেক্ষে, আইকনের উপরের বাম কোণার আনুভূমিক অবস্থান, পিক্সেলে পরিমাপ করা। এই ফিল্ডটি 'right' বা 'left' রেসপন্সিভ পজিশন ভ্যালুগুলোও গ্রহণ করে।
y_অবস্থান ভিডিও ক্রিয়েটিভের উপরের বাম কোণার সাপেক্ষে, আইকনের উপরের বাম কোণার উল্লম্ব অবস্থান, পিক্সেলে পরিমাপ করা হয়। এই ফিল্ডটি 'top' বা 'bottom' রেসপন্সিভ পজিশন ভ্যালুও গ্রহণ করে।
প্রস্থ আইকনটির প্রস্থ, পিক্সেলে।
উচ্চতা আইকনটির উচ্চতা, পিক্সেলে।
সৃজনশীল_ধরণ আইকনের জন্য প্রদত্ত ইমেজের মাইমটাইপ। ডিফল্ট হলো 'image/png'।
সম্পদ AdChoices আইকনটি পাওয়ার জন্য URL।
alt_text AdChoices আইকনের জন্য প্রদর্শিতব্য অল্টারনেটিভ টেক্সট।
ক্লিক_ডেটা একটি অবজেক্ট, যার মধ্যে click_data.url নামক একটি প্রপার্টি রয়েছে, যা সেই URL-টিকে নির্দেশ করে যেখানে ওয়েব ব্রাউজিং সমর্থনকারী কোনো প্ল্যাটফর্মে দর্শকরা AdChoices আইকনে ক্লিক করলে তাদের পাঠানো হবে।
ক্লিক_ফলব্যাক_ছবি যেসব প্ল্যাটফর্মে ওয়েব ব্রাউজিং সমর্থিত নয়, সেখানে AdChoices আইকনে ক্লিক করলে দর্শকদের দেখানোর জন্য ইমেজ অবজেক্টের একটি অ্যারে।

ফলব্যাক ইমেজ JSON ফরম্যাট

প্রস্থ ফলব্যাক ইমেজের প্রস্থ, পিক্সেল এককে।
উচ্চতা ফলব্যাক ইমেজটির উচ্চতা, পিক্সেল এককে।
সৃজনশীল_ধরণ ফলব্যাক ইমেজের মাইমটাইপ। ডিফল্ট মান হলো 'image/png'।
সম্পদ ফলব্যাক ইমেজটি পুনরুদ্ধার করার জন্য ইউআরএল।
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}