במדריך הזה מוסבר איך מספקים פרטי טירגוט לבקשה להצגת מודעה.
דרישות מוקדמות
- משלימים את התהליך שנתחיל?.
RequestConfiguration
RequestConfiguration
הוא מבנה שאוסף מידע על טירגוט כדי להחיל אותו באופן גלובלי באמצעות הפונקציה הגלובלית SetRequestConfiguration()
.
כדי לעדכן את ההגדרות של הבקשה, קודם מקבלים את ההגדרות הנוכחיות, מבצעים את העדכונים הרצויים ומגדירים אותה כך:
firebase::gma::RequestConfiguration retrieved_configuration = firebase::gma::GetRequestConfiguration(); // .. apply your changes, then: firebase::gma::SetRequestConfiguration(request_configuration);
התוכן לילדים
כדי לעמוד בדרישות של Children's Online Privacy Protection Act (חוק הגנת הפרטיות של ילדים באינטרנט, COPPA), יש הגדרה שנקראת 'תג התאמה לילדים (TFCD)'. הגדרת התג הזה תפורש כאישורך לכך שההודעה הזו מדויקת ושיש לך הרשאה לפעול בשם הבעלים של האפליקציה. ברור לך שניצול לרעה של ההגדרה הזו עשוי לגרום לסגירת חשבון Google שלך.
כשאתם, בתור מפתחי אפליקציות, שולחים בקשה להצגת מודעה, אתם יכולים לציין אם אתם רוצים ש-Google תתייחס לתוכן שלכם כתוכן לילדים. אם ציינתם שאתם רוצים ש-Google תתייחס לתוכן שלכם כתוכן לילדים, אנחנו נשבית את המודעות לפי תחומי עניין ומודעות רימרקטינג בבקשה להצגת מודעה.
כדי לקבוע את ההגדרה אפשר להקצות את האיבר tag_for_child_directed_treatment
במבנה RequestConfiguration
לאחד מהערכים הבאים:
- כדי לציין שאתם רוצים שהתוכן שלכם יטופל כתוכן לילדים לפי חוק COPPA, צריך להקצות את
RequestConfiguration::tag_for_child_directed_treatment
ל-RequestConfiguration::kChildDirectedTreatmentTrue
. - מקצים את המאפיין
RequestConfiguration::tag_for_child_directed_treatment
לערךRequestConfiguration::kChildDirectedTreatmentFalse
כדי לציין שאתם לא רוצים שהתוכן שלכם יתייחס לתוכן לילדים לפי חוק COPPA. - מקצים את הערך
RequestConfiguration::tag_for_child_directed_treatment
ל-RequestConfiguration::kChildDirectedTreatmentUnspecified
אם לא רוצים לציין בבקשות להצגת מודעות את אופן הטיפול בתוכן ביחס ל-COPPA.
הדוגמה הבאה מציינת שאתם רוצים שהתוכן שלכם יתייחס לתוכן לילדים לפי חוק COPPA:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.tag_for_child_directed_treatment = firebase::RequestConfiguration::kChildDirectedTreatmentTrue; firebase::gma::SetRequestConfiguration(request_configuration);
הגדרת התג הזה מבטאת את אישורך לכך שההודעה הזו מדויקת ושיש לך הרשאה לפעול בשם בעלי האפליקציה. ברור לך שניצול לרעה של ההגדרה הזו עלול לגרום לסגירת חשבון Google שלך.
משתמשים מתחת לגיל ההסכמה
אפשר לסמן בקשות להצגת מודעות כך שיטופלו כמותאמות למשתמשים מתחת לגיל ההסכמה באזור הכלכלי האירופי (EEA). פיתחנו את התכונה הזאת כדי לעזור לכם לציית לדרישות של General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR). שימו לב: ייתכן שמפורטות ב-GDPR חובות משפטיות נוספות שעליכם לעמוד בהן. מומלץ לעיין בהנחיות של האיחוד האירופי ולהתייעץ עם היועץ המשפטי שלכם. חשוב לזכור שהכלים של Google מיועדים לסייע לציות לחוק, ולא פוטרים בעלי אפליקציות מהמחויבויות שלהם בכפוף לחוק. למידע נוסף בנושא ההשפעה של GDPR על בעלי אפליקציות
כשמשתמשים בתכונה הזאת, הבקשה להצגת מודעה כוללת פרמטר 'תג למשתמשים מתחת לגיל ההסכמה באירופה' (TFUA). הפרמטר הזה משבית בכל הבקשות להצגת מודעות את הפרסום המותאם אישית, כולל רימרקטינג. בנוסף, הוא משבית העברה של בקשות לספקי מודעות של צד שלישי, למשל בקשות לפיקסלים למדידת מודעות ובקשות לשרתי מודעות של צד שלישי.
בדומה להגדרות עם תוכן לילדים, ב-RequestConfiguration יש חבר שמגדיר את הפרמטר TFUA: tag_for_under_age_of_consent
, שניתן להגדיר עם הערכים המספורים הבאים:
- מקצים את הערך
RequestConfiguration::tag_for_under_age_of_consent
ל-RequestConfiguration::kUnderAgeOfConsentTrue
כדי לציין שרוצים שהבקשה להצגת מודעה תטופל עבור משתמשים באזור הכלכלי האירופי (EEA) מתחת לגיל ההסכמה. - מקצים את הערך
RequestConfiguration::tag_for_under_age_of_consent
ל-RequestConfiguration::kUnderAgeOfConsentFalse
כדי לציין שלא רוצים שהבקשה להצגת מודעה תטופל עבור משתמשים מתחת לגיל ההסכמה באזור הכלכלי האירופי (EEA). - מקצים את המאפיין
RequestConfiguration::tag_for_under_age_of_consent
לערךRequestConfiguration::kUnderAgeOfConsentUnspecified
כדי לציין שלא ציינתם אם הבקשה להצגת מודעה צריכה לקבל טיפול למשתמשים מתחת לגיל ההסכמה באזור הכלכלי האירופי (EEA).
בדוגמה הבאה אתם רוצים לכלול את אפליקציית TFUA בבקשות להצגת מודעות:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.tag_for_under_age_of_consent = firebase::RequestConfiguration::kUnderAgeOfConsentTrue; firebase::gma::SetRequestConfiguration(request_configuration);
אסור להגדיר את התגים להפעלת ההגדרה 'תוכן לילדים' ואת התג 'משתמשים מתחת לגיל ההסכמה' בו-זמנית כ-true. אם כן, ההגדרה 'תוכן לילדים' מקבלת עדיפות.
סינון תוכן מודעות
אפליקציות יכולות להגדיר סיווג מקסימלי לתוכן מודעה לבקשות להצגת מודעות דרך RequestConfiguration::max_ad_content_rating field
. כשמוגדרת סיווג תוכן של מודעות AdMob עם סיווג תוכן ברמה הזו או נמוכה ממנה. הערכים האפשריים לכך מבוססים על סיווגים של תוויות התאמת תוכן דיגיטלי לקהל, והם חייבים להיות אחד מהערכים הבאים:
RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA
הקוד הבא מגדיר את המבנה RequestConfiguration
כדי לציין שתוכן המודעה שמוחזר צריך להתאים לסיווג של תווית התאמת תוכן דיגיטלי לקהל, שלא גבוה מ-G:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.max_ad_content_rating = firebase::RequestConfiguration::kMaxAdContentRatingG; firebase::gma::SetRequestConfiguration(request_configuration);
AdRequest
האובייקט AdRequest
אוסף פרטי טירגוט שיישלחו עם בקשה להצגת מודעה.
כתובת URL של תוכן
כשמבקשים מודעה, האפליקציות יכולות להעביר את כתובת ה-URL של התוכן שהן מוצגות. כך הטירגוט לפי מילות מפתח יכול להתאים בין המודעה לתוכן.
לדוגמה, אם האפליקציה מבקשת מודעה בזמן שהיא מציגה תוכן מ-https://www.example.com
, אפשר להעביר את כתובת ה-URL הזו כדי לטרגט למילות מפתח רלוונטיות:
// AdRequest with content URL: firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com"); // AdRequest without content URL: firebase::admob::AdRequest ad_request();