הסמל ושכבת-העל של 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 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}