דף זה תורגם על ידי Cloud Translation API.

מיקוד

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

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

מסיימים את המאמר תחילת העבודה.

`RequestConfiguration`

RequestConfiguration הוא מבנה שאוסף מידע על טירגוט כדי להחיל אותו באופן גלובלי באמצעות הפונקציה הגלובלית SetRequestConfiguration().

כדי לעדכן את ההגדרות האישיות של הבקשה, קודם צריך להשתמש בתצורה הנוכחית, לבצע את העדכונים הרצויים ולהגדיר אותה כך:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

הגדרה לילדים

למטרות חוק הגנת הפרטיות של ילדים באינטרנט (COPPA), יש הגדרה שנקראת "תג לטיפול מותאם לילדים". כשאתם מגדירים את התג הזה, אתם מאשרים שההודעה הזו מדויקת ושאתם מורשים לפעול בשם הבעלים של האפליקציה. אתם מבינים שניצול לרעה של ההגדרה הזו עשוי לגרום לסגירת חשבון Google שלכם.

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

ניתן לקבוע את ההגדרה על ידי הקצאת החבר tag_for_child_directed_treatment במבנה RequestConfiguration לאחד מהערכים הבאים:

כדי לוודא שהתוכן שלכם מכוון לילדים, צריך להקצות את 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:

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

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

כמו בהגדרות שמותאמות לילדים, יש חבר ב-RequestConfiguration להגדרת הפרמטר TFUA: tag_for_under_age_of_consent, שאותו אפשר להגדיר באמצעות הערכים הממוספרים הבאים:

מקצים את המאפיין RequestConfiguration::tag_for_under_age_of_consent ל-RequestConfiguration::kUnderAgeOfConsentTrue כדי לציין שאתם רוצים שהבקשה להצגת מודעה תקבל טיפול עבור משתמשים באזור הכלכלי האירופי (EEA) מתחת לגיל ההסכמה.
כדי לוודא שהבקשה להצגת מודעות לא תקבל טיפול עבור משתמשים באזור הכלכלי האירופי (EEA) מתחת לגיל ההסכמה, צריך להקצות את RequestConfiguration::tag_for_under_age_of_consent אל RequestConfiguration::kUnderAgeOfConsentFalse.
מקצים את המאפיין 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);

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

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

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