הסמל ושכבת-העל של 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 ואם הפלטפורמה אפשרות לנווט ולהציג את הסמל לכתובת אתר לקליקים, התמיכה של AdChoices לא נדרשת כל עבודה נוספת.

אם לפלטפורמה שלכם אין אפשרות לנווט אל שיעור הקליקים ולהציג אותו כתובות אתרים — הדבר רלוונטי בעיקר למכשירים שאין להם ממשק אינטרנט משולב דפדפן — עליך ליישם תמיכה עבור "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 המיקום האופקי של הפינה השמאלית העליונה של הסמל, ביחס בפינה הימנית העליונה של קריאייטיב הווידאו, בפיקסלים. השדה הזה מקבל גם ערכי המיקום הרספונסיביות הם "right" או 'left'.
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}