מיקוד

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

כדי לראות איך טירגוט מודעות פועל, הורידו את אפליקציית ההדגמה ל-iOS API ב-Swift או מטרה ג'

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

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

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

GADRequestConfiguration

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

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

התוכן לילדים

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

נקודה חשובה: הפרמטר tagForUnderAgeOfConsent לא מועבר אל מתאמים של תהליך בחירת הרשת (Mediation) עבור מקורות מודעות של צד שלישי. באחריותך לוודא שכל רשת מודעות של צד שלישי באפליקציה שלכם תציג מודעות מתאים למשתמשים מתחת לגיל ההסכמה בהתאם ל-GDPR.

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

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

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;

הערה: בבקשות להצגת מודעות עם כמה אותות לשמירה על הפרטיות של המשתמשים, ההגבלה הכי מגבילה לאותן עדיפות. לצפייה Publisher Privacy Treatment API תיעוד לדוגמאות ספציפיות.

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"];

נקודה חשובה: ה-SDK משתמשת רק בארבע כתובות ה-URL הראשונות. המערכת מתעלמת מכל השאר.

מזהים שניתנו על ידי בעל האפליקציה

אפשר להגדיר מזהה שסופק על ידי בעל האתר (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:

סוויפט יעד ג'

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

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

בתהליך בחירת הרשת (Mediation) מוסבר איך לשלוח טירגוט לרשתות בתהליך בחירת הרשת (Mediation).