הטמעה של PubMatic OpenWrap (בטא) בתהליך בחירת הרשת (Mediation) ב-AdMob

במדריך הזה מוסבר איך להשתמש ב-GMA Next-Gen SDK כדי לטעון ולהציג מודעות לרשת המדיה מ-PubMatic באמצעות תהליך בחירת הרשת (Mediation) ב-AdMob. המדריך כולל הסברים על שילובים של שיטת ה-Waterfall ושל בידינג. המדריך כולל הסבר על הוספת PubMatic OpenWrap SDK להגדרת תהליך בחירת הרשת של יחידת מודעות, ועל שילוב של PubMatic OpenWrap SDK ומתאם באפליקציה ל-Android.

שילובים ופורמטים נתמכים של מודעות

מתאם תהליך בחירת הרשת של PubMatic כולל את היכולות הבאות:

¹ השילוב של Waterfall נמצא בשלב אלפא.

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

לפני שממשיכים, צריך לוודא את הפרטים הבאים:

• ‫Android API ברמה 24 ואילך.

• הגרסה העדכנית של GMA Next-Gen SDK.

• הגדרת תהליך בחירת הרשת (Mediation) ב-AdMob.

שלב 1: קובעים את ההגדרות בממשק המשתמש של PubMatic

נרשמים או מתחברים לחשבון PubMatic ובוחרים בכרטיס OpenWrap SDK.

הוספת אפליקציה חדשה

עוברים לכרטיסייה אפליקציות ולוחצים על הכפתור הוספת אפליקציה.

בוחרים את Platform (הפלטפורמה), את App Store URL (כתובת ה-URL של חנות האפליקציות) ואת App Name (שם האפליקציה).

בקטע Integration Path (נתיב השילוב), בוחרים באפשרות Android (Java / Kotlin), ובקטע Sub-integration Path (נתיב משנה לשילוב) בוחרים באפשרות AdMob - SDK Bidding (AdMob – בידינג מבוסס SDK חיצוני). אחר כך לוחצים על הכפתור הוספת אפליקציה.

עדכון של הקובץ app-ads.txt

‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

לפני שהאפליקציה תהיה מוכנה, יוצגו לכם הרשומות המתאימות שצריך להוסיף לקובץ app-ads.txt.

מידע נוסף על הטמעת app-ads.txt ב-PubMatic זמין במאמר How to Implement app-ads.txt (איך להטמיע את app-ads.txt).

מזהה פרופיל

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

יצירה של יחידת מודעות

בכרטיסייה Ad Units, בוחרים את האפליקציה שיצרתם בקטע הקודם ולוחצים על הכפתור Create Ad Unit.

ממלאים את הטופס עם הפרטים של יחידת המודעות ולוחצים על שמירה.

רושמים את מזהה יחידת המודעות החדש ב-OpenWrap.

איך מקבלים את מזהה בעל האפליקציה

עוברים אל מרכז הבקרה של Analytics. מעבירים את העכבר מעל סמל הפרופיל ורושמים את המזהה.

שלב 2: מגדירים את הביקוש של PubMatic בממשק המשתמש של AdMob

קביעת ההגדרות של תהליך בחירת הרשת ליחידת המודעות

צריך להוסיף את PubMatic OpenWrap SDK להגדרת תהליך בחירת הרשת של יחידת המודעות.

קודם כול, נכנסים לחשבון AdMob. עוברים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש לכם קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, לחצו על השם של הקבוצה כדי לערוך אותה ודלגו לשלב הוספת PubMatic OpenWrap SDK כמקור מודעות.

כדי ליצור קבוצה חדשה לבחירת רשת, לוחצים על יצירת קבוצה לבחירת רשת (Mediation).

מזינים את פורמט המודעה ואת הפלטפורמה ולוחצים על המשך.

נותנים שם לקבוצה לבחירת רשת ובוחרים את המיקומים לטירגוט. אחר כך מגדירים את הסטטוס של קבוצה לבחירת רשת (Mediation) ל-מופעל ולוחצים על הוספת יחידות מודעות.

משייכים את הקבוצה הזו לבחירת רשת לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. אחר כך לוחצים על סיום.

עכשיו אמור להופיע כרטיס יחידות המודעות עם יחידות המודעות שבחרתם:

הוספת PubMatic OpenWrap SDK כמקור מודעות

בידינג

בקטע מקורות מודעות, מאתרים את הכרטיס בידינג ולוחצים על הוספת מקור מודעות. אחר כך בוחרים באפשרות PubMatic OpenWrap SDK.

לוחצים על אישור והסכמה ואז על שמירה.



אם כבר יש לכם מיפוי ל-PubMatic OpenWrap SDK, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.



אחר כך מזינים את מזהה יחידת המודעות ב-OpenWrap שקיבלתם בקטע הקודם. אחר כך לוחצים על סיום.

מפל

בכרטיס Waterfall שבקטע מקורות מודעות, לוחצים על הוספת מקור מודעות.

