בכל האפליקציות שמוצגות בהן מודעות בהתאמה אישית ש-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, חלונית 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, ואם הפלטפורמה יכולה לנווט לכתובת ה-URL של הקליקים על הסמל ולהציג אותה, לא נדרשת פעולה נוספת כדי להוסיף תמיכה ב-AdChoices.
אם הפלטפורמה לא יכולה לנווט לכתובות URL של קליקים ולהציג אותן – המצב הזה רלוונטי בעיקר למכשירים שאין בהם דפדפן אינטרנט משולב – צריך להטמיע תמיכה בתוסף IconFallbackImages. התוסף הזה מכיל קבוצה של תגי IconFallbackImages שבהם המאפיין 'program' תואם לסמל שכללתם ב-VAST.
כדי לתמוך באופן מלא ב-AdChoices, התג IconFallbackImages עם שם התוכנית 'GoogleWhyThisAd' צריך להיות משויך לסמל עם שם התוכנית 'GoogleWhyThisAd', כך שכאשר המשתמש יוצר אינטראקציה עם הסמל, תוצג התמונה החלופית המשויכת.
כדי לתמוך בשינויים אפשריים בעתיד בתקן AdChoices, מומלץ לשלב תמיכה בתמונה חלופית בכל סמלי ה-VAST, זמינים. אפשר להשתמש בקובץ ה-xml לדוגמה של VAST 3.0 לצורך בדיקה נוספת באפליקציה.
מבנה התוסף 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 הוא תרגום אחד לאחד מתקן הסמל של VAST 4.2 (קטע 3.11), במידת האפשר. עם זאת, כדי לתמוך בפורמט JSON המחמיר יותר , חלק מהמאפיינים השתנו בהתאם לצורך.
פורמט JSON של סמלים
תוכנה | בסמל AdChoices, הערך הזה תמיד מכיל את המחרוזת "GoogleWhyThisAd". |
x_position | המיקום האופקי של הפינה השמאלית העליונה של הסמל, ביחס בפינה הימנית העליונה של קריאייטיב הווידאו, בפיקסלים. השדה הזה מקבל גם את הערכים 'ימין' או 'שמאל' למיקום רספונסיבי. |
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 | ה-MIME type של התמונה החלופית. ברירת המחדל היא '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"
}
...
]
...
},
...
}
...
}