מיקוד

בחירת פלטפורמה: Android iOS Unity Flutter

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

כדי לראות את טירגוט המודעות בפעולה, אפשר להוריד את אפליקציית ההדגמה של 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 בבקשות להצגת מודעות. כדאי להתייעץ עם היועצים המשפטיים שלכם כדי לקבוע את הגיל הרלוונטי לזכאות שחל על המשתמשים שלכם, בהתאם למחויבויות המשפטיות והרגולטוריות שלכם. מידע נוסף זמין במאמר איך מסמנים בקשות להצגת מודעות מאפליקציה בתג הגבלות שקשורות לגיל (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

הסבר על אינטראקציות שקשורות לטיפול בנתונים של משתמשים מתחת לגיל 13 באמצעות TFCD ו-TFUA

אם הגדרתם הגדרת טיפול לפי גיל והגדרות TFCD או TFUA, ‏ Google תחיל את הטיפול השמרני ביותר.

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

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

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

לצורך חוק הגנת הפרטיות של ילדים באינטרנט (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). פיתחנו את התכונה הזו כדי לעזור לכם לפעול בהתאם לתקנה הכללית להגנה על מידע (GDPR). שימו לב: ייתכן שיש לכם חובות משפטיות נוספות בכפוף ל-GDPR. מומלץ לעיין בהנחיות של האיחוד האירופי ולפנות לייעוץ משפטי. חשוב לזכור שהכלים של Google מיועדים לסייע לציות לחוק, ולא פוטרים בעלי אפליקציות מהמחויבויות שלהם בכפוף לחוק. מידע נוסף על ההשפעה של GDPR על בעלי אתרים

כשמשתמשים בתכונה הזו, כל הבקשות העתידיות להצגת מודעות יכללו פרמטר Tag For Users under the Age of Consent in Europe (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 לא מועבר למתאמי תהליך הבחירה של רשת המודעות עבור מקורות של מודעות מצד שלישי. באחריותכם לוודא שכל רשת מודעות של צד שלישי באפליקציה שלכם מציגה מודעות שמתאימות למשתמשים מתחת לגיל ההסכמה בהתאם ל-GDPR.

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

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

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

‫API Publisher Privacy Treatment ‏(PPT) הוא כלי אופציונלי שמאפשר לאפליקציות לציין אם להשבית את התאמת המודעות אישית לכל הבקשות להצגת מודעות באמצעות המאפיין 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 של התוכן שהן מציגות. כך אפשר להשתמש בטירגוט לפי מילות מפתח כדי להתאים את המודעה לתוכן.

לדוגמה, אם האפליקציה שלכם שולחת בקשה להצגת מודעה בזמן שהיא מציגה תוכן מכתובת ה-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 חדש.

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

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