מיקוד

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

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

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

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

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

GADRequestConfiguration

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

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

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

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

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

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

הדוגמה הבאה מציינת שרוצים שהתוכן ייחשב כתוכן לילדים למטרות 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) מוסבר איך שולחים טירגוט לרשתות לבחירת רשת.