בוחרים באפשרות PubMatic OpenWrap SDK. אחר כך מזינים ערך של עלות בפועל לאלף חשיפות (eCPM) ל-PubMatic OpenWrap SDK ולוחצים על המשך.




אם כבר יש לכם מיפוי ל-PubMatic OpenWrap SDK, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.



בשלב הבא, מזינים את מזהה יחידת המודעות ב-OpenWrap שקיבלתם בקטע הקודם. אחר כך לוחצים על סיום.

הוספת PubMatic לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב

כדי להוסיף בממשק המשתמש של AdMob את PubMatic לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

שלב 3: מייבאים את ה-SDK והמתאם של PubMatic OpenWrap

שילוב עם Android Studio (מומלץ)

בקובץ settings.gradle.kts ברמת הפרויקט, מוסיפים את המאגרים הבאים:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
  }
}

לאחר מכן, בקובץ build.gradle.kts ברמת האפליקציה, מוסיפים את יחסי התלות וההגדרות הבאים להטמעה. משתמשים בגרסאות העדכניות ביותר של ה-SDK והמתאם של PubMatic OpenWrap SDK:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

שלב 4: מטמיעים את הגדרות הפרטיות ב-PubMatic

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

גרסה 4.7.0.0 ואילך של מתאם PubMatic OpenWrap SDK ל-Android תומכת בהעברת אותות הסכמה בהתאם ל-GDPR מפלטפורמות לניהול הסכמה (CMP) שמשולבות ב-Transparency and Consent Framework (TCF – מסגרת השקיפות וההסכמה) של IAB אל PubMatic OpenWrap SDK. מידע נוסף זמין במאמר העברת נתונים לגבי GDPR והסכמה בהתאם ל-GDPR.

דיני פרטיות במדינות בארה"ב

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

פלטפורמת PubMatic קוראת באופן אוטומטי את ההסכמה ב-GPP שמוגדרת על ידי פלטפורמות לניהול הסכמה שתומכות במפרט "הסכמה נוספת" של Google, כולל UMP SDK. מידע נוסף זמין במאמר העברת הסכמה של GPP.

‫שלב 5: מוסיפים את הקוד הנדרש

לא נדרש קוד נוסף לשילוב של PubMatic OpenWrap SDK.

שלב 6: בודקים את ההטמעה

הפעלת מודעות בדיקה

חשוב לוודא שרשמתם את מכשיר הבדיקה ב-AdMob.

אימות מודעות בדיקה

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-PubMatic OpenWrap SDK, הפעילו בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות של PubMatic OpenWrap.

שלבים אופציונליים

מודעות מותאמות

רינדור מודעות

המתאם של PubMatic מחזיר את המודעות המותאמות שלו כאובייקטים של NativeAd. הוא מאכלס את השדות הבאים של NativeAd.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-PubMatic, אפשר לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo.getAdSourceResponses() במחלקות הבאות:

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של PubMatic כשהטעינה של מודעה נכשלת:

יומן השינויים של מתאם תהליך בחירת הרשת של PubMatic ל-Android

הגרסה הבאה

• המתאם עודכן כך שישתמש ב-API של InitializationCompleteCallback.onInitializationFailed(AdError).

גרסה 5.4.1.0

• רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-24.
• תאימות מאומתת עם Pubmatic SDK בגרסה 5.4.1.

נבנה ונבדק עם:

• גרסה 25.5.0 של Google Mobile Ads SDK.
• גרסה 1.5.0 של Google Mobile Ads Next-Gen SDK.
• ‫Pubmatic SDK גרסה 5.4.1

גרסה 5.4.0.0

• תאימות מאומתת עם Pubmatic SDK 5.4.0.

נבנה ונבדק עם:

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.4.0 של Google Mobile Ads Next-Gen SDK.
• ‫Pubmatic SDK בגרסה 5.4.0

גרסה 5.3.0.1

• מצמידים את התלות של המתאם ב-Kotlin לגרסה 1.9.0 (גרסת Kotlin המינימלית שנתמכת על ידי GMA NextGen SDK).

נבנה ונבדק עם:

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.4.0 של Google Mobile Ads Next-Gen SDK.
• גרסה 5.3.0 של Pubmatic SDK

גרסה 5.3.0.0

• תאימות מאומתת עם Pubmatic SDK 5.3.0.

נבנה ונבדק עם:

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.4.0 של Google Mobile Ads Next-Gen SDK.
• גרסה 5.3.0 של Pubmatic SDK

גרסה 5.2.0.0

• אימות התאימות ל-Pubmatic SDK בגרסה 5.2.0.

נבנה ונבדק עם:

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.3.0 של Google Mobile Ads Next-Gen SDK.
• ‫Pubmatic SDK גרסה 5.2.0

גרסה 5.1.2.2

• ממפה את AgeRestrictedTreatment ל-COPPA API של PubMatic.

נבנה ונבדק עם:

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
• ‫Pubmatic SDK גרסה 5.1.2

