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

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

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

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

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

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

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

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

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

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

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

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

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

ความกว้าง ความกว้างของรูปภาพทางเลือกในหน่วยพิกเซล
ความสูง ความสูงของรูปภาพทางเลือกในหน่วยพิกเซล
creative_type MIME Type ของรูปภาพทางเลือก ค่าเริ่มต้นคือ "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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}