همه برنامههایی که آگهیهای شخصیسازیشده میزبانشده توسط Google را نمایش میدهند، باید نماد و پوشش AdChoices را در صورت ارائه توسط Google پیادهسازی کنند. AdChoices (همچنین به عنوان «چرا این آگهی؟» نامیده میشود) یک ویژگی شفافسازی است که به کاربران توضیح میدهد چرا یک آگهی خاص به آنها نشان داده میشود و اطلاعاتی درباره نحوه محافظت از حریم خصوصی آنها ارائه میدهد.
برای اطلاعات بیشتر، به چرایی مشاهده آگهی مراجعه کنید.
این راهنما نحوه استخراج اطلاعات لازم برای اجرای صحیح AdChoices را از پاسخ VAST XML تبلیغ یا پاسخ فراداده جریان DAI شما توضیح می دهد.
الزامات برای رندر AdChoices
برای مطابقت با الزامات Google برای ارائه نمادهای AdChoices، برنامه یا وب سایت شما باید استانداردهای زیر را داشته باشد:
- نماد AdChoices باید روی هر تبلیغی که برای آن ارائه شده است نمایش داده شود
- نماد AdChoices باید در موقعیتی که با ویژگیهای "X location" و "Y location" در دادههای نماد مشخص شده است، و در اندازه مشخص شده توسط ویژگیهای عرض و ارتفاع، در پیکسلهای مستقل از چگالی (DP) نمایش داده شود.
- نماد AdChoices نباید توسط دیگر پوششهای تبلیغاتی یا عناصر رابط پنهان شود.
- در پلتفرمهایی با پشتیبانی از کلیک یا معادل آن (مثلاً انتخاب با لمس یا از راه دور)، نماد AdChoices باید قابل کلیک باشد.
- در پلتفرمهایی که از مرورگر پشتیبانی میکنند، با کلیک کردن روی نماد AdChoices باید یک برگه یا پنجره مرورگر با URL مشخص شده در ویژگی «ClickThrough» یا «click_data» باز شود.
- در پلتفرمهایی که از مرورگر پشتیبانی نمیکنند، با کلیک کردن روی نماد AdChoices باید یک پوشش مودال باز شود و یکی از تصاویر مشخصشده در ویژگی «IconClickFallbackImage» یا «click_fallback_images» نمایش داده شود.
- در پلتفرمهایی که از مرورگر پشتیبانی نمیکنند، تصویر بازگشتی باید در اندازه مشخصشده در ویژگی «IconClickFallbackImage» یا «click_fallback_images» در پیکسلهای مستقل از چگالی (DP) نمایش داده شود.
AdChoices را از یک پاسخ VAST XML تجزیه کنید
هنگام کار با یک پاسخ تبلیغ XML، AdChoices فقط در VAST نسخه 3.0 و جدیدتر پشتیبانی می شود. AdChoices به عنوان یک نماد VAST پیاده سازی شده است.
VAST 4.2
اگر پاسخ تبلیغ XML شما از استاندارد VAST 4.2 پیروی می کند، AdChoices به عنوان نماد 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 پیروی کند، AdChoices به صورت ترکیبی از نماد VAST و یک برنامه افزودنی VAST سفارشی ارائه میشود. اگر برنامه یا وبسایت شما بهطور کامل از استاندارد VAST 3.0 Icon پشتیبانی میکند و اگر پلتفرم قادر به پیمایش و نمایش نشانی اینترنتی کلیک از طریق نماد است، پشتیبانی AdChoices نیازی به کار بیشتری ندارد.
اگر پلتفرم شما قادر به پیمایش و نمایش URL های کلیکی نیست - این در درجه اول برای دستگاه هایی اعمال می شود که مرورگر وب یکپارچه ندارند - باید از پسوند "IconFallbackImages" پشتیبانی کنید. این برنامه افزودنی حاوی مجموعهای از برچسبهای "IconFallbackImages" است که ویژگی "برنامه" با نمادی که در VAST گنجانده شده است مطابقت دارد.
برای پشتیبانی کامل از AdChoices، تگ IconFallbackImages با نام برنامه "GoogleWhyThisAd" باید با نماد با نام برنامه "GoogleWhyThisAd" مرتبط شود، به طوری که وقتی کاربر با نماد تعامل می کند، تصویر بازگشتی مرتبط نمایش داده شود.
برای پشتیبانی از تغییرات احتمالی آینده در استاندارد AdChoices، ما به شدت توصیه میکنیم که در صورت موجود بودن، از پشتیبانی تصویر بازگشتی برای همه نمادهای VAST استفاده کنید. میتوانید از این نمونه VAST 3.0 xml برای آزمایشهای بیشتر در برنامه خود استفاده کنید.
ساختار برنامه افزودنی IconFallbackImages
برچسب بزنید | صفات | توضیحات |
---|---|---|
پسوند | نوع | برای این پسوند، نوع همیشه حاوی مقدار IconClickFallbackImages است. |
-IconClickFallbackImages | برنامه | این ویژگی همیشه با ویژگی برنامه مربوط به نماد VAST 3.0 مطابقت دارد. |
ساختار این گره با استاندارد VAST 4.2 برای IconClickFallbackImages مطابقت دارد، به جز اضافه شدن ویژگی program . | ||
--IconClickFallbackImage | عرض | عرض ترجیحی برای نمایش تصویر |
ارتفاع | ارتفاع ترجیحی برای نمایش تصویر | |
---AltText | توضیحات قابل دسترس از تصویر | |
---StaticResource | خلاقانه | نوع 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 را از فراداده DAI API JSON تجزیه کنید
هنگام کار با API DAI ، جزئیات AdChoices از طریق شی JSON ارسال می شود که با درخواست ها به URL ابرداده بازگردانده می شود.
شیء فراداده JSON حاوی لیستی از تبلیغات است که توسط adID کلید می خورد. درون هر شیء تبلیغاتی یک آرایه آیکون وجود دارد. اگر تبلیغ مورد نظر از AdChoices استفاده می کند، نماد AdChoices در آن آرایه موجود است.
فرمت آیکون JSON
قالب نماد JSON ترجمه 1:1 از استاندارد نماد VAST 4.2 (بخش 3.11) است، تا جایی که ممکن است. با این حال، برای پشتیبانی از فرمت سختگیرانهتر JSON، برخی از ویژگیها در صورت لزوم نامها را تغییر دادهاند.
فرمت آیکون JSON
برنامه | برای نماد AdChoices، این مقدار همیشه حاوی رشته "GoogleWhyThisAd" است. |
موقعیت x | موقعیت افقی گوشه سمت چپ بالای نماد، نسبت به گوشه سمت چپ بالای ویدیو، بر حسب پیکسل. این فیلد همچنین مقادیر موقعیت پاسخگو "راست" یا "چپ" را می پذیرد. |
موقعیت y | موقعیت عمودی گوشه سمت چپ بالای نماد، نسبت به گوشه سمت چپ بالای ویدیو، بر حسب پیکسل. این فیلد همچنین مقادیر موقعیت پاسخگو "بالا" یا "پایین" را می پذیرد. |
عرض | عرض نماد بر حسب پیکسل. |
ارتفاع | ارتفاع نماد بر حسب پیکسل. |
Creative_type | نوع mime تصویر ارائه شده برای نماد. پیشفرض «image/png» است. |
منبع | URL برای بازیابی نماد AdChoices. |
alt_text | متن جایگزین برای نمایش نماد AdChoices. |
click_data | یک شی حاوی ویژگی click_data.url که نشاندهنده نشانی وب است تا بینندگان را در صورت کلیک بر روی نماد AdChoices در پلتفرمی که از مرور وب پشتیبانی میکند، هدایت کند. |
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"
}
...
]
...
},
...
}
...
}