מיקוד

במדריך הזה נסביר איך לספק ל-Google Mobile Ads SDK פרטי טירגוט.

הורדת הדגמה של API

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

• קוראים את המדריך לתחילת העבודה.

RequestConfiguration

RequestConfiguration אוסף מידע על טירגוט שחלה באופן גלובלי על כל בקשה להצגת מודעה. במסמכי העזרה של RequestConfiguration.Builder מפורטות רשימות של תגי הטירגוט הזמינים.

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

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

הגדרה של תוכן לילדים

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

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

אפשר להחיל את ההגדרה 'תוכן לילדים' דרך setTagForChildDirectedTreatment():

• קוראים לפונקציה setTagForChildDirectedTreatment עם הערך TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE כדי לציין שרוצים שהתוכן יטופל כתוכן לילדים לצורכי COPPA. הפעולה הזו מונעת את ההעברה של מזהה הפרסום ב-Android‏ (AAID).

• קוראים ל-setTagForChildDirectedTreatment עם הערך TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE כדי לציין שאתם לא רוצים שהתוכן שלכם ייחשב כתוכן לילדים לצורכי COPPA.

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

הדוגמה הבאה מציינת שרוצים שהתוכן ייחשב כתוכן לילדים למטרות COPPA:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

משתמשים מתחת לגיל ההסכמה

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

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

בדומה להגדרות של תוכן לילדים, יש ב-RequestConfiguration.Builder method להגדרת הפרמטר TFUA:‏‏setTagForUnderAgeOfConsent(),‏עם האפשרויות הבאות.

• קוראים לפונקציה setTagForUnderAgeOfConsent() עם הערך TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE כדי לציין שרוצים שהבקשה להצגת מודעה תטופל עבור משתמשים באזור הכלכלי האירופי (EEA) מתחת לגיל ההסכמה. הפעולה הזו גם מונעת את השליחה של מזהה הפרסום ב-Android‏ (AAID).

• קוראים לפונקציה setTagForUnderAgeOfConsent() עם הערך TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE כדי לציין שלא רוצים שהבקשה להצגת מודעה תטופל למשתמשים באזור הכלכלי האירופי (EEA) מתחת לגיל ההסכמה.

• קוראים לפונקציה setTagForUnderAgeOfConsent() עם הערך TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED כדי לציין שלא ציינתם אם בקשת המודעה צריכה לעבור טיפול עבור משתמשים באזור הכלכלי האירופי (EEA) מתחת לגיל ההסכמה.

הדוגמה הבאה מציינת שרוצים לכלול את TFUA בבקשות להצגת מודעות:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

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

סינון תוכן של מודעות

כדי לעמוד במדיניות Google Play בנושא מודעות בלתי הולמות, שכוללת מבצעים משויכים במודעה, כל המודעות והמבצעים המשויכים להן שמוצגים באפליקציה שלכם חייבים להתאים לסיווג התוכן של האפליקציה, גם אם התוכן עצמו עומד בדרישות אחרות של מדיניות Google Play.

כלים כמו סיווג מקסימלי לתוכן מודעה יכולים להגביר את השליטה שלכם בתוכן של המודעות שמוצגות למשתמשים. אתם יכולים להגדיר סיווג תוכן מקסימלי כדי לעמוד בדרישות המדיניות של הפלטפורמה.

אפליקציות יכולות להגדיר סיווג מקסימלי לתוכן מודעה לבקשות להצגת מודעות באמצעות השיטה setMaxAdContentRating . מודעות AdMob שהוחזרו כשהגדרה זו מוגדרת הן מודעות עם סיווג תוכן ברמה הזו או ברמה נמוכה יותר. הערכים האפשריים של התוספת הזו לרשת מבוססים על סיווגים של תוויות לתיאור תוכן דיגיטלי, והם חייבים להיות אחת מהמחרוזות הבאות:

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

הקוד הבא מגדיר אובייקט RequestConfiguration כדי לציין שתוכן המודעה שהוחזר צריך להתאים לסיווג של תווית תוכן דיגיטלי שלא גבוה מ-G:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

למידע נוסף על:

• הגדרת סיווג תוכן מקסימלי לכל בקשה להצגת מודעה

• הגדרת סיווג מקסימלי לתוכן מודעה לאפליקציה או לחשבון

טיפול בפרטיות של בעלי תוכן דיגיטלי (בטא)

Publisher Privacy Treatment (PPT) API הוא כלי אופציונלי שמאפשר לאפליקציות לציין אם להשבית את ההתאמה האישית של המודעות לכל בקשות המודעות באמצעות השיטה setPublisherPrivacyPersonalizationState(). כשמשתמשים בתכונה הזו, פרמטר של טיפול בפרטיות של בעלי תוכן דיגיטלי (PPT) נכלל בכל הבקשות העתידיות להצגת מודעות עד לסיום הסשן.

כשנשלחות ל-Google בקשות להצגת מודעות, המערכת מציגה מודעות בהתאמה אישית כברירת מחדל. הקוד הבא משבית את ההתאמה האישית של המודעות לכל בקשות המודעות:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

בקשה להצגת מודעה

האובייקט AdRequest אוסף את פרטי הטירגוט ששולחים עם בקשה להצגת מודעה.

בדוגמה לטירגוט מודעות תוכלו לקרוא איך מטמיעים טירגוט מודעות באפליקציית הדגמה של Android API.