این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

نماد و پوشش AdChoices

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

برای اطلاعات بیشتر، به بخش «چرا تبلیغ می‌بینید» مراجعه کنید.

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

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

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

آیکون AdChoices باید روی هر تبلیغی که برای آن ارائه شده است، نمایش داده شود.
آیکون AdChoices باید در موقعیتی که توسط ویژگی‌های "مکان X" و "مکان Y" موجود در داده‌های آیکون مشخص شده است، و در اندازه‌ای که توسط ویژگی‌های عرض و ارتفاع تعریف شده است، در پیکسل‌های مستقل از تراکم (DP) نمایش داده شود.
آیکون AdChoices نباید توسط سایر پوشش‌های تبلیغاتی یا عناصر رابط کاربری پنهان شود.
در پلتفرم‌هایی که از کلیک یا معادل آن (مثلاً لمس یا انتخاب از راه دور) پشتیبانی می‌کنند، آیکون AdChoices باید قابل کلیک باشد.
در پلتفرم‌هایی که مرورگرها از آن پشتیبانی می‌کنند، کلیک روی آیکون AdChoices باید یک تب یا پنجره مرورگر با آدرس اینترنتی مشخص‌شده در ویژگی «ClickThrough» یا «click_data» باز کند.
در پلتفرم‌هایی که مرورگرها از آن پشتیبانی نمی‌کنند، کلیک روی آیکون AdChoices باید یک پنجره‌ی modal باز کند که یکی از تصاویر مشخص شده در ویژگی "IconClickFallbackImage" یا "click_fallback_images" را نمایش می‌دهد.
در پلتفرم‌هایی که مرورگر از آنها پشتیبانی نمی‌کند، تصویر جایگزین باید در اندازه‌ای که در ویژگی "IconClickFallbackImage" یا "click_fallback_images" مشخص شده است، در پیکسل‌های مستقل از چگالی (DP) نمایش داده شود.

تجزیه AdChoices از یک پاسخ XML گسترده

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

گسترده ۴.۲

اگر پاسخ تبلیغ 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>

گسترده ۳.۰

اگر پاسخ تبلیغ XML شما از استاندارد VAST 3.0 پیروی کند، AdChoices به صورت ترکیبی از یک آیکون VAST و یک افزونه سفارشی VAST ارائه می‌شود. اگر برنامه یا وب‌سایت شما به طور کامل از استاندارد آیکون VAST 3.0 پشتیبانی می‌کند و اگر پلتفرم قادر به پیمایش و نمایش URL کلیکی آیکون است، پشتیبانی AdChoices نیازی به کار بیشتری ندارد.

اگر پلتفرم شما قادر به پیمایش و نمایش URLهای کلیکی نیست - این امر در درجه اول در مورد دستگاه‌هایی که مرورگر وب یکپارچه ندارند صدق می‌کند - باید پشتیبانی از افزونه "IconFallbackImages" را پیاده‌سازی کنید. این افزونه شامل مجموعه‌ای از برچسب‌های "IconFallbackImages" است که در آن‌ها ویژگی "program" با نمادی که در VAST گنجانده شده است، مطابقت دارد.

برای پشتیبانی کامل از AdChoices، تگ IconFallbackImages با نام برنامه "GoogleWhyThisAd" باید به آیکونی با نام برنامه "GoogleWhyThisAd" مرتبط باشد، به طوری که وقتی کاربر با آیکون تعامل می‌کند، تصویر جایگزین مرتبط نمایش داده شود.

برای پشتیبانی از تغییرات احتمالی آینده در استاندارد AdChoices، اکیداً توصیه می‌کنیم در صورت امکان، پشتیبانی از تصویر جایگزین را برای همه آیکون‌های VAST در نظر بگیرید. می‌توانید از این نمونه VAST 3.0 xml برای آزمایش بیشتر در برنامه خود استفاده کنید.

ساختار افزونه IconFallbackImages

