כל האפליקציות שמוצגות בהן מודעות בהתאמה אישית שמתארחות ב-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, ואם הפלטפורמה יכולה לנווט לכתובת ה-URL של הקליקים על הסמל ולהציג אותה, לא נדרשת פעולה נוספת כדי להוסיף תמיכה ב-AdChoices.
אם הפלטפורמה לא יכולה לנווט לכתובות URL של קליקים ולהציג אותן – המצב הזה רלוונטי בעיקר למכשירים שאין בהם דפדפן אינטרנט משולב – צריך להטמיע תמיכה בתוסף 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 | המיקום האופקי של הפינה השמאלית העליונה של הסמל, ביחס בפינה הימנית העליונה של קריאייטיב הווידאו, בפיקסלים. השדה הזה מקבל גם את הערכים 'ימין' או 'שמאל' למיקום רספונסיבי. |
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"
}
...
]
...
},
...
}
...
}