מיקוד

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

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

GAMRequest

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

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

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

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

Swift

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

Objective-C

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

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

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

Swift

let request = GAMRequest()
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 = GAMRequest()
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 = GAMRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

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

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

SWIFT Objective-C

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

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

Swift

let extras = GADExtras()
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 = GAMRequest()()
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 חדש.
איך מעבירים פרמטרים נוספים של טירגוט לרשתות בתהליך בחירת הרשת (Mediation)?
במאמר תהליך בחירת הרשת (Mediation) מוסבר איך לשלוח טירגוט לרשתות בתהליך בחירת הרשת.