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

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

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

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

ข้อกำหนดสำหรับการแสดงผลตัวเลือกโฆษณาอื่นๆ

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

VAST 4.2

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

หากแอปไม่รองรับไอคอน VAST 4.2 คุณจะต้องแยกวิเคราะห์ไอคอนด้วยตนเอง โดยใช้ชื่อโปรแกรม "GoogleWhyThisAd" จากการตอบกลับด้วย VAST ตามมาตรฐานดังกล่าว คุณใช้ XML ของ VAST 4.2 ตัวอย่างนี้ เพื่อทดสอบเพิ่มเติมในแอปได้

ตัวอย่างการตอบกลับด้วย 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 ที่คลิกผ่านได้ (ซึ่งส่วนใหญ่จะมีผลกับอุปกรณ์ที่ไม่มีเว็บเบราว์เซอร์ในตัว) คุณต้องรองรับส่วนขยาย "IconFallbackImages" ส่วนขยายนี้มีชุดแท็ก "IconFallbackImages" ซึ่งแอตทริบิวต์ "program" ตรงกับไอคอนที่รวมอยู่ใน VAST

หากต้องการรองรับ AdChoices อย่างเต็มรูปแบบ แท็ก 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 ที่คำขอส่งคืนไปยัง URL ข้อมูลเมตา

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

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

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

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

โปรแกรม สำหรับไอคอนตัวเลือกโฆษณาอื่นๆ ค่านี้จะมีสตริง "GoogleWhyThisAd" เสมอ
x_position ตำแหน่งแนวนอนของมุมซ้ายบนของไอคอนเทียบกับมุมซ้ายบนของครีเอทีฟโฆษณาวิดีโอเป็นพิกเซล ฟิลด์นี้ยังยอมรับค่าตำแหน่งที่ปรับตามพื้นที่โฆษณา "ขวา" หรือ "ซ้าย" ด้วย
y_position ตำแหน่งแนวตั้งของมุมซ้ายบนของไอคอนเทียบกับ มุมซ้ายบนของครีเอทีฟโฆษณาวิดีโอเป็นพิกเซล ฟิลด์นี้ยังยอมรับค่าตำแหน่งที่ปรับเปลี่ยนตามพื้นที่โฆษณา "top" หรือ "bottom" ด้วย
ความกว้าง ความกว้างของไอคอนเป็นพิกเซล
ความสูง ความสูงของไอคอนเป็นพิกเซล
creative_type MIME ประเภทของรูปภาพที่ระบุสำหรับไอคอน ค่าเริ่มต้นคือ "image/png"
แหล่งข้อมูล URL สำหรับดึงไอคอนตัวเลือกโฆษณาอื่นๆ
alt_text ข้อความแสดงแทนที่จะแสดงผลสำหรับไอคอนตัวเลือกโฆษณาอื่นๆ
click_data ออบเจ็กต์ที่มีพร็อพเพอร์ตี้ click_data.url ซึ่ง แสดงถึง 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}