טירגוט


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

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

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