برچسب	ویژگی‌ها	توضیحات
پسوند	نوع	برای این افزونه، نوع داده همیشه حاوی مقدار `IconClickFallbackImages` است.
-تصاویر آیکون کلیک-بازگشتی	برنامه	این ویژگی همیشه با ویژگی برنامه‌ی یک آیکون VAST 3.0 مرتبط مطابقت دارد.
-تصاویر آیکون کلیک-بازگشتی		ساختار این گره با استاندارد VAST 4.2 برای IconClickFallbackImages مطابقت دارد، به جز اضافه شدن ویژگی `program` .
--آیکونکلیکفالبکتصویر	عرض	عرض ترجیحی برای نمایش تصویر.
--آیکونکلیکفالبکتصویر	ارتفاع	ارتفاع ترجیحی برای نمایش تصویر.
---متن جایگزین		توضیحی قابل فهم از تصویر.
---منبع استاتیک	خلاق نوع	نوع مایمِ تصویر جایگزین.
---منبع استاتیک		یک مقدار 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

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

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

فرمت آیکون JSON

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

فرمت آیکون JSON

برنامه	برای آیکون AdChoices، این مقدار همیشه شامل رشته‌ی "GoogleWhyThisAd" است.
موقعیت x	موقعیت افقی گوشه بالا سمت چپ آیکون، نسبت به گوشه بالا سمت چپ ویدیوی خلاقانه، بر حسب پیکسل. این فیلد همچنین مقادیر موقعیت واکنش‌گرای "راست" یا "چپ" را می‌پذیرد.
موقعیت y	موقعیت عمودی گوشه بالا سمت چپ آیکون، نسبت به گوشه بالا سمت چپ ویدیوی خلاقانه، بر حسب پیکسل. این فیلد همچنین مقادیر موقعیت واکنش‌گرای "بالا" یا "پایین" را می‌پذیرد.
عرض	عرض آیکون، بر حسب پیکسل.
ارتفاع	ارتفاع آیکون، بر حسب پیکسل.
نوع_خلاق	نوع مایم تصویر ارائه شده برای آیکون. مقدار پیش‌فرض "image/png" است.
منبع	نشانی اینترنتی برای بازیابی نماد AdChoices.
متن جایگزین	متن جایگزین (alt text) که برای آیکون AdChoices نمایش داده می‌شود.
کلیک_داده	یک شیء حاوی ویژگی `click_data.url` که نشان‌دهنده‌ی URL است که در صورت کلیک بینندگان بر روی آیکون AdChoices در پلتفرمی که از مرور وب پشتیبانی می‌کند، به آن هدایت می‌شوند.
click_fallback_images	آرایه‌ای از اشیاء تصویری برای نمایش به بینندگانی که روی نماد AdChoices در پلتفرم‌هایی که از مرور وب پشتیبانی نمی‌کنند کلیک می‌کنند.

فرمت JSON تصویر جایگزین

عرض	عرض تصویر جایگزین، بر حسب پیکسل.
ارتفاع	ارتفاع تصویر جایگزین، بر حسب پیکسل.
نوع_خلاق	نوع مایم تصویر جایگزین. مقدار پیش‌فرض "image/png" است.
منبع	آدرس اینترنتی (URL) برای بازیابی تصویر جایگزین.
متن جایگزین	متن جایگزین (alt text) که برای تصویر جایگزین (fallback image) رندر می‌شود.

نمونه فراداده 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}

نماد و پوشش AdChoices با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

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

تجزیه AdChoices از یک پاسخ XML گسترده

گسترده ۴.۲

نمونه پاسخ VAST 4.2

گسترده ۳.۰

ساختار افزونه IconFallbackImages

نمونه پاسخ VAST 3.0

تجزیه AdChoices از متادیتای DAI API به فرمت JSON

فرمت آیکون JSON

فرمت آیکون JSON

فرمت JSON تصویر جایگزین

نمونه فراداده JSON

نماد و پوشش AdChoices