הגדרת כתובת ה-URL של שקיפות המודעות

כתובת ה-URL של הצהרת השקיפות מאפשרת לכם להתאים אישית את הסמל AdChoices שמוצג במודעות מסוימות. כברירת מחדל, הסמל הזה מוצג למשתמשים שלכם באמצעות חוויית משתמש של שקיפות ושליטה במודעות (AT&C) שמוצגת על ידי Google, וכוללת מידע כמו המפרסם והמודעה עצמה.

כדי לקבל את כתובת ה-URL של המרכז לשקיפות של מודעות, צריך לשלוח בקשה להצגת מודעה אל Google Mobile Ads SDK ולקבל תגובה עם כתובת ה-URL של המרכז לשקיפות של מודעות. אחרי שתקבלו את כתובת ה-URL באפליקציה, תוכלו לשלב סמל מותאם אישית שיעמוד בדרישות העיצוב של המודעות, ולהציג למשתמשים שלכם חוויה משלכם של בקשת הסכמה וגילוי נאות.

בדף הזה מוסבר איך לבקש את כתובת ה-URL של שקיפות המודעה, לנתח אותה ולאמת אותה.

דרישות מוקדמות

לפני שממשיכים, צריך לבצע את הפעולות הבאות:

  • מגדירים מודעות מותאמות באפליקציה. פרטים על מודעות מותאמות זמינים במאמר בנושא מודעות מותאמות.
  • צריך לבקש גישה לרשימת ההיתרים כדי להשתמש בתכונה הזו. כדי לבקש גישה, צריך לפנות אל מנהל החשבון.
    • אם אין לכם גישה, התשובות לא יחזירו את כתובת ה-URL של שקיפות המודעה, והסמל שמוגדר כברירת מחדל יוצג כמו שצריך.

בקשה של כתובת URL

כדי ש-GMA Next-Gen SDK תחזיר לכם את כתובת ה-URL של שקיפות המודעה, צריך להוסיף פרמטר בקשה נוסף לבקשות של המודעות המקומיות. הפרמטר הזה מציין שהאפליקציה מוכנה לטפל בסמל מותאם אישית.

בבקשה, צריך להוסיף את המפתח "ad_transparency_url_requested" עם הערך "1" לחבילת פרטים נוספים על רשת המודעות. פרטים נוספים על רשת המודעות זמינים במאמר setGoogleExtrasBundle.

בדוגמה הבאה מוגדרים המפתח והערך האלה כדי לבקש את כתובת ה-URL של שקיפות המודעה:

Java 

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin 

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

מחליפים את AD_UNIT_ID במזהה יחידת המודעות. לדוגמה, ca-app-pub-3940256099942544/2247696110 למודעות מותאמות.

ניתוח כתובת ה-URL

אחרי ששולחים בקשה לכתובת ה-URL, מקבלים תגובה לבקשה להצגת מודעה עם כתובת ה-URL של השקיפות במודעה באובייקט של פרטי התגובה. פרטים על אובייקט פרטי התגובה מופיעים במאמר בנושא פרטי התגובה.

אפשר לגשת לכתובת ה-URL של הצהרת השקיפות לגבי המודעות באמצעות המפתח "ad_transparency_url" מפרטים נוספים על התגובה למודעה. בדוגמה הבאה מאחזרים את כתובת ה-URL של הצהרת השקיפות לגבי המודעות באובייקט פרטי התגובה:

Java 

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin 

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

אימות כתובת ה-URL

כדי לבדוק ולאמת את כתובת ה-URL של שקיפות המודעה, צריך לוודא שלא מופיע סמל ברירת המחדל ש-Google מספקת במודעה המקורית, אלא הסמל המותאם אישית. לוחצים על הסמל כדי לראות את חוויית השימוש בכלי AT&C.

בנוסף, צריך לוודא שכתובת ה-URL של השקיפות במודעות מופיעה בתוספים של אובייקט פרטי התשובה. אם לא רואים את כתובת ה-URL של שקיפות המודעות, סמל ברירת המחדל של Google מוצג במקום הסמל המותאם אישית. לדוגמה, כתובת URL של הצהרת שקיפות בנושא מודעות:

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID