رمز "خيارات الإعلان" وتراكبه

على جميع التطبيقات التي تعرض إعلانات مخصّصة تستضيفها Google استخدام رمز AdChoices وشريط التمويه، عند توفيرهما من قِبل Google. خيارات الإعلان (المعروفة أيضًا باسم "لماذا هذا الإعلان؟") هي ميزة شفافية توضّح للمستخدمين سبب عرض إعلان معيّن لهم، كما تقدّم معلومات عن كيفية حماية خصوصيتهم.

لمزيد من المعلومات، يُرجى الاطّلاع على سبب ظهور إعلان.

يوضّح هذا الدليل كيفية استخراج المعلومات اللازمة لتطبيق AdChoices بشكلٍ سليم من استجابة ملف XML الخاص بتنسيق VAST لإعلانك أو استجابة البيانات الوصفية لمصدر البث المباشر بالاستناد إلى الإعلانات.

متطلبات عرض AdChoices

للامتثال لمتطلبات Google لعرض رموز AdChoices، يجب أن يستوفي تطبيقك أو موقعك الإلكتروني المعايير التالية:

  1. يجب عرض رمز خيارات الإعلان فوق أي إعلان يتم تقديمه له.
  2. يجب عرض رمز "خيارات الإعلان" في الموضع الذي تشير إليه السمتَان "موقع x " و"موقع y" المضمّنتَين في بيانات الرمز، وبحجم محدّد من خلال سمتَي العرض والارتفاع، وبوحدة قياس Pixels (DP) المستقلة عن الكثافة.
  3. يجب ألا تحجب عناصر التراكب الإعلانية أو عناصر واجهة التطبيق الأخرى رمز "خيارات الإعلان".
  4. على الأنظمة الأساسية التي تتيح النقر أو ما يعادله (مثل اللمس أو الاختيار عن بُعد)، يجب أن يكون رمز "خيارات الإعلان" قابلاً للنقر.
  5. على الأنظمة الأساسية التي تتيح استخدام المتصفّح، يجب أن يؤدي النقر على رمز "خيارات الإعلان" إلى فتح علامة تبويب أو نافذة متصفّح تتضمّن عنوان URL المحدّد في السمة "النقرة" أو "click_data".
  6. على المنصات التي لا تتيح استخدام المتصفّح، يجب أن يؤدي النقر على رمز AdChoices إلى فتح نافذة منبثقة، تعرِض إحدى الصور المحدّدة في العنصر "IconClickFallbackImage" أو "click_fallback_images".
  7. على الأنظمة الأساسية التي لا تتيح استخدام المتصفّح، يجب عرض الصورة الاحتياطية بالحجم المحدد في سمة IconClickFallbackImage أو سمة click_fallback_images، بوحدات بكسل مستقلة الكثافة (DP).

تحليل AdChoices من استجابة XML لنموذج عرض إعلانات الفيديو

عند استخدام استجابة إعلان بتنسيق XML، لا تتوفّر ميزة AdChoices إلا في الإصدار 3.0 من VAST والإصدارات الأحدث. يتم تنفيذ ميزة "خيارات الإعلان" كرمز نموذج عرض إعلانات الفيديو (VAST).

‫VAST 4.2

إذا كانت استجابة إعلان XML متوافقة مع معيار VAST 4.2، يتم عرض AdChoices كرمز VAST. إذا كان تطبيقك أو موقعك الإلكتروني يتيح استخدام رموزالإصدار 4.2 من VAST بالكامل (الفقرة 3.11 من معيار الإصدار 4.2 من VAST)، لن يتطلّب تفعيل ميزة AdChoices أيّ إجراء إضافي.

إذا كان تطبيقك لا يتيح استخدام رموز VAST 4.2، عليك تحليل الرموز يدويًا باستخدام اسم البرنامج "GoogleWhyThisAd" من استجابة VAST، استنادًا إلى هذا المعيار. يمكنك استخدام نموذج VAST 4.2 xml هذا لإجراء اختبار إضافي في تطبيقك.

نموذج استجابة 4.2 من نموذج عرض إعلانات الفيديو (VAST)

<?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 وإذا كان النظام الأساسي قادرًا على الانتقال إلى عنوان URL الذي يتم النقر عليه للوصول إلى الرمز وعرضه، لن يتطلّب إتاحة AdChoices أي إجراء إضافي.

إذا لم تتمكّن منصتك من الانتقال إلى عناوين URL التي يتم النقر عليها وعرضها، وينطبق ذلك في المقام الأول على الأجهزة التي لا تتضمّن متصفّح ويب مدمجًا، عليك توفير إمكانية استخدام إضافة IconFallbackImages. يحتوي هذا الملحق على مجموعة من علامات "IconFallbackImages" التي تتطابق فيها سمة "program" مع رمز تم تضمينه في تنسيق 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 creativeType نوع mime للصورة الاحتياطية
قيمة CDATA تحتوي على عنوان URL للصورة الاحتياطية

نموذج استجابة الإصدار 3.0 من نموذج عرض إعلانات الفيديو (VAST)

<?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، يتم تمرير تفاصيل AdChoices من خلال عنصر JSON الذي يتم إرجاعه من خلال الطلبات إلى عنوان URL للبيانات الوصفية.

يحتوي عنصر البيانات الوصفية بتنسيق JSON على قائمة بالإعلانات، ويتم ترتيبها حسب رقم تعريف الإعلان. ضمن كل كائن إعلان، تتوفّر مصفوفة رموز. إذا كان الإعلان المعنيّ يستخدم ميزة "خيارات الإعلان"، يتم تضمين رمز AdChoices في هذا الصفيف.

تنسيق رمز JSON

تنسيق رمز JSON هو ترجمة مطابقة لمعيار رمز VAST 4.2 (الفقرة 3.11)، كلما أمكن ذلك. ومع ذلك، لدعم تنسيق JSON الأكثر صرامة، تم تغيير أسماء بعض السمات عند الضرورة.

تنسيق JSON للرمز

برنامج بالنسبة إلى رمز "خيارات الإعلان"، تحتوي هذه القيمة دائمًا على السلسلة "GoogleWhyThisAd".
x_position الموضع الأفقي للزاوية العلوية اليسرى من الرمز، بالنسبة إلى الزاوية العلوية اليسرى من تصميم الإعلان للفيديو، بالبكسل يقبل هذا الحقل أيضًا قيم موضع المحتوى المتوافق مع الأجهزة الجوّالة "يمين" أو "يسار".
y_position الموضع العمودي للزاوية العلوية اليسرى من الرمز، بالنسبة إلى الزاوية العلوية اليسرى من تصميم الإعلان للفيديو، بالبكسل يقبل هذا الحقل أيضًا قيم الموضع المتوافق مع الأجهزة الجوّالة "أعلى" أو "أسفل".
العرض عرض الرمز، بالبكسل
الطول ارتفاع الرمز، بالبكسل
creative_type نوع MIME للصورة المقدَّمة للرمز يتم ضبط الإعداد التلقائي على "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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}