דף זה תורגם על ידי Cloud Translation API.

מיקוד

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

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

משלימים את השלבים במאמר תחילת העבודה.

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