מיקוד

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

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

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 לאחד מהערכים הממוספרים הבאים:

  • כדי לציין שאתם רוצים שהתוכן שלכם ייחשב כמיועד לילדים לפי COPPA, עליכם להקצות את RequestConfiguration::tag_for_child_directed_treatment אל RequestConfiguration::kChildDirectedTreatmentTrue.
  • כדי לא להציג את התוכן שלכם כתוכן לילדים, צריך להקצות את RequestConfiguration::tag_for_child_directed_treatment ל-RequestConfiguration::kChildDirectedTreatmentFalse.
  • עליכם להקצות את הדומיין RequestConfiguration::tag_for_child_directed_treatment אל RequestConfiguration::kChildDirectedTreatmentUnspecified אם אתם לא רוצים לציין את אופן הטיפול בתוכן שלכם בהקשר של COPPA בבקשות להצגת מודעות.

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

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

הדוגמה הבאה מציינת שאתם רוצים להציג 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);

אין להפעיל בשני המקרים את התגים כדי להפעיל את ההגדרה 'במיוחד לילדים' ואת המשתמשים מתחת לגיל ההסכמה. אם כן, ההגדרה מותאמת לילדים מקבלת עדיפות.

סינון תוכן מודעות

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