טירגוט


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

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

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

התוכן לילדים

למטרות חוק הגנת הפרטיות של ילדים באינטרנט (COPPA) (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.
  • הקצאה של 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). התכונה הזו נועדה לעזור לאפשר ציות ל-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) (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

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