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

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

โครงสร้างส่วนขยายไอคอนสำรอง

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

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

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

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

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

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