מיקוד

הפלטפורמה: Android iOS Unity Flutter

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

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

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

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

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

GADRequestConfiguration

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

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

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

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

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

  • מגדירים את 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). פיתחנו את התכונה הזו כדי לעזור לכם לפעול בהתאם לתקנה הכללית להגנה על מידע (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 במקביל. אם תעשו את זה, ההגדרה 'התאמה לילדים' תקבל עדיפות.

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

באפליקציות אפשר להגדיר סיווג מקסימלי לתוכן מודעה לכל הבקשות להצגת מודעות באמצעות המאפיין 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 מתבצעת דרך GAMRequest:

Swift

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

Objective-C

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

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

‫Swift Objective-C

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

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