يجب أن تنفِّذ جميع التطبيقات التي تعرض إعلانات مخصَّصة تستضيفها Google AdChoices متراكبة، عندما توفرها Google. خيارات الإعلان (المعروفة أيضًا باسم "لماذا هذا الإعلان؟") هي ميزة شفافية توضّح للمستخدمين سبب عرض إعلان معيّن لهم، كما تقدّم معلومات عن كيفية حماية خصوصيتهم.
لمزيد من المعلومات، يُرجى الاطّلاع على سبب ظهور إعلان.
يشرح هذا الدليل كيفية استخراج المعلومات الضرورية من أجل تنفيذ "خيارات الإعلان" من استجابة XML لإعلان VAST أو من بث DAI استجابة بيانات التعريف.
متطلبات عرض AdChoices
للامتثال لمتطلبات Google لعرض رموز "خيارات الإعلان"، يجب أن يستوفي تطبيقك أو موقعك الإلكتروني المعايير التالية:
- يجب عرض رمز خيارات الإعلان فوق أي إعلان يتم تقديمه له.
- يجب أن يُعرض رمز "خيارات الإعلان" في الموضع المُشار إليه بعلامة "X". الموقع" و"موقع Y" الخصائص المضمنة في بيانات الرمز، وفي علامة الحجم المحدد من خلال خصائص العرض والارتفاع، في قيم مستقلّة عن الكثافة وحدات البكسل (DP).
- يجب ألا تحجب عناصر التراكب الإعلانية أو عناصر واجهة التطبيق الأخرى رمز "خيارات الإعلان".
- على الأنظمة الأساسية التي تتيح النقر أو ما يعادله (مثل اللمس أو الاختيار عن بُعد)، يجب أن يكون رمز "خيارات الإعلان" قابلاً للنقر.
- على الأنظمة الأساسية التي تتيح استخدام المتصفح، يجب أن يؤدي النقر على رمز "خيارات الإعلان" إلى فتح نافذة أو علامة تبويب متصفّح تتضمّن عنوان URL المحدَّد في عمود "النقر" أو "click_data" الموقع.
- على المنصات التي لا تتيح استخدام المتصفّح، يجب أن يؤدي النقر على رمز AdChoices إلى فتح نافذة منبثقة، مع عرض إحدى الصور المحدّدة في العنصر "IconClickFallbackImage" أو "click_fallback_images".
- على الأنظمة الأساسية التي لا تدعم المتصفح، يجب عرض الصورة الاحتياطية على الحجم المحدد في "IconClickFallbackImage" أو "click_fallback_images" بوحدات البكسل المستقلة الكثافة (DP).
تحليل AdChoices من استجابة XML لنموذج عرض إعلانات الفيديو
عند استخدام استجابة إعلان بتنسيق XML، لا تتوفّر ميزة AdChoices إلا في الإصدار 3.0 من VAST والإصدارات الأحدث. يتم تنفيذ ميزة "خيارات الإعلان" كرمز نموذج عرض إعلانات الفيديو (VAST).
نموذج عرض إعلانات فيديو (VAST) 4.2
إذا كانت استجابة إعلان XML متوافقة مع معيار VAST 4.2 ، يتم عرض AdChoices كرمز 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 الذي يتم النقر عليه للوصول إلى الرمز وعرضه، لن يتطلّب إتاحة AdChoices أي إجراء إضافي.
إذا لم تتمكّن المنصّة من الانتقال إلى نسبة النقر إلى الظهور وعرضها عناوين URL: ينطبق ذلك بشكل أساسي على الأجهزة التي لا تحتوي على شبكة ويب متكاملة. في هذا المتصفح، عليك تنفيذ دعم "IconFallbackImages" الإضافة. تحتوي هذه الإضافة على مجموعة من "IconFallbackImages" حيث يحتوي "program" مع أي رمز تم تضمينه في نموذج عرض إعلانات فيديو (VAST).
لإتاحة خيارات الإعلان بالكامل، يجب وضع علامة 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 للصورة الاحتياطية. |
نموذج استجابة 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، يتم تمرير تفاصيل AdChoices من خلال عنصر JSON الذي يتم إرجاعه من خلال الطلبات إلى عنوان URL لبيانات الوصف.
يحتوي عنصر البيانات الوصفية بتنسيق JSON على قائمة بالإعلانات، ويتم ترتيبها حسب رقم تعريف الإعلان. ضمن كل كائن إعلان، تتوفّر مصفوفة رموز. وإذا كان الإعلان المعني يستخدم "خيارات الإعلان"، يتم تضمين رمز "خيارات الإعلان" في تلك المصفوفة.
تنسيق رمز JSON
تنسيق رمز JSON هو ترجمة مطابقة لمعيار رمز 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 | صفيف من عناصر الصور لعرضها للمشاهدين الذين ينقرون على رمز 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"
}
...
]
...
},
...
}
...
}