שילוב של PubMatic בבידינג

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

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

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

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

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

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

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

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

• הגדרת תהליך בחירת הרשת.

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

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

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

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

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

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

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

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

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

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

מזהה פרופיל

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

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

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

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

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

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

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

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

נכנסים לחשבון ניהול Ad Manager.

הוספת PubMatic OpenWrap SDK בקטע "חברות"

הפעלת שיתוף אותות מאובטחים

שיתוף אותות מאובטחים בבקשות להצעות מחיר

איך מאפשרים שיתוף של אותות מאובטחים בבידינג מבוסס SDK חיצוני

הגדרת בידינג ב-PubMatic OpenWrap SDK

הגדרת מיפוי של יחידות מודעות

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

כדי להוסיף בממשק המשתמש של Ad Manager את 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.5.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) של האיחוד האירופי. באחריותכם לוודא שההסכמה מועברת לכל מקור מודעות בשרשרת לבחירת רשת.

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

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

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

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

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

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

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

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

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

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

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

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

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

עיבוד מודעות

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

קודי שגיאה

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

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

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

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

גרסה 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.
• גרסה 5.1.2 של Pubmatic SDK

גרסה 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.
• גרסה 5.1.2 של Pubmatic SDK

גרסה 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.
• גרסה 5.1.2 של Pubmatic SDK

גרסה 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.
• גרסה 5.0.0 של Pubmatic SDK

גרסה 5.0.0.0

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

פותח ונבדק עם:

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

גרסה 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.