מיקוד


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

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

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.
  • מקצים 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();