גרסה 5.1.2.1

• נוספה תמיכה במודעות וידאו מותאמות(VAST) באמצעות PubMatic OpenWrapSDK MediaView API.

נבנה ונבדק עם:

• גרסה 25.2.0 של Google Mobile Ads SDK.
• גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
• ‫Pubmatic SDK גרסה 5.1.2

גרסה 5.1.2.0

• תאימות מאומתת עם Pubmatic SDK 5.1.2.

נבנה ונבדק עם:

• גרסה 25.2.0 של Google Mobile Ads SDK.
• גרסה 1.1.0 של Google Mobile Ads Next-Gen SDK.
• ‫Pubmatic SDK גרסה 5.1.2

גרסה 5.1.1.0

• תאימות מאומתת עם Pubmatic SDK 5.1.1.

נבנה ונבדק עם:

• גרסה 25.2.0 של Google Mobile Ads SDK.
• גרסה 1.0.1 של Google Mobile Ads Next-Gen SDK.
• ‫Pubmatic SDK גרסה 5.1.1

גרסה 5.1.0.0

• תאימות מאומתת עם Pubmatic SDK בגרסה 5.1.0.

נבנה ונבדק עם:

• גרסה 25.2.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 5.1.0

גרסה 5.0.0.1

• נוסף מאפיין ליצירת המתאם עם תלות ב-GMA Next-Gen SDK.
• תוקן באג שגרם לכך שהאובייקט mediationUtils לא אותחל.

נבנה ונבדק עם:

• גרסה 25.1.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 5.0.0

גרסה 5.0.0.0

• תאימות מאומתת עם Pubmatic SDK 5.0.0.

נבנה ונבדק עם:

• גרסה 25.0.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 5.0.0

גרסה 4.12.0.0

• תאימות מאומתת עם Pubmatic SDK 4.12.0.

נבנה ונבדק עם:

• גרסה 24.9.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 4.12.0

גרסה 4.11.0.1

• נוספה תמיכה בהעברת הפרמטר tagForUnderAgeOfConsent של Google Mobile Ads SDK ל-PubMatic SDK.

נבנה ונבדק עם:

• גרסה 24.9.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 4.11.0

גרסה 4.11.0.0

• תאימות מאומתת עם Pubmatic SDK 4.11.0.

נבנה ונבדק עם:

• גרסה 24.9.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 4.11.0

גרסה 4.10.0.1

• נוספה רשימת נכסים לפורמט מודעה מותאמת ב-Waterfall.

נבנה ונבדק עם:

• גרסה 24.7.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 4.10.0

גרסה 4.10.0.0

• תאימות מאומתת עם Pubmatic SDK 4.10.0.

נבנה ונבדק עם:

• גרסה 24.7.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 4.10.0

גרסה 4.9.1.0

• תאימות מאומתת עם Pubmatic SDK 4.9.1.

נבנה ונבדק עם:

• גרסה 24.6.0 של Google Mobile Ads SDK.
• גרסת Pubmatic SDK‏ 4.9.1

גרסה 4.8.0.1

• נוספה תמיכה במודעות מעברון ב-Waterfall.
• נוספה תמיכה במודעות מתגמלות ב-Waterfall.
• נוספה תמיכה במודעות באנר ב-Waterfall.
• נוספה תמיכה במודעות מותאמות ב-Waterfall.
• תאימות מאומתת עם Pubmatic SDK 4.8.0.

נבנה ונבדק עם:

• גרסה 24.6.0 של Google Mobile Ads SDK.
• ‫Pubmatic SDK גרסה 4.8.0

גרסה 4.8.0.0

• תאימות מאומתת עם Pubmatic SDK 4.8.0.

נבנה ונבדק עם:

• גרסה 24.4.0 של Google Mobile Ads SDK.
• גרסה 4.8.0 של Pubmatic SDK.

גרסה 4.7.1.1

• גודל קבוע של הסמל של AdChoices

נבנה ונבדק עם:

• גרסה 24.4.0 של Google Mobile Ads SDK.
• גרסת Pubmatic SDK‏ 4.7.1.

גרסה 4.7.1.0

• תאימות מאומתת עם Pubmatic SDK 4.7.1.

נבנה ונבדק עם:

• גרסה 24.4.0 של Google Mobile Ads SDK.
• גרסת Pubmatic SDK‏ 4.7.1.

גרסה 4.7.0.1

• תוקנו יחסי תלות פנימיים.

נבנה ונבדק עם:

• גרסה 24.4.0 של Google Mobile Ads SDK.
• גרסת Pubmatic SDK‏ 4.7.0.

גרסה 4.7.0.0

• הגרסה הראשונה.
• נוספה תמיכה בבידינג לפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• תאימות מאומתת עם Pubmatic SDK 4.7.0.

נבנה ונבדק עם:

• גרסה 24.4.0 של Google Mobile Ads SDK.
• גרסת Pubmatic SDK‏ 4.7.0.