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

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

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

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

متطلبات عرض "خيارات الإعلان"

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

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

تحليل "خيارات الإعلان" من استجابة XML لعلامة VAST

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

VAST 4.2

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

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

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

إذا كانت منصتك غير قادرة على الانتقال إلى عناوين URL للنقر وعرضها، وينطبق ذلك بشكل أساسي على الأجهزة التي لا تتضمّن متصفّح ويب مدمجًا، عليك تنفيذ إمكانية استخدام إضافة "IconFallbackImages". تحتوي هذه الإضافة على مجموعة من علامات "IconFallbackImages" التي تتطابق فيها سمة "program" مع رمز تم تضمينه في VAST.

لإتاحة ميزة "خيارات الإعلان" بالكامل، يجب ربط علامة IconFallbackImages التي تحمل اسم البرنامج "GoogleWhyThisAd" بالرمز الذي يحمل اسم البرنامج "GoogleWhyThisAd"، بحيث يتم عرض الصورة الاحتياطية المرتبطة عندما يتفاعل المستخدم مع الرمز.

لدعم التغييرات المحتملة المستقبلية على معيار "خيارات الإعلان"، ننصحك بشدة بتضمين إمكانية استخدام الصور الاحتياطية لجميع رموز VAST، متى توفّرت. يمكنك استخدام نموذج XML لعلامة VAST 3.0 هذا لإجراء اختبارات إضافية في تطبيقك.

بنية إضافة IconFallbackImages

العلامة السمات الوصف
الإضافة النوع بالنسبة إلى هذه الإضافة، يحتوي النوع دائمًا على القيمة IconClickFallbackImages.
-IconClickFallbackImages برنامج تتطابق هذه السمة دائمًا مع سمة البرنامج لرمز VAST 3.0 مرتبط.
تتطابق بنية هذه العُقدة مع معيار VAST 4.2 لـ IconClickFallbackImages، باستثناء إضافة السمة program.
--IconClickFallbackImage العرض العرض المفضّل لعرض الصورة
الطول الطول المفضّل لعرض الصورة
---AltText وصف يسهل الوصول إليه للصورة
---StaticResource creativeType نوع 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>

تحليل "خيارات الإعلان" من بيانات JSON الوصفية لواجهة برمجة تطبيقات DAI

عند استخدام DAI API، يتم تمرير تفاصيل "خيارات الإعلان" من خلال كائن JSON الذي يتم عرضه من خلال الطلبات إلى عنوان URL للبيانات الوصفية metadata URL.

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

تنسيق رمز JSON

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

تنسيق JSON للرمز

برنامج بالنسبة إلى رمز "خيارات الإعلان"، تحتوي هذه القيمة دائمًا على السلسلة "GoogleWhyThisAd".
x_position الموضع الأفقي للزاوية العلوية اليمنى من الرمز، بالنسبة إلى الزاوية العلوية اليمنى من تصميم إعلان الفيديو، بالبكسل يقبل هذا الحقل أيضًا قيمتَي الموضع المتجاوب "right" أو "left".
y_position الوضع الرأسي للزاوية العلوية اليسرى من الرمز، بالنسبة إلى الزاوية العلوية اليسرى من تصميم إعلان الفيديو، بالبكسل. يقبل هذا الحقل أيضًا قيمتَي الموضع المتجاوب "top" أو "bottom".
العرض عرض الرمز، بالبكسل
الطول ارتفاع الرمز، بالبكسل
creative_type نوع MIME للصورة المقدّمة للرمز القيمة التلقائية هي "image/png".
المصدر عنوان URL لاسترداد رمز "خيارات الإعلان"
alt_text النص البديل الذي سيتم عرضه لرمز "خيارات الإعلان"
click_data كائن يحتوي على السمة click_data.url التي تمثّل عنوان URL الذي يتم توجيه المشاهدين إليه إذا نقروا على رمز "خيارات الإعلان" على منصة تتيح تصفّح الويب
click_fallback_images مصفوفة من كائنات الصور التي سيتم عرضها للمشاهدين الذين ينقرون على رمز "خيارات الإعلان" على منصات لا تتيح تصفّح الويب

تنسيق 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}