בכל האפליקציות שמוצגות בהן מודעות בהתאמה אישית ש-Google מארחת חובה להטמיע הסמל AdChoices כש-Google מספקת את שכבת-העל. AdChoices (נקרא גם 'למה דווקא מודעה זו?') היא תכונת שקיפות שמסבירה למשתמשים למה מוצג להם מודעה מסוימת ומספקת מידע לגבי האופן שבו הפרטיות שלהם מוגנת.
למידע נוסף, ראה למה אתה רואה מודעה.
במדריך הזה נסביר איך לחלץ את המידע הנדרש כדי להטמיע את AdChoices מתגובת ה-XML של המודעה או מזרם DAI תגובה למטא-נתונים.
דרישות לרינדור של AdChoices
כדי לעמוד בדרישות של Google בנוגע לעיבוד סמלים של AdChoices, האפליקציה שלכם או האתר חייב לעמוד בסטנדרטים הבאים:
- סמל AdChoices צריך להופיע כשכבת-על מעל לכל מודעה שעבורה הוא מוצג סופק
- יש להציג את סמל AdChoices במיקום שמצוין ב-"X" מיקום" ו-'Y מיקום' שכלולים בנתוני הסמל, ובזמן גודל המוגדר על ידי מאפייני הרוחב והגובה, ללא תלות בדחיסות פיקסלים (DP).
- אסור שסמל AdChoices יסתיר אותו על ידי ממשק או שכבות-על אחרים של מודעות רכיבים.
- בפלטפורמות עם תמיכה בקליקים או פריטים מקבילים (למשל, בחירה במגע או בחירה מרחוק), סמל AdChoices צריך להיות לחיץ.
- בפלטפורמות שיש בהן תמיכה בדפדפן, לחיצה על הסמל AdChoices חייבת לפתוח בכרטיסייה או חלון בדפדפן שכתובת ה-URL שלהם מצוינת בשדה 'שיעור קליקים' או click_data לנכס.
- בפלטפורמות שאין בהן תמיכה בדפדפן, לחיצה על הסמל AdChoices חייבת לפתוח בשכבת-על של מודל מודאלי, שמציגה אחת מהתמונות שמצוינות "IconClickFallbackImage" או "click_fallback_images" לנכס.
- בפלטפורמות ללא תמיכה בדפדפן, יש להציג את התמונה החלופית הגודל שצוין בתוך "IconClickFallbackImage" או click_fallback_images בנכס, בפיקסלים בלתי תלויים בדחיסות (DP).
ניתוח AdChoices מתגובת XML מסוג VAST
כשעובדים עם תגובה לבקשת מודעה בפורמט XML, AdChoices יש תמיכה רק במודעות VAST גרסה 3.0 ואילך. AdChoices מוטמע כסמל VAST.
VAST 4.2
אם התגובה לבקשת מודעה בפורמט XML תואמת ל-VAST 4.2 Standard, 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 תואמת ל-VAST 3.0 רגילה, AdChoices מוצגות כשילוב של סמל VAST ותוסף VAST מותאם אישית. אם לאפליקציה או לאתר יש תמיכה מלאה בתקן סמל VAST 3.0 ואם הפלטפורמה אפשרות לנווט ולהציג את הסמל 'כתובת אתר לקליקים', התמיכה של AdChoices לא נדרשת כל עבודה נוספת.
אם לפלטפורמה שלכם אין אפשרות לנווט אל שיעור הקליקים ולהציג אותו כתובות אתרים — הדבר רלוונטי בעיקר למכשירים שאין להם ממשק אינטרנט משולב דפדפן — עליך ליישם תמיכה עבור "IconFallbackImages" לתוסף. התוסף הזה מכיל קבוצה של "IconFallbackImages" שבהם "program" תואם לסמל שנכלל ב-VAST.
כדי לתמוך באופן מלא ב-AdChoices, התג IconFallbackImages עם שם התוכנית 'GoogleWhyThisAd' צריך להיות משויך לסמל עם שם המועדון 'GoogleWhyThisAd', למשל, כשהמשתמש מקיים אינטראקציה עם הסמל, מוצגת התמונה החלופית המשויכת.
כדי לתמוך בשינויים אפשריים בעתיד בתקן AdChoices, מומלץ לשלב תמיכה בתמונה חלופית בכל סמלי ה-VAST, זמינים. אפשר להשתמש בדוגמה הזו של VAST 3.0 xml כדי לבצע בדיקות נוספות באפליקציה.
מבנה התוסף IconFallbackImages
תיוג | מאפיינים | תיאור |
---|---|---|
Extension | סוג | לתוסף הזה, הסוג תמיד מכיל את הערך
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>
ניתוח AdChoices מהמטא-נתונים של DAI API בפורמט JSON
כשעובדים עם הטמעת מודעות דינמיות (DAI)" API, פרטי AdChoices מועברים דרך אובייקט ה-JSON שמוחזר בבקשות אל המטא-נתונים כתובת URL.
אובייקט ה-JSON של המטא-נתונים מכיל רשימה של מודעות, שמקושרות למזהה הפרסום. בכל אובייקט המודעה הוא מערך סמלים. אם במודעה הרלוונטית נעשה שימוש ב-AdChoices, מערך זה כולל את סמל AdChoices.
הפורמט של סמל JSON
הפורמט של הסמל JSON הוא תרגום ביחס של 1:1 מהסמל VAST 4.2 רגילה (סעיף 3.11), ככל האפשר. עם זאת, כדי לתמוך בפורמט JSON המחמיר יותר , חלק מהמאפיינים השתנו בהתאם לצורך.
פורמט JSON עם סמל
תוכנה | בסמל AdChoices, הערך הזה תמיד מכיל את המחרוזת "GoogleWhyThisAd". |
x_position | המיקום האופקי של הפינה השמאלית העליונה של הסמל, ביחס בפינה הימנית העליונה של קריאייטיב הווידאו, בפיקסלים. השדה הזה מקבל גם ערכי המיקום הרספונסיביות הם "right" או 'left'. |
y_position | המיקום האנכי של הפינה השמאלית העליונה של הסמל, ביחס הפינה הימנית העליונה של קריאייטיב הווידאו, בפיקסלים. השדה הזה מקבל גם את ערכי מיקום רספונסיביות 'ראש הדף' או 'למטה'. |
רוחב | רוחב הסמל, בפיקסלים. |
גובה | גובה הסמל, בפיקסלים. |
creative_type | ה-mimetype של התמונה שסופקה עבור הסמל. ברירת המחדל היא 'image/png'. |
משאב | כתובת ה-URL שבה מאחזרים את סמל AdChoices. |
alt_text | הטקסט החלופי לעיבוד של סמל AdChoices. |
click_data | אובייקט שמכיל את המאפיין click_data.url ,
מייצג את כתובת ה-URL שאליה הצופים יופנו אם הם ילחצו על הסמל של AdChoices
פלטפורמה שתומכת בגלישה באינטרנט.
|
click_fallback_images | מערך של אובייקטים של תמונות שיוצגו לצופים שלוחצים על AdChoices סמל בפלטפורמות שלא תומכות בגלישה באינטרנט. |
פורמט 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"
}
...
]
...
},
...
}
...
}