מיקוד

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

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

למידע נוסף על:

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

טיפול בפרטיות לבעלי תוכן דיגיטלי (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)

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

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

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()

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

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