טירגוט


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

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

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