نماد و پوشش AdChoices

همه برنامه‌هایی که آگهی‌های شخصی‌سازی‌شده میزبان‌شده توسط Google را نمایش می‌دهند، باید نماد و پوشش AdChoices را در صورت ارائه توسط Google پیاده‌سازی کنند. AdChoices (همچنین به عنوان «چرا این آگهی؟» نامیده می‌شود) یک ویژگی شفاف‌سازی است که به کاربران توضیح می‌دهد چرا یک آگهی خاص به آن‌ها نشان داده می‌شود و اطلاعاتی درباره نحوه محافظت از حریم خصوصی آن‌ها ارائه می‌دهد.

برای اطلاعات بیشتر، به چرایی مشاهده آگهی مراجعه کنید.

این راهنما نحوه استخراج اطلاعات لازم برای اجرای صحیح AdChoices را از پاسخ VAST XML تبلیغ یا پاسخ فراداده جریان DAI شما توضیح می دهد.

الزامات برای رندر AdChoices

برای مطابقت با الزامات Google برای ارائه نمادهای AdChoices، برنامه یا وب سایت شما باید استانداردهای زیر را داشته باشد:

  1. نماد AdChoices باید روی هر تبلیغی که برای آن ارائه شده است نمایش داده شود
  2. نماد AdChoices باید در موقعیتی که با ویژگی‌های "X location" و "Y location" در داده‌های نماد مشخص شده است، و در اندازه مشخص شده توسط ویژگی‌های عرض و ارتفاع، در پیکسل‌های مستقل از چگالی (DP) نمایش داده شود.
  3. نماد AdChoices نباید توسط دیگر پوشش‌های تبلیغاتی یا عناصر رابط پنهان شود.
  4. در پلتفرم‌هایی با پشتیبانی از کلیک یا معادل آن (مثلاً انتخاب با لمس یا از راه دور)، نماد AdChoices باید قابل کلیک باشد.
  5. در پلتفرم‌هایی که از مرورگر پشتیبانی می‌کنند، با کلیک کردن روی نماد AdChoices باید یک برگه یا پنجره مرورگر با URL مشخص شده در ویژگی «ClickThrough» یا «click_data» باز شود.
  6. در پلتفرم‌هایی که از مرورگر پشتیبانی نمی‌کنند، با کلیک کردن روی نماد AdChoices باید یک پوشش مودال باز شود و یکی از تصاویر مشخص‌شده در ویژگی «IconClickFallbackImage» یا «click_fallback_images» نمایش داده شود.
  7. در پلتفرم‌هایی که از مرورگر پشتیبانی نمی‌کنند، تصویر بازگشتی باید در اندازه مشخص‌شده در ویژگی «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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}