מיקוד

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

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

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

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

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

GADRequestConfiguration

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

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

לצורכי חוק הגנת הפרטיות של ילדים באינטרנט (COPPA), יש הגדרה שנקראת tagForChildDirectedTreatment.

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

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

תוכלו להשתמש בהגדרה בכל הגרסאות של Google Mobile Ads SDK. לשם כך, מגדירים את הנכס tagForUnderAgeOfConsent באובייקט GADMobileAds.requestConfiguration ומעבירים אותו ב-true.

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

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

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GADRequest

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

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

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

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

Swift

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

Objective-C

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

שאלות נפוצות

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