מיקוד

בחירת פלטפורמה: 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
מטא (פייסבוק)	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 אם אתם לא רוצים לציין איך אתם רוצים שהתוכן שלכם יטופל בהתאם ל-COPPA.

בדוגמה הבאה מצוין שאתם רוצים שהתוכן שלכם יסווג כתוכן שמיועד לילדים לצורך התאימות ל-COPPA:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

אפשר לסמן את הבקשות להצגת מודעות כדי שיטופלו כבקשות שמתאימות למשתמשים מתחת לגיל ההסכמה באזור הכלכלי האירופי (EEA). פיתחנו את התכונה הזו כדי לעזור לכם לציית לדרישות של General Data Protection Regulation (התקנות הכלליות להגנה על מידע, 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 חדש.

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

במאמר בנושא גישור מוסבר איך שולחים טירגוט לרשתות גישור.