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

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

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

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

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

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

  1. הסמל של AdChoices חייב להופיע כשכבת-על בכל מודעה שבה הוא מסופק
  2. הסמל של AdChoices צריך להופיע במיקום שמצוין במאפיינים 'X location' ו-'Y location' שכלולים בנתוני הסמל, ובגודל שמוגדר במאפיינים width ו-height, בפיקסלים שלא תלויים בצפיפות (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, ואם הפלטפורמה יכולה לנווט אל כתובת היעד של קליק של הסמל ולהציג אותה, לא נדרשת פעולה נוספת כדי לתמוך ב-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 הוא תרגום של 1:1 מתקן הסמל של 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}