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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ทำไมคุณจึงเห็น โฆษณา

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

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

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

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

โครงสร้างส่วนขยาย 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 ในองค์ประกอบแต่ละอย่าง เป็นอาร์เรย์ไอคอน หากโฆษณาที่เป็นปัญหาใช้ตัวเลือกโฆษณาอื่นๆ ไอคอนตัวเลือกโฆษณาอื่นๆ อยู่ในอาร์เรย์นั้น

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

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

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

โปรแกรม สำหรับไอคอนตัวเลือกโฆษณาอื่นๆ ค่านี้จะมีสตริง "GoogleWhyThisAd" เสมอ
x_position ตำแหน่งแนวนอนของมุมซ้ายบนของไอคอนเมื่อเทียบกับ มุมซ้ายบนของครีเอทีฟโฆษณาวิดีโอเป็นพิกเซล ฟิลด์นี้ยังยอมรับ ค่าตำแหน่งที่ปรับเปลี่ยนตามอุปกรณ์ "right" หรือ "ซ้าย"
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}