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

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

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

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

متطلبات عرض AdChoices

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

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

تحليل AdChoices من استجابة XML لنموذج VAST

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

إذا كانت المنصة غير قادرة على الانتقال إلى عناوين 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 الخاص بالبيانات الوصفية على قائمة بالإعلانات، ويتم تحديد مفتاحها بواسطة adID. يتضمّن كل عنصر إعلان مصفوفة رموز. إذا كان الإعلان المعنيّ يستخدم "خيارات الإعلان"، سيتم تضمين رمز "خيارات الإعلان" في هذه المصفوفة.

تنسيق رمز JSON

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

تنسيق JSON للرمز

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