מיקוד


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

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

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