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

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

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

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

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

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

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

একটি 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 স্ট্যান্ডার্ডের বিভাগ 3.11), 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" ট্যাগের একটি সেট রয়েছে যেখানে "প্রোগ্রাম" বৈশিষ্ট্যটি VAST-এ অন্তর্ভুক্ত একটি আইকনের সাথে মেলে৷

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

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

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

ট্যাগ গুণাবলী বর্ণনা
এক্সটেনশন প্রকার এই এক্সটেনশনের জন্য, প্রকারে সর্বদা IconClickFallbackImages মান থাকে।
-IconClickFallbackImages কার্যক্রম এই বৈশিষ্ট্যটি সর্বদা একটি সম্পর্কিত VAST 3.0 আইকনের প্রোগ্রাম বৈশিষ্ট্যের সাথে মেলে।
এই নোডের গঠন IconClickFallbackImages-এর জন্য VAST 4.2 স্ট্যান্ডার্ডের সাথে মেলে, program অ্যাট্রিবিউট যোগ করা ছাড়া।
--IconClickFallbackImage প্রস্থ ছবি প্রদর্শনের জন্য পছন্দের প্রস্থ।
উচ্চতা ছবি প্রদর্শনের জন্য পছন্দের উচ্চতা।
---বিকল্প পাঠ ছবির একটি অ্যাক্সেসযোগ্য বর্ণনা।
--- স্ট্যাটিক রিসোর্স সৃজনশীল প্রকার ফলব্যাক ছবির মাইমেটাইপ।
ফলব্যাক চিত্রের 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 বিশদ JSON অবজেক্টের মাধ্যমে পাস করা হয় যা মেটাডেটা URL- এ অনুরোধের মাধ্যমে ফেরত দেওয়া হয়।

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

JSON আইকন বিন্যাস

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

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

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

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

প্রস্থ ফলব্যাক ছবির প্রস্থ, পিক্সেলে।
উচ্চতা ফলব্যাক ছবির উচ্চতা, পিক্সেলে।
ক্রিয়েটিভ_টাইপ ফলব্যাক ছবির মাইমেটাইপ। ডিফল্ট "ইমেজ/পিএনজি"।
সম্পদ ফলব্যাক ছবি পুনরুদ্ধার করার URL।
বিকল্প পাঠ ফলব্যাক চিত্রের জন্য রেন্ডার করার জন্য Alt পাঠ্য।

নমুনা মেটাডেটা 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}