מיקוד

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

להורדת הדגמת API

ידע מוקדם שנדרש לקורס

• מבצעים את ההוראות שמופיעות במדריך לתחילת העבודה.

RequestConfiguration

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

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

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

הגדרת תוכן לילדים

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

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

אפשר להשתמש בהגדרה הזו בכל הגרסאות של Google Play Services SDK באמצעות RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• קוראים לפונקציה setTagForChildDirectedTreatment עם TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE כדי לציין שאתם רוצים שהתוכן שלכם יטופל כתוכן לילדים למטרות של COPPA. הפעולה הזו מונעת העברה של מזהה הפרסום של Android (AAID).

• קוראים לפונקציה setTagForChildDirectedTreatment עם TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE כדי לציין שאינכם רוצים שהתוכן שלכם יטופל כתוכן לילדים למטרות של COPPA.

• אתם יכולים להתקשר אל setTagForChildDirectedTreatment באמצעות TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED, אם אתם לא רוצים לציין בבקשות להצגת מודעות איך התוכן שלכם יטופל ביחס ל-COPPA.

הדוגמה הבאה מראה שאתם רוצים להתייחס לתוכן שלכם כתוכן לילדים בהתאם ל-COPPA:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

הערה: באפליקציות שבתוכנית 'לכל המשפחה' בתור אפליקציות שמיועדות לילדים בעיקר ומשתמשים שמחוברים לחשבונות Google שמנוהלים באמצעות Family Link יטופלו כאפליקציות שמיועדות לילדים בעיקר בכל הבקשות להצגת מודעות}{/15.{/15

משתמשים מתחת לגיל ההסכמה

אפשר לסמן בקשות להצגת מודעות כך שהן יטופלו עבור משתמשים מתחת לגיל ההסכמה שנמצאים באזור הכלכלי האירופי (EEA). פיתחנו את התכונה הזאת כדי לעזור לכם לציית ל-General Data Protection Regulation (התקנה הכללית להגנה על מידע (GDPR)). שימו לב: ייתכן שיש לכם התחייבויות משפטיות נוספות בכפוף ל-GDPR. מומלץ לקרוא את ההנחיות של האיחוד האירופי ולהתייעץ עם יועץ משפטי. שימו לב שהכלים של Google מיועדים לאפשר תאימות ואינם פוטרים בעלי תוכן דיגיטלי מהמחויבויות שלהם בכפוף לחוק. למידע נוסף בנושא ההשפעה של GDPR על בעלי תוכן דיגיטלי

כשמשתמשים בתכונה הזו, הבקשה להצגת מודעה כוללת פרמטר 'תג למשתמשים מתחת לגיל ההסכמה באירופה' (TFUA). הפרמטר הזה משבית בכל הבקשות להצגת מודעות את הפרסום המותאם אישית, כולל רימרקטינג. בנוסף, הוא משבית את הבקשות לספקי מודעות של צד שלישי, כמו פיקסלים למדידת מודעות ובקשות לשרתי מודעות של צד שלישי.

בדומה להגדרות של תוכן לילדים, ב-RequestConfiguration.Builder יש שיטה להגדרת הפרמטר TFUA: setTagForUnderAgeOfConsent(), עם האפשרויות הבאות.

• להתקשר למספר setTagForUnderAgeOfConsent() עם TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE כדי לציין שאתם רוצים שהבקשה להצגת מודעה תקבל טיפול למשתמשים באזור הכלכלי האירופי (EEA) שהם מתחת לגיל ההסכמה. הפעולה הזו גם מונעת העברה של מזהה הפרסום של Android (AAID).

• להתקשר למספר setTagForUnderAgeOfConsent() עם TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE כדי לציין שאתם רוצים שהבקשה להצגת מודעה לא תטופל כמשתמשים באזור הכלכלי האירופי (EEA) מתחת לגיל ההסכמה.

• מתקשרים אל setTagForUnderAgeOfConsent() עם TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED כדי לציין שלא ציינתם אם הבקשה להצגת מודעה צריכה להתאים למשתמשים שנמצאים באזור הכלכלי האירופי (EEA) מתחת לגיל ההסכמה.

הדוגמה הבאה מראה שאתם רוצים ש-TFUA ייכלל בבקשות להצגת מודעות:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

אסור להגדיר בו-זמנית את התגים שמפעילים את ההגדרה 'מותאם לילדים' וגם setTagForUnderAgeOfConsent() ל-true. אם כן, ההגדרה 'תוכן לילדים' מקבלת עדיפות.

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

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

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

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

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

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

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

בקישורים הבאים תוכלו לקבל מידע נוסף על:

• הגדרת סיווג תוכן מקסימלי לכל בקשה להצגת מודעה

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

הערה: הגדרות סינון התוכן שצוינו דרך Google Mobile Ads SDK מבטלות את כל ההגדרות שנקבעו באמצעות Ad Manager ממשק המשתמש.

שירות ההגנה על הפרטיות של בעלי תוכן דיגיטלי (בטא)

טיפול בבעלי תוכן דיגיטלי בנושא פרטיות (PPT) API הוא כלי אופציונלי שמאפשר לאפליקציות לציין אם להשבית את ההתאמה האישית של המודעות לכל הבקשות להצגת מודעות באמצעות השיטה setPublisherPrivacyPersonalizationState(). כשמשתמשים בתכונה הזו, פרמטר של טיפול בפרטיות של בעלי תוכן דיגיטלי (PPT) נכלל בכל הבקשות העתידיות להצגת מודעות עד סוף הסשן.

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

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

הערה: בבקשות להצגת מודעות שיש בהן כמה אותות לשמירה על הפרטיות של המשתמשים, האות המגביל ביותר יקבל עדיפות. אפשר לעיין במסמכים Publisher Privacy Treatment API דוגמאות ספציפיות.

בקשה להצגת מודעה

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

מיקוד מותאם אישית

אפשר להעביר צמדי מפתח/ערך מותאמים אישית כדי לטרגט קמפיינים של Google Ad Manager (פריטים) עד AdManagerAdRequest.Builder.addCustomTargeting():

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

Kotlin

// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

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

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

ראו את הדוגמה למיקוד מותאם אישית ב-Ad Manager כדי להבין יישום של מיקוד מותאם אישית באפליקציית ההדגמה של Android API.

החרגות של קטגוריות

אפשר להוסיף לבקשה רמת החרגה של קטגוריה ברמת המיקום באמצעות השיטה addCategoryExclusion() שמסופקת על ידי AdManagerAdRequest.Builder:

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

Kotlin

// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

תוכלו להיעזר בדוגמה להחרגות של קטגוריות ב-Ad Manager כדי להבין איך להטמיע החרגות של קטגוריות באפליקציית ההדגמה של Android API.

מזהים שניתנו על ידי בעל התוכן הדיגיטלי

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

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

דוגמה להגדרת ה-PPID:

Java

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setPublisherProvidedId("AB123456789")
    .build();

Kotlin

var adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

תוכלו להיעזר בדוגמה ל-PPID של Ad Manager כדי להטמיע מזהים שסופקו על ידי בעל התוכן הדיגיטלי (PPID) באפליקציית ההדגמה של Android API.

אותות שמספקים בעלי תוכן דיגיטלי

אפשר לשלוח נתונים של קהלים ונתונים הקשריים בתור אותות שמספקים בעלי תוכן דיגיטלי (PPS) בבקשות להצגת מודעות. בעזרת PPS, ניתן לך להציג את מאפייני הקהל למגישי הצעות מחיר בכל סוגי הטרנזקציות, באמצעות טקסונומיות סטנדרטיות, על סמך טקסונומיות סטנדרטיות, על מנת לשפר את המונטיזציה הפרוגרמטית. מאפייני הקהל יכולים לכלול נתונים על התנהגות ותחומי עניין (טקסונומיה 1.1 של קהל IAB) ונתונים לפי הקשר (טקסונומיה 2.2 של תוכן IAB).

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build()

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

כתובת URL של תוכן

כדי לספק כתובת URL של תוכן לצורך הצגת מודעות שמטורגטות לפי תוכן והגנה על המותג, אפשר לבצע קריאה אל setContentUrl() בזמן יצירת AdManagerAdRequest:

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()

הגנה על המותג (בטא)

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

אפליקציות שמציגות תוכן דינמי שמיועד לקהלים שונים יכולות לספק רשימה קצרה של כתובות URL באמצעות השיטה setNeighboringContentUrls() כשיוצרים AdManagerAdRequest:

Java

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

Kotlin

var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

ההבדל בין .setNeighboringContentUrls() לבין .setContentUrl() הוא שהוא משמש רק להגנה על המותג.

הערה: ב-setNeighboringContentUrls נעשה שימוש רק בארבע כתובות ה-URL הראשונות ברשימה. המערכת מתעלמת מהאחרים.