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