מיקוד


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

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

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

הגדרה של תוכן לילדים

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

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

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

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

כשמשתמשים בתכונה הזאת, בקשות להצגת מודעות כוללות פרמטר Tag For Users under the Age of Consent in Europe (תג לציון הצגה למשתמשים מתחת לגיל ההסכמה באירופה, 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 של התוכן שהן מציגות. כך אפשר להשתמש בטירגוט לפי מילות מפתח כדי להתאים את המודעה לתוכן.

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