ไอคอนตัวเลือกโฆษณาอื่นๆ และการวางซ้อน

แอปทั้งหมดที่แสดงโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ซึ่งโฮสต์โดย Google ต้องใช้ไอคอนและการวางซ้อนตัวเลือกโฆษณาอื่นๆ (หากมีให้โดย Google) ตัวเลือกโฆษณาอื่นๆ (หรือเรียกว่า "ทำไมจึงแสดงโฆษณานี้") เป็นฟีเจอร์ความโปร่งใสที่อธิบายให้ผู้ใช้เห็นว่าทำไมผู้ใช้จึงเห็น โฆษณาบางรายการและให้ข้อมูลเกี่ยวกับวิธีการปกป้องความเป็นส่วนตัวของโฆษณา

ดูข้อมูลเพิ่มเติมได้ที่สาเหตุที่คุณเห็นโฆษณา

คู่มือนี้จะอธิบายวิธีดึงข้อมูลที่จำเป็นเพื่อติดตั้งใช้งานตัวเลือกโฆษณาอย่างถูกต้องจากการตอบกลับ VAST XML ของโฆษณาหรือการตอบกลับข้อมูลเมตาของสตรีม DAI

ข้อกำหนดสำหรับการแสดงผล AdChoices

เพื่อให้สอดคล้องกับข้อกำหนดของ Google ในการแสดงไอคอนตัวเลือกโฆษณาอื่นๆ แอปของคุณ หรือ เว็บไซต์ต้องเป็นไปตามมาตรฐานต่อไปนี้

  1. ไอคอนตัวเลือกโฆษณาอื่นๆ ต้องแสดงซ้อนทับโฆษณาที่มี
  2. ไอคอนตัวเลือกโฆษณาอื่นๆ ต้องแสดงในตำแหน่งที่ระบุโดยพร็อพเพอร์ตี้ "ตำแหน่ง X" และ "ตำแหน่ง Y" ที่รวมอยู่ในข้อมูลไอคอน และมีขนาดที่กําหนดโดยพร็อพเพอร์ตี้ความกว้างและความสูงในพิกเซลที่ไม่ขึ้นกับความละเอียด (DP)
  3. ไอคอนตัวเลือกโฆษณาต้องไม่ถูกบดบังโดยโฆษณาซ้อนทับอื่นๆ หรือองค์ประกอบอินเทอร์เฟซ
  4. ในแพลตฟอร์มที่รองรับการคลิกหรือเทียบเท่า (เช่น การแตะหรือเลือกจากระยะไกล) ไอคอนตัวเลือกโฆษณาอื่นๆ ต้องคลิกได้
  5. ในแพลตฟอร์มที่รองรับเบราว์เซอร์ การคลิกไอคอนตัวเลือกโฆษณาอื่นๆ จะต้องเปิดแท็บหรือหน้าต่างเบราว์เซอร์ที่มี URL ที่ระบุไว้ในพร็อพเพอร์ตี้ "ClickThrough" หรือ "click_data"
  6. ในแพลตฟอร์มที่ไม่รองรับเบราว์เซอร์ การคลิกไอคอนตัวเลือกโฆษณาอื่นๆ จะต้องเปิด การซ้อนทับแบบโมดัล โดยแสดงรูปภาพใดรูปหนึ่งที่ระบุใน "IconClickFallbackImage" หรือ "click_fallback_images"
  7. บนแพลตฟอร์มที่ไม่รองรับเบราว์เซอร์ รูปภาพสำรองต้องแสดงที่ ขนาดที่ระบุภายใน "IconClickFallbackImage" หรือ "click_fallback_images" (รูปภาพสำรอง) ในพิกเซล (DP) ที่ไม่ขึ้นกับความหนาแน่น

แยกวิเคราะห์ตัวเลือกโฆษณาอื่นๆ จากการตอบสนองด้วย VAST XML

เมื่อดำเนินการกับการตอบกลับโฆษณา XML ระบบจะรองรับตัวเลือกโฆษณาอื่นๆ ใน VAST เท่านั้น เวอร์ชัน 3.0 ขึ้นไป ตัวเลือกโฆษณาอื่นๆ มีการใช้งานเป็นไอคอน VAST

