מיקוד

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

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

כדי לראות את טירגוט המודעות בפעולה, אפשר להוריד את אפליקציית ההדגמה של 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

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

  • .teen
  • .unspecified

Objective-C

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

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

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

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

העברת נתוני הגיל בתהליך בחירת הרשת (Mediation)

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

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

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

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

לצורך 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 שלך.

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

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

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

הוספת ערוצים או חבילות

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

בקטע הקוד הבא מוגדר מפתח פרמטר נוסף 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 = AdManagerRequest()
request.contentURL = "https://www.example.com"

Objective-C

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

מיקוד מותאם אישית

אחרי שמגדירים צמדים של מפתח/ערך בממשק המשתמש של Ad Manager, מגדירים טירגוט בהתאמה אישית עם ערכי המפתח בבקשה להצגת מודעה. פריטים שמטרגטים את צמדי הערכים האלה עומדים בדרישות להצגה בבקשה להצגת מודעה. כדי לטרגט כמה ערכים למפתח אחד, מזינים את הערכים כמחרוזת מופרדת בפסיקים.

Swift

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

הגנה על המותג (בטא)

אפליקציות שמציגות תוכן דינמי שמיועד לקהלים שונים יכולות לספק רשימה קצרה של כתובות URL באמצעות המאפיין neighboringContentURLs. כתובות ה-URL של התוכן הסמוך שונות מהמאפיין contentURL בכך שהן משמשות רק להגנה על המותג.

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

Swift

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

מזהים שניתנים על ידי בעל התוכן הדיגיטלי (PPID)

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

הגדרת ה-PPID מתבצעת באמצעות GAMRequest:

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

דוגמה להטמעה של מזהים שניתנו על ידי בעל התוכן הדיגיטלי (נתוני PPID) באפליקציית ההדגמה של iOS API:

‫Swift ‫Objective-C

אותות שמספקים בעלי תוכן דיגיטלי

אתם יכולים לשלוח נתוני קהל והקשר כאותות שמספקים בעלי תוכן דיגיטלי (PPS) בבקשות להצגת מודעות. בעזרת PPS, אתם יכולים להשתמש בנתוני המשתמשים כדי לשפר את המונטיזציה הפרוגרמטית. לשם כך, אתם יכולים להעביר למציעי הצעות מחיר את מאפייני הקהל בכל סוגי העסקאות, באמצעות טקסונומיות סטנדרטיות, בלי לשתף מזהי משתמשים. מאפייני קהל היעד יכולים לכלול נתונים התנהגותיים ונתונים שמבוססים על תחומי עניין (IAB Audience Taxonomy 1.1) ונתונים הקשריים (IAB Content Taxonomy 2.2).

Swift

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

שאלות נפוצות

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