טירגוט


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

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

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

התוכן לילדים

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

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

כדי לשנות את ההגדרה אפשר להקצות איבר אחד (tag_for_child_directed_treatment) בקבוצה RequestConfiguration מוגדר ל: אחד מהערכים המספורים הבאים:

  • הקצאה של RequestConfiguration::tag_for_child_directed_treatment ל RequestConfiguration::kChildDirectedTreatmentTrue כדי לציין על פי חוק COPPA, התוכן שלכם מטופל כתוכן לילדים.
  • הקצאה של 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). שימו לב: ייתכן שמפורטות ב-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();