מיקוד

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

במדריך הזה מוסבר איך לספק מידע על טירגוט לבקשה להצגת מודעה.

כדי לראות איך טירגוט המודעות פועל, הורידו את אפליקציית ההדגמה של iOS API ב-Swift או ב-Objective-C.

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

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

לפני שממשיכים, מגדירים את Google Mobile Ads SDK.

GADRequestConfiguration

GADRequestConfiguration הוא אובייקט שאוסף מידע על טירגוט כדי להחיל אותו באופן גלובלי דרך המכונה המשותפת GADMobileAds. אפשר לגשת אליו באמצעות הקוד הבא:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

הגדרת הגבלות שקשורות לגיל

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

אפשר להגדיר הגבלות שקשורות לגיל באמצעות המאפיין ageRestrictedTreatment ב-GADRequestConfiguration.

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

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

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

• .teen
• .unspecified

Objective-C

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

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

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

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

מעבר מ-TFCD ו-TFUA להגבלות שקשורות לגיל

הגדרת הטיפול בהתאם לגיל מחליפה את המאפיינים שהוצאו משימוש tagForChildDirectedTreatment (TFCD) ו-tagForUnderAgeOfConsent (TFUA).

בטבלה הבאה מוצגות ההגדרות של tagForChildDirectedTreatment ו-tagForUnderAgeOfConsent וההגדרות המקבילות שלהן לסיווג גיל:

TFCD

tagForChildDirectedTreatment	טיפול לפי גיל
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
לא הוקצה ערך ל-tagForChildDirectedTreatment	GADAgeRestrictedTreatmentUnspecified
אין דוח מקביל	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	טיפול לפי גיל
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
לא הוקצה ערך ל-tagForUnderAgeOfConsent	GADAgeRestrictedTreatmentUnspecified
אין דוח מקביל	GADAgeRestrictedTreatmentTeen

הסבר על האינטראקציות של תג ההגבלות שקשורות לגיל (TFAT) עם תג התאמה לילדים (TFCD) ותג הגבלת איסוף מידע (TFUA)

אם תגדירו את התג TFAT וגם את התגים TFCD או TFUA, ‏ Google תחיל על הבקשות את ההגבלות הכי שמרניות.

הערה: כל התוכן שמוצג למשתמשים שמחוברים לחשבונות Google שמנוהלים באמצעות Family Link נחשב באופן אוטומטי כתוכן לילדים בכל הבקשות להצגת מודעות.

העברת הגדרות של הגבלות שקשורות לגיל בתהליך בחירת הרשת (Mediation) ב-AdMob

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

בטבלה הבאה מפורטות הגרסאות של מתאם הפלטפורמה לבחירת רשת שתומכות בהעברת האות של הגבלת הגיל ל-SDK של הצד השלישי:

שם המתאם של תהליך בחירת הרשת (Mediation)	הגרסה המינימלית הנתמכת
AppLovin	13.6.3.0
BidMachine	3.6.1.1
Bigo	5.2.1.0
Chartboost	9.12.0.1
DTExchange (Fyber)	8.4.7.1
i-mobile	2.3.4.7
InMobi	11.2.0.1
IronSource	9.4.1.0.1
Liftoff Monetize (Vungle)	7.7.2.1
LY Ads (Line Ads)	3.0.1.1
maio	2.2.1.2
Meta (Facebook)	6.21.1.1
Mintegral	8.1.3.1
Moloco	4.6.1.1
MyTarget	5.43.0.0
Pangle	7.9.1.1.1
PubMatic	5.1.0.1
Verve	3.8.1.1

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

אזהרה: המאפיין tagForChildDirectedTreatment יצא משימוש. במקום זאת, מגדירים את המאפיין ageRestrictedTreatment.

למטרות של Children's Online Privacy Protection Act (חוק הגנת הפרטיות של ילדים באינטרנט, COPPA), יש הגדרה שנקראת tagForChildDirectedTreatment.

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

• מגדירים את tagForChildDirectedTreatment לערך true כדי לציין שאתם רוצים שהתוכן יטופל כתוכן שמיועד לילדים בהתאם ל-COPPA. כך נמנעת העברה של מזהה הפרסום, IDFA.
• מגדירים את tagForChildDirectedTreatment לערך false כדי לציין שאתם לא רוצים שהתוכן שלכם יוגדר כמיועד לילדים בהתאם ל-COPPA.
• אל תגדירו את tagForChildDirectedTreatment אם אתם לא רוצים לציין איך אתם רוצים ש-Google תתייחס לתוכן שלכם בהתאם ל-COPPA.

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

אזהרה: המאפיין tagForUnderAgeOfConsent יצא משימוש. במקום זאת, מגדירים את המאפיין ageRestrictedTreatment.

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

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

אפשר להשתמש בהגדרה בכל הגרסאות של Google Mobile Ads SDK על ידי הגדרת המאפיין tagForUnderAgeOfConsent באובייקט GADMobileAds.requestConfiguration והעברת true.

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

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

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

אין להגדיר גם את התגים להפעלת ההגדרה "במיוחד לילדים" וגם את tagForUnderAgeOfConsent לסטטוס true במקביל. אם תעשו את זה, ההגדרה "מיועד לילדים" תקבל עדיפות.

נקודה חשובה: הפרמטר tagForUnderAgeOfConsent הזה לא מועבר למתאמים של תהליך בחירת הרשת (Mediation) למקורות מודעות של צד שלישי. באחריותכם לוודא שכל רשת מודעות של צד שלישי באפליקציה שלכם מציגה מודעות שמתאימות למשתמשים מתחת לגיל ההסכמה בהתאם ל-GDPR.

סינון תוכן מודעה

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

הקוד הבא מגדיר את כל הבקשות להצגת מודעות כך שתוכן המודעות שיוחזר יתאים לתווית התאמת תוכן דיגיטלי לקהל שלא גבוהה מ-GADMaxAdContentRatingGeneral.

נקודה חשובה: הגדרות של מסנן סיווג תוכן שצוינו באמצעות ה-SDK מבטלות את כל ההגדרות שנקבעו באמצעות ממשק המשתמש של AdMob.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

‫Publisher Privacy Treatment (בטא)

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

הערה: אם הבקשות להצגת מודעות כוללות כמה אותות שקשורים לפרטיות המשתמשים, האות המגביל ביותר יקבל עדיפות. דוגמאות ספציפיות מופיעות במסמכי התיעוד של Publisher Privacy Treatment API.

GADRequest

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

הוספת פרטים נוספים על רשת המודעות

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

קטע הקוד הבא מגדיר מפתח פרמטר נוסף של collapsible עם ערך של bottom ל-Google:

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

כתובת URL של תוכן

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

לדוגמה, אם האפליקציה מבקשת מודעה בזמן שהיא מציגה תוכן מ-https://www.example.com, אפשר להעביר את כתובת ה-URL הזו כדי לטרגט מילות מפתח רלוונטיות:

Swift

let request = Request()
request.contentURL = "https://www.example.com"

Objective-C

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

שאלות נפוצות

באילו הגדרות טירגוט המערכת משתמשת כשהמודעה מתרעננת באופן אוטומטי?

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

איך מעבירים פרמטרים נוספים של טירגוט לרשתות בתהליך בחירת הרשת?

בקטע תהליך בחירת הרשת (Mediation) מוסבר איך לשלוח טירגוט לרשתות בתהליך בחירת הרשת.