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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بنية إضافة IconFallbackImages

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

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

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

تنسيق رمز JSON

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

تنسيق JSON للرمز

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

تنسيق JSON للصورة الاحتياطية

العرض عرض الصورة الاحتياطية بالبكسل.
الطول ارتفاع الصورة الاحتياطية بالبكسل.
creative_type mimetype للصورة الاحتياطية. يتم ضبط الإعدادات التلقائية على "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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}