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

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

למידע נוסף, ראה למה אתה רואה מודעה.

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

דרישות לעיבוד של AdChoices

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

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