نماد و رونهاد AdChoices

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

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

این راهنما توضیح می‌دهد که چگونه اطلاعات لازم را برای پیاده‌سازی صحیح AdChoices از پاسخ XML آگهی VAST یا پاسخ فراداده جاری‌سازی DAI خود استخراج کنید.

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

برای رعایت الزامات Google درخصوص پرداز کردن نمادهای AdChoices، برنامه یا وب‌سایت شما باید استانداردهای زیر را برآورده کند:

  1. نماد «انتخاب‌های آگهی» باید به‌صورت رونهاد روی هر آگهی‌ای که برای آن ارائه شده است نمایش داده شود
  2. نماد AdChoices باید در موقعیت نشان‌داده‌شده توسط ویژگی‌های «مکان X» و «مکان Y» که در داده‌های نماد گنجانده شده است، و در اندازه تعریف‌شده توسط ویژگی‌های عرض و ارتفاع، در پیکسل‌های مستقل از تراکم (DP) نمایش داده شود.
  3. نماد AdChoices نباید توسط رونهادهای آگهی یا عناصر رابط دیگر پوشیده شود.
  4. در پلاتفرم‌هایی که از کلیک یا معادل آن (مثلاً لمس یا انتخاب با کنترل از دور) پشتیبانی می‌کنند، نماد AdChoices باید کلیک‌کردنی باشد.
  5. در پلاتفرم‌هایی که از مرورگر پشتیبانی می‌کنند، با کلیک کردن روی نماد AdChoices باید برگه یا پنجره مرورگری با نشانی وب مشخص‌شده در دارایی «کلیک‌گذری» یا «click_data» باز شود.
  6. در پلاتفرم‌هایی که از مرورگر پشتیبانی نمی‌کنند، با کلیک کردن روی نماد AdChoices باید رونهاد مُدالی باز شود که یکی از تصاویر مشخص‌شده در دارایی «IconClickFallbackImage» یا «click_fallback_images» را نمایش دهد.
  7. در پلاتفرم‌های بدون پشتیبانی مرورگر، تصویر جای‌گزین باید در اندازه مشخص‌شده در دارایی «IconClickFallbackImage» یا «click_fallback_images» در «پیکسل‌های مستقل از چگالی» (DP) نمایش داده شود.

تجزیه کردن AdChoices از پاسخ XML الگوی ارائه آگهی ویدیویی

هنگام کار با پاسخ آگهی XML، «انتخاب‌های آگهی» فقط در VAST نسخه ۳.۰ و بالاتر پشتیبانی می‌شود. ‫AdChoices به‌عنوان یک نماد VAST پیاده‌سازی می‌شود.

VAST 4.2

اگر پاسخ آگهی XML شما از استاندارد VAST 4.2 پیروی می‌کند، AdChoices به‌عنوان «نماد VAST» ارائه می‌شود. اگر برنامه یا وب‌سایت شما به‌طور کامل از نمادهای VAST 4.2 (بخش ۳.۱۱ استاندارد 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 پشتیبانی می‌کند و اگر پلاتفرم بتواند به نشانی وب کلیک‌گذر نماد پیمایش کند و آن را نمایش دهد، پشتیبانی از AdChoices به کار بیشتری نیاز ندارد.

اگر پلاتفرم شما نمی‌تواند به نشانی‌های وب کلیک‌گذر پیمایش کند و آن‌ها را نمایش دهد—این امر عمدتاً برای دستگاه‌هایی که مرورگر وب یکپارچه ندارند صدق می‌کند—باید از افزونه «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 حاوی نشانی وب تصویر جایگزین.

پاسخ نمونه 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

هنگام کار با DAI API، جزئیات «انتخاب‌های آگهی» ازطریق شیء JSON که توسط درخواست‌های نشانی وب فراداده برگردانده می‌شود، منتقل می‌شوند.

شیء JSON «فراداده» حاوی فهرستی از آگهی‌ها است که براساس adID کلیدگذاری شده است. در هر شیء آگهی، آرایه نمادها وجود دارد. اگر آگهی موردنظر از «انتخاب‌های تبلیغات» استفاده می‌کند، نماد «انتخاب‌های تبلیغات» در آن آرایه قرار دارد.

قالب نماد JSON

قالب نماد JSON تا حد امکان ترجمه ۱:۱ از استاندارد نماد VAST 4.2 (بخش ۳.۱۱) است. بااین‌حال، برای پشتیبانی از قالب دقیق‌تر JSON، نام برخی‌از مشخصه‌ها درصورت لزوم تغییر کرده است.

قالب JSON نماد

برنامه رایانه‌ای برای نماد «انتخاب‌های آگهی»، این مقدار همیشه حاوی رشته «GoogleWhyThisAd» است.
x_position موقعیت افقی گوشه راست بالای نماد، نسبت به گوشه راست بالای خلاقانه ویدیویی، برحسب پیکسل. این فیلد همچنین مقادیر موقعیت پاسخ‌گو «راست» یا «چپ» را می‌پذیرد.
y_position موقعیت عمودی گوشه راست بالای نماد، نسبت به گوشه راست بالای عنصر خلاقانه ویدیویی، به پیکسل. این فیلد همچنین مقادیر موقعیت پاسخ‌گو «بالا» یا «پایین» را می‌پذیرد.
عرض عرض نماد، به پیکسل.
ارتفاع ارتفاع نماد، به پیکسل.
creative_type نوع MIME تصویر ارائه‌شده برای نماد. به‌طور پیش‌فرض روی «image/png» تنظیم می‌شود.
منبع نشانی وب برای بازیابی نماد «انتخاب‌های آگهی».
alt_text نوشتار جایگزین برای پرداز کردن نماد «انتخاب‌های آگهی».
click_data شیئی حاوی دارایی click_data.url که نشانی وب را نشان می‌دهد تا بینندگان را درصورت کلیک کردن روی نماد «انتخاب‌های آگهی» در پلاتفرمی که از مرور وب پشتیبانی می‌کند هدایت کند.
click_fallback_images آرایه‌ای از اشیای تصویر برای نمایش به بینندگانی که روی نماد AdChoices در پلاتفرم‌هایی که از مرور وب پشتیبانی نمی‌کنند کلیک می‌کنند.

قالب JSON تصویر جایگزین

عرض عرض تصویر جایگزین، به پیکسل.
ارتفاع ارتفاع تصویر جایگزین، به پیکسل.
creative_type نوع MIME تصویر جایگزین. به‌طور پیش‌فرض روی «image/png» تنظیم می‌شود.
منبع نشانی وب برای بازیابی تصویر جایگزین.
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}