VAST 4.2

หากการตอบกลับโฆษณา XML เป็นไปตาม VAST 4.2 มาตรฐาน ตัวเลือกโฆษณาอื่นๆ แสดงเป็นไอคอน VAST หากแอปหรือเว็บไซต์รองรับไอคอน VAST 4.2 อย่างเต็มรูปแบบ (ส่วนที่ 3.11 ของมาตรฐาน VAST 4.2) ก็ไม่จําเป็นต้องดําเนินการใดๆ เพิ่มเติมเพื่อรองรับ AdChoices

หากแอปไม่รองรับไอคอน VAST 4.2 คุณจะต้องแยกวิเคราะห์ไอคอนด้วยตนเองโดยใช้ชื่อโปรแกรม "GoogleWhyThisAd" จากการตอบกลับ VAST โดยอิงตามมาตรฐานดังกล่าว คุณใช้ตัวอย่าง 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 มาตรฐาน ตัวเลือกโฆษณาอื่นๆ คือ แสดงเป็นชุดค่าผสมระหว่างไอคอน VAST และส่วนขยาย VAST ที่กำหนดเอง หากแอปหรือเว็บไซต์รองรับมาตรฐานไอคอน VAST 3.0 อย่างเต็มรูปแบบ และหากแพลตฟอร์มสามารถไปยังและแสดง URL การคลิกผ่านไอคอนได้ คุณจะไม่ต้องดำเนินการใดๆ เพิ่มเติมเพื่อรองรับตัวเลือกโฆษณาอื่นๆ

หากแพลตฟอร์มของคุณไปยัง URL ที่จะคลิกผ่านและแสดง URL ดังกล่าวไม่ได้ ซึ่งส่วนใหญ่จะเกี่ยวข้องกับอุปกรณ์ที่ไม่มีเว็บเบราว์เซอร์แบบรวมไว้ คุณต้องรองรับส่วนขยาย "IconFallbackImages" ส่วนขยายนี้มีชุดแท็ก "IconFallbackImages" ที่แอตทริบิวต์ "program" ตรงกับไอคอนที่รวมอยู่ใน VAST

หากต้องการรองรับตัวเลือกโฆษณาอื่นๆ อย่างเต็มรูปแบบ แท็ก IconFallbackImages ที่มีชื่อโปรแกรมเป็น "GoogleWhyThisAd" ต้องเชื่อมโยงกับไอคอนที่มีชื่อโปรแกรมเป็น "GoogleWhyThisAd" เพื่อให้รูปภาพทางเลือกที่เชื่อมโยงแสดงขึ้นเมื่อผู้ใช้โต้ตอบกับไอคอน

เพื่อรองรับการเปลี่ยนแปลงมาตรฐานตัวเลือกโฆษณาอื่นๆ ที่อาจเกิดขึ้นในอนาคต เราจึง ขอแนะนำให้รวมการสนับสนุนรูปภาพสำรองสำหรับไอคอน VAST ทั้งหมดเมื่อ พร้อมใช้งาน คุณสามารถใช้ตัวอย่าง VAST 3.0 xml นี้เพื่อทดสอบเพิ่มเติมในแอป

โครงสร้างส่วนขยาย IconFallbackImages

แท็ก Attributes คำอธิบาย
ส่วนขยาย ประเภท สำหรับส่วนขยายนี้ ประเภทจะมีค่าเสมอ IconClickFallbackImages
-IconClickFallbackImages โปรแกรม แอตทริบิวต์นี้ตรงกับแอตทริบิวต์โปรแกรมของ VAST ที่เชื่อมโยงเสมอ ไอคอน 3.0
โครงสร้างของโหนดนี้ตรงกับมาตรฐาน VAST 4.2 สำหรับ IconClickFallbackImages ยกเว้นการเพิ่ม program
--IconClickFallbackImage ความกว้าง ความกว้างที่ต้องการแสดงรูปภาพ
ส่วนสูง ความสูงที่ต้องการแสดงรูปภาพ
---AltText คำอธิบายรูปภาพที่เข้าถึงได้
---StaticResource creativeType ประเภท MIME ของรูปภาพทางเลือก
ค่า 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>

