מיקוד


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

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

RequestConfiguration

RequestConfiguration הוא struct שאוסף מידע על טירגוט כדי להחיל אותו באופן גלובלי באמצעות הפונקציה הגלובלית 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), יש הגדרה שנקראת "תג התאמה לילדים (TFCD)". הגדרת התג הזה מהווה אישור לכך שההודעה הזו מדויקת ושיש לך הרשאה לפעול בשם הבעלים של האפליקציה. ברור לך שניצול לרעה של ההגדרה הזו עלול לגרום לסגירת חשבון Google שלך.

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

כדי לקבוע את ההגדרה, מקצים את המאפיין 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 שלך.

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

הקוד הבא מגדיר struct 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();