מיקוד

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

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

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) באפליקציית הדגמה של API ל-iOS:

Swift Objective-C

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

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