מיקוד

הטירגוט מאפשר לכם לספק ל-Google Mobile Ads SDK for React Native מידע על ההקשר ועל הקהל כדי להציג למשתמשים מודעות רלוונטיות.

אפשר להגדיר טירגוט ברמות הבאות:

  • הגדרת בקשות גלובליות: החלת הגדרות על כל הבקשות להצגת מודעות באפליקציה, כולל הגדרות שקשורות לילדים ולבני נוער, סיווג מקסימלי לתוכן מודעה, הגדרות פרטיות של בעלי תוכן דיגיטלי ומזהי מכשירים לבדיקה.
  • טירגוט לכל בקשה: אפשר להתאים אישית בקשות ספציפיות להצגת מודעות באמצעות אובייקטים של בקשות להצגת מודעות, כולל כתובות URL של תוכן ופרטים נוספים על רשת המודעות.

במדריך הזה מוסבר איך לספק מידע על טירגוט ל-Google Mobile Ads SDK for React Native.

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

לפני שממשיכים, צריך להגדיר את Google Mobile Ads SDK for React Native.

הגדרת הבקשה

האובייקט RequestConfiguration אוסף מידע על הטירגוט שמוחל באופן גלובלי על כל בקשה להצגת מודעה.

כדי להחיל את הגדרות הטירגוט מהבקשה הראשונה להצגת מודעה, מגדירים את המאפיין requestConfiguration כשמפעילים את ה-method‏ initialize:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

מחליפים את TEST_DEVICE_HASHED_ID במזהה מכשיר לבדיקה שעבר גיבוב (hash). המזהה הזה מציין מכשיר שצריך לקבל מודעות בדיקה.

כדי לעדכן את הגדרות הטירגוט אחרי ההפעלה של Google Mobile Ads SDK for React Native, צריך להפעיל את ה-method‏ setRequestConfiguration. השיטה setRequestConfiguration מחליפה הגדרה קיימת ונכנסת לתוקף בבקשות הבאות להצגת מודעות.

בדוגמה הבאה משנים אובייקט RequestConfiguration עם הגדרות טירגוט מעודכנות ומחילים את ההגדרות על בקשות להצגת מודעות:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

הגדרת הגבלות שקשורות לגיל

כדי לעזור לכם לפעול בהתאם לתקנות הרלוונטיות בנושא פרטיות של ילדים ובני נוער, ב-Google Mobile Ads SDK for React Native יש הגדרה לטיפול בנתוני גיל. ההגדרה של הטיפול שמותאם לגיל מאפשרת לציין אם מערכת Google Mobile Ads SDK for React Native צריכה להחיל הגנות ספציפיות על הצגת מודעות לילדים, לבני נוער או לגיל לא מוגדר.

אפשר להגדיר הגבלות שקשורות לגיל באמצעות המאפיין ageRestrictedTreatment ב-RequestConfiguration.

בדוגמה הבאה מצוין שבקשות להצגת מודעות צריכות לקבל טיפול שמותאם לילדים:

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

כדי לציין טיפול שמותאם לבני נוער או טיפול שמותאם לגיל לא מוגדר, מחליפים את ההגדרה AgeRestrictedTreatment.CHILD בהגדרה הבאה:

כשמשתמשים בהגדרה הזו, Google Mobile Ads SDK for React Native כולל פרמטר tfat בבקשות להצגת מודעות. כדי לקבוע את הגדרות ההגבלות שקשורות לגיל של המשתמשים שלכם, בהתאם למחויבויות המשפטיות והרגולטוריות שלכם, מומלץ להתייעץ עם היועצים המשפטיים שלכם. מידע נוסף זמין במאמר איך לסמן בקשות להצגת מודעות מהאפליקציה בתג הגבלות שקשורות לגיל.

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

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

כדי להגדיר סיווג מקסימלי לתוכן מודעה לבקשות להצגת מודעות באפליקציה, משתמשים במאפיין maxAdContentRating באובייקט RequestConfiguration. אחרי שקובעים את ההגדרה הזו, המודעות שמוחזרות הן בסיווג התוכן הזה או בסיווג נמוך יותר. הערכים האפשריים להגדרה הזו מבוססים על סיווגים של תוויות תוכן דיגיטלי, והם חייבים להיות אחד מהקבועים הבאים:

בדוגמה הבאה מגדירים אובייקט RequestConfiguration כדי לציין שתוכן המודעה שמוחזר צריך להתאים לתווית התאמת תוכן דיגיטלי לקהל שלא גבוהה מהקבוע G:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

פרטים נוספים זמינים במאמרים הבאים:

אופציונלי: הגדרת PPT API (בטא)

‫Publisher Privacy Treatment (או בקיצור PPT) הוא API שמאפשר לכם לציין אם להשבית את ההתאמה האישית של המודעות בכל הבקשות להצגת מודעות, באמצעות המאפיין publisherPrivacyPersonalizationState באובייקט RequestConfiguration. כשמשתמשים בתכונה הזו, Google Mobile Ads SDK for React Native כולל פרמטר של טיפול בפרטיות של בעלי תוכן דיגיטלי (PPT) בכל הבקשות להצגת מודעות בשארית הסשן.

כברירת מחדל, בקשות להצגת מודעות שנשלחות ל-Google כוללות מודעות בהתאמה אישית. בדוגמה הבאה מושבתת ההתאמה האישית של המודעות בכל הבקשות להצגת מודעות:

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

הגדרת האובייקט AdRequest

האובייקט AdRequest אוסף את פרטי הטירגוט שנשלחים עם בקשה להצגת מודעה.

בניגוד להגדרה הגלובלית שנקבעת באמצעות השיטה setRequestConfiguration, האובייקט AdRequest מועבר לשיטה load של מחלקת פורמט מודעה, למשל InterstitialAd.load למודעות מעברון או BannerAd.load למודעות באנר.

הוספת פרטים נוספים על רשת המודעות

כדי להעביר פרמטרים ספציפיים לרשת אל Google Mobile Ads SDK for React Native, כמו פרמטרים של מודעות שניתנות לכיווץ, משתמשים במאפיין extras.

בדוגמה הבאה מוגדר מפתח פרמטר נוסף של collapsible עם הערך bottom:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

צריך לספק כתובת URL של תוכן

כדי לספק כתובת URL של תוכן למודעות שמטורגטות לפי תוכן ולהגנה על המותג, מוסיפים את המאפיין contentUrl:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

כתובת ה-URL של התוכן יכולה להכיל עד 512 תווים.