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

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

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

במדריך הזה מוסבר איך לחלץ את המידע הדרוש להטמעה תקינה של AdChoices מהתגובה של ה-VAST XML של המודעה או מהתגובה של המטא-נתונים של פיד ה-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, חלון 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 ה-MIME type של התמונה החלופית.
ערך 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 שמוחזר על ידי בקשות אל כתובת ה-URL של המטא-נתונים.

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

פורמט סמל JSON

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

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

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