הסמל ושכבת-העל של AdChoices

כל האפליקציות שמציגות מודעות בהתאמה אישית שמתארחות ב-Google חייבות להטמיע את הסמל ואת שכבת העל של AdChoices, אם Google מספקת אותם. AdChoices (נקרא גם 'למה דווקא המודעה הזו?') היא תכונה שנועדה לשקיפות, ומסבירה למשתמשים למה מוצגת להם מודעה מסוימת ומספקת מידע על האופן שבו הפרטיות שלהם מוגנת.

מידע נוסף זמין במאמר למה מוצגת לך מודעה.

במדריך הזה מוסבר איך לחלץ את המידע הדרוש כדי להטמיע את AdChoices בצורה נכונה מתגובת ה-XML של VAST של המודעה או מתגובת המטא-נתונים של הסטרימינג של DAI.

הדרישות להצגת AdChoices

כדי לעמוד בדרישות של Google לגבי הצגת סמלי AdChoices, האפליקציה או האתר שלכם צריכים לעמוד בתקנים הבאים:

  1. חובה להציג את סמל AdChoices כשכבת-על בכל מודעה שבה הוא מופיע
  2. הסמל AdChoices צריך להיות מוצג במיקום שמצוין במאפיינים 'מיקום X' ו'מיקום Y' שכלולים בנתוני הסמל, ובגודל שמוגדר במאפיינים 'רוחב' ו'גובה', בפיקסלים שאינם תלויים בצפיפות (DP).
  3. אסור שסמל AdChoices יוסתר על ידי שכבות-על אחרות של מודעות או על ידי רכיבי ממשק.
  4. בפלטפורמות עם תמיכה בלחיצה או שוות ערך (למשל, בחירה באמצעות מגע או שלט רחוק), הסמל AdChoices חייב להיות ניתן ללחיצה.
  5. בפלטפורמות עם תמיכה בדפדפן, כשלוחצים על סמל AdChoices צריך להיפתח חלון או כרטיסייה בדפדפן עם כתובת ה-URL שצוינה במאפיין ClickThrough או click_data.
  6. בפלטפורמות שלא תומכות בדפדפנים, קליק על הסמל AdChoices צריך לפתוח שכבת-על מודאלית עם אחת מהתמונות שצוינו במאפיין IconClickFallbackImage או click_fallback_images.
  7. בפלטפורמות שלא תומכות בדפדפנים, תמונת הגיבוי צריכה להיות מוצגת בגודל שצוין במאפיין 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.

אם הפלטפורמה לא יכולה לנווט לכתובות 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 סוג ה-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>

ניתוח של AdChoices מ-JSON של מטא-נתונים של DAI API

כשעובדים עם DAI API, הפרטים של AdChoices מועברים דרך אובייקט JSON שמוחזר על ידי בקשות אל metadata URL.

אובייקט ה-JSON של המטא-נתונים מכיל רשימה של מודעות, עם מפתח לפי adID. בכל אובייקט של מודעה יש מערך של סמלים. אם המודעה הרלוונטית משתמשת ב-AdChoices, הסמל של AdChoices ייכלל במערך הזה.

פורמט סמל JSON

פורמט סמל ה-JSON הוא תרגום של תקן הסמלים של VAST 4.2 (סעיף 3.11), בכל מקום שאפשר. עם זאת, כדי לתמוך בפורמט JSON המחמיר יותר, השמות של חלק מהמאפיינים השתנו, איפה שהיה צורך.

פורמט JSON של סמלים

תוכנה בסמל AdChoices, הערך הזה תמיד מכיל את המחרוזת GoogleWhyThisAd.
x_position המיקום האופקי של הפינה השמאלית העליונה של הסמל, ביחס לפינה השמאלית העליונה של קריאייטיב הווידאו, בפיקסלים. השדה הזה מקבל גם את ערכי המיקום הדינמיים 'right' או 'left'.
y_position המיקום האנכי של הפינה הימנית העליונה של הסמל, ביחס לפינה הימנית העליונה של קריאייטיב הווידאו, בפיקסלים. בשדה הזה אפשר להזין גם את ערכי המיקום הדינמיים top או bottom.
רוחב רוחב הסמל, בפיקסלים.
גובה גובה הסמל, בפיקסלים.
creative_type סוג ה-MIME של התמונה שסופקה לסמל. ברירת המחדל היא image/png.
משאב כתובת ה-URL לאחזור סמל AdChoices.
alt_text הטקסט החלופי שיוצג עבור סמל AdChoices.
click_data אובייקט שמכיל את המאפיין click_data.url שמייצג את כתובת ה-URL שאליה המשתמשים יופנו אם הם ילחצו על סמל AdChoices בפלטפורמה שתומכת בגלישה באינטרנט.
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}