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

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

หากแอปไม่รองรับไอคอน 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 ทั้งหมด (หากมี) เพื่อรองรับการเปลี่ยนแปลงมาตรฐาน AdChoices ที่อาจเกิดขึ้นในอนาคต คุณใช้ตัวอย่างนี้ 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>

แยกวิเคราะห์ตัวเลือกโฆษณาอื่นๆ จากข้อมูลเมตา JSON ของ DAI API

เมื่อทำงานกับ DAI API รายละเอียดของตัวเลือกโฆษณาอื่นๆ มีดังนี้ ผ่านออบเจ็กต์ JSON ที่ส่งคืนโดยคำขอไปยังข้อมูลเมตา URL

ออบเจ็กต์ JSON ของข้อมูลเมตามีรายการโฆษณาที่รวมตาม adID ภายในออบเจ็กต์โฆษณาแต่ละรายการคืออาร์เรย์ไอคอน หากโฆษณาที่เป็นปัญหาใช้ 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 อาร์เรย์ของออบเจ็กต์รูปภาพที่จะแสดงต่อผู้ชมที่คลิกไอคอน AdChoices ในแพลตฟอร์มที่ไม่รองรับการท่องเว็บ

รูปแบบ 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}