หน้านี้ได้รับการแปลโดย Cloud Translation API

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

คำเตือน: Roku ไม่ได้รับรองแอปพลิเคชัน Roku ใหม่หรือที่มีอยู่สำหรับการเผยแพร่ ซึ่งใช้ PAL SDK ในปี 2025 เราคาดว่า Roku จะไม่รองรับ PAL SDK อีกต่อไป ซึ่งจะส่งผลต่อการสร้างรายได้ของคุณกับ Google เรากําลังพัฒนาทางเลือกสําหรับ Google Ad Manager เพื่อส่งสัญญาณการตรวจสอบที่จําเป็นต่อไปเพื่อระบุและขจัดกลโกง CTV หากสนใจที่จะเข้าร่วมโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้า

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

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

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

ข้อกำหนดสำหรับการแสดงผล AdChoices

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

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

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

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

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

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

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

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

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

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