แยกวิเคราะห์ AdChoices จาก JSON ข้อมูลเมตาของ DAI API

เมื่อทํางานกับ DAI API ระบบจะส่งรายละเอียด AdChoices ผ่านออบเจ็กต์ JSON ที่ส่งคืนโดยคําขอไปยัง metadata URL

ออบเจ็กต์ JSON ของข้อมูลเมตามีรายการโฆษณา โดยคีย์คือรหัสโฆษณา ในองค์ประกอบแต่ละอย่าง เป็นอาร์เรย์ไอคอน หากโฆษณาที่เป็นปัญหาใช้ AdChoices ไอคอน AdChoices จะอยู่ในอาร์เรย์นั้น

รูปแบบไอคอน JSON

รูปแบบไอคอน JSON เป็นการแปลแบบ 1:1 จากไอคอน VAST 4.2 มาตรฐาน (ส่วนที่ 3.11) หากเป็นไปได้ อย่างไรก็ตาม เราได้เปลี่ยนชื่อแอตทริบิวต์บางรายการตามความจําเป็นเพื่อรองรับรูปแบบ JSON ที่เข้มงวดมากขึ้น

รูปแบบไอคอน JSON

โปรแกรม สำหรับไอคอนตัวเลือกโฆษณาอื่นๆ ค่านี้จะมีสตริง "GoogleWhyThisAd" เสมอ
x_position ตำแหน่งแนวนอนของมุมซ้ายบนของไอคอนที่สัมพันธ์กับมุมซ้ายบนของครีเอทีฟโฆษณาวิดีโอเป็นพิกเซล ช่องนี้ยังยอมรับค่าตำแหน่งที่ตอบสนองได้อีกด้วย ซึ่งได้แก่ "right" หรือ "left"
y_position ตำแหน่งแนวตั้งของมุมซ้ายบนของไอคอนที่สัมพันธ์กับ มุมซ้ายบนของครีเอทีฟโฆษณาวิดีโอ หน่วยเป็นพิกเซล ฟิลด์นี้ยอมรับฟิลด์ ค่าตำแหน่งที่ปรับเปลี่ยนตามอุปกรณ์ "ด้านบน" หรือ "ด้านล่าง"
ความกว้าง ความกว้างของไอคอนในหน่วยพิกเซล
ส่วนสูง ความสูงของไอคอนในหน่วยพิกเซล
creative_type ประเภท MIME ของรูปภาพที่ระบุสำหรับไอคอน ค่าเริ่มต้นคือ "image/png"
แหล่งข้อมูล URL สำหรับเรียกไอคอนตัวเลือกโฆษณาอื่นๆ
ข้อความสำรอง ข้อความแสดงแทนที่จะแสดงสำหรับไอคอนตัวเลือกโฆษณาอื่นๆ
click_data ออบเจ็กต์ที่มีพร็อพเพอร์ตี้ click_data.url ซึ่ง ซึ่งเป็น URL ที่จะนำผู้ชมไป หากคลิกไอคอนตัวเลือกโฆษณาอื่นๆ แพลตฟอร์มที่รองรับการท่องเว็บ
click_fallback_images อาร์เรย์ของออบเจ็กต์รูปภาพที่จะแสดงต่อผู้ชมที่คลิกตัวเลือกโฆษณาอื่นๆ ไอคอนบนแพลตฟอร์มที่ไม่รองรับการท่องเว็บ

รูปแบบ JSON ของรูปภาพทางเลือก

ความกว้าง ความกว้างของรูปภาพสำรองในหน่วยพิกเซล
ส่วนสูง ความสูงของรูปภาพสำรองในหน่วยพิกเซล
creative_type ประเภท MIME ของรูปภาพทางเลือก ค่าเริ่มต้นคือ "image/png"
แหล่งข้อมูล URL ที่ใช้ดึงข้อมูลรูปภาพสำรอง
ข้อความสำรอง ข้อความแสดงแทนที่จะแสดงผลสำหรับรูปภาพสำรอง

ตัวอย่างข้อมูลเมตา 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}