טירגוט

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

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

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();