טירגוט


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

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

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