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

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

למידע נוסף, קראו את המאמר למה מודעה מסוימת מוצגת לך.

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

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

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

  1. הסמל 'מודעות שנבחרו' חייב להיות מוצג כשכבת-על של כל מודעה שעבורה הוא מסופק
  2. הסמל של AdChoices צריך להופיע במיקום שצוין באמצעות המאפיינים "מיקום X" ו-"Y location" שנכללים בנתוני הסמל, ובגודל שנקבע על ידי מאפייני הרוחב והגובה, בפיקסלים שאינם תלויים בדחיסות (DP).
  3. אסור להסתיר את הסמל של AdChoices על ידי שכבות-על של מודעות או רכיבי ממשק אחרים.
  4. בפלטפורמות עם תמיכה בלחיצה או בפעולות מקבילות (למשל, בחירה באמצעות מגע או בחירה מרחוק), הסמל של AdChoices צריך להיות לחיץ.
  5. בפלטפורמות שתומכים בדפדפן, לחיצה על הסמל של AdChoices צריכה לפתוח כרטיסייה או חלון בדפדפן עם כתובת ה-URL שצוינה במאפיין Clickthrough או click_data.
  6. בפלטפורמות ללא תמיכה בדפדפן, לחיצה על הסמל AdChoices צריכה לפתוח שכבת-על מודאלית שמציגה אחת מהתמונות שצוינו בנכס "IconClickFallbackImage" או "click_fallback_images".
  7. בפלטפורמות ללא תמיכה בדפדפן, יש להציג את תמונת הגיבוי בגודל שצוין במאפיין IconClickFallbackImage או click_fallback_images, בפיקסלים שאינם תלויים בדחיסות (DP).

ניתוח של AdChoices מתגובת VAST XML

כשעובדים עם תגובה למודעת 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

תיוג מאפיינים תיאור
תוסף סוג בתוסף הזה, הסוג תמיד מכיל את הערך 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 של מטא-נתונים ב-DAI API

כשעובדים עם DAI API, הפרטים של AdChoices מועברים דרך אובייקט JSON שמוחזר בבקשות לכתובת ה-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 ה-mimetype של התמונה שסופקה לסמל. ברירת המחדל היא 'image/png'.
מקור מידע כתובת ה-URL לשחזור הסמל של AdChoices.
alt_text הטקסט החלופי להצגה של הסמל של AdChoices.
click_data אובייקט שמכיל את הנכס click_data.url, שמייצג את כתובת ה-URL שאליה הצופים יופנו אם ילחצו על הסמל של AdChoices בפלטפורמה שתומכת בגלישה באינטרנט.
click_fallback_images מערך של אובייקטים של תמונות להצגה לצופים שלוחצים על הסמל 'מודעות שנבחרו' בפלטפורמות שלא תומכות בגלישה באינטרנט.

פורמט 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}