מיקוד

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

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

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

טיפול בפרטיות בעלי תוכן דיגיטלי (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 יעד-ג

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

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

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