שילוב של PubMatic עם תהליך בחירת הרשת (Mediation) ב-AdMob

בחירת פלטפורמה: Android iOS Unity Flutter React Native Android (גרסה קודמת)

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

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

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

שילוב
בידינג
Waterfall
פורמטים
מודעות בפתיחת האפליקציה
מודעת באנר
מעברון	^1
ההטבה הופעלה	^1
מודעות מעברון מתגמלות
מותאם	^1

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

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

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

• הגרסה העדכנית של Google Mobile Ads SDK for React Native.
• ‫React Native framework בגרסה 0.85.0 ואילך.
• כדי לפרוס ב-Android
  • ‫Android API ברמת API 24 ומעלה.
• כדי לפרוס ב-iOS
  • יעד פריסה 13.0 ומעלה ב-iOS.
• פרויקט React Native פעיל שמוגדר עם Google Mobile Ads SDK for React Native. פרטים נוספים מופיעים במאמר הגדרת Google Mobile Ads SDK for React Native.
  • מוודאים שהורדתם וחילצתם את התיקייה adapters מהתיקייה gma-sdk-react-native. אם התיקייה adapters לא קיימת, מבצעים את השלבים 1, 2 ו-3 בקטע התקנת Google Mobile Ads SDK for React Native.
• הגדרת תהליך בחירת הרשת (Mediation) ב-AdMob.

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

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

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

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

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

Android

בקטע Integration Path, בוחרים באפשרות React Native ובקטע Sub-integration Path בוחרים באפשרות AdMob - SDK Bidding. אחר כך לוחצים על הכפתור הוספת אפליקציה.

iOS

בקטע Integration Path, בוחרים באפשרות React Native ובקטע Sub-integration Path בוחרים באפשרות AdMob - SDK Bidding. אחר כך לוחצים על הכפתור הוספת אפליקציה.

עדכון של הקובץ 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 OpenWrap SDK בממשק המשתמש של AdMob

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

Android

הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

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

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

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

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

הערה: אם לא תשלבו את הגרסאות התואמות של PubMatic ו-Google Mobile Ads SDK for React Native, יכול להיות שיהיו בעיות ב-build.

בתיקיית השורש של הפרויקט, מתקינים את Google Mobile Ads SDK for React Nativeהמתאם של PubMatic OpenWrap SDK לתהליך בחירת הרשת. צריך לבצע את השלבים הבאים:

1. מעתיקים את קובץ ה-tar של המתאם Google Mobile Ads SDK for React Native מהספרייה gma-sdk-react-native/adapters/pubmatic/ לספרייה local_packages/ של הפרויקט. אם התיקייה adapters לא קיימת, עיינו בקטע דרישות מוקדמות.

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/pubmatic/gma-mediation-pubmatic-0.1.0.tgz local_packages/
   

   מחליפים את EXTRACT_DIR בנתיב לספרייה שבה חילצתם את קובץ הארכיון.

2. מתקינים את חבילת המתאם באמצעות הכלי המועדף לניהול חבילות:

   npm

   npm install ./local_packages/gma-mediation-pubmatic-0.1.0.tgz
   

   חוטי סריגה

   yarn add ./local_packages/gma-mediation-pubmatic-0.1.0.tgz
   

3. אם אתם מפתחים ל-Android, הוסיפו את המאגר הבא לקובץ build.gradle בספרייה android של הפרויקט:

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

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

‫GDPR והסכמה בהתאם ולתקנות האירופאיות

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

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

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

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

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

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

Android

לא נדרש קוד נוסף לשילוב עם PubMatic.

iOS

שילוב של SKAdNetwork

פועלים לפי ההוראות במאמרי העזרה של PubMatic OpenWrap SDK כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.

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

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

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

חשוב: לפני שמפרסמים את האפליקציה, צריך להשבית את מצב הבדיקה ב-AdMob וב-PubMatic OpenWrap SDK.

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

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

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-PubMatic, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo במחלקות הבאות:

Android

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

iOS

GADMediationAdapterPubMatic

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

Android

קוד שגיאה	דומיין	סיבה
101	com.google.ads.mediation.pubmatic	בהגדרות השרת חסר מזהה בעל אפליקציה שנדרש.
102	com.google.ads.mediation.pubmatic	פורמט המודעה לא נתמך על ידי PubMatic או חסר בנתוני האותות של הבידינג בזמן אמת (RTB).
103	com.google.ads.mediation.pubmatic	המודעה לא הוצגה כי היא לא הייתה מוכנה.
104	com.google.ads.mediation.pubmatic	מזהה הפרופיל חסר או לא תקין.
105	com.google.ads.mediation.pubmatic	מזהה יחידת המודעות חסר או ריק.
106	com.google.ads.mediation.pubmatic	המודעה המתגמלת שהוחזרה היא null.
107	com.google.ads.mediation.pubmatic	גודל מודעת הבאנר לא תקין.
1001-5002	נשלח על ידי PubMatic SDK	ה-SDK של PubMatic החזיר שגיאה. פרטים נוספים זמינים במאמרי העזרה של PubMatic.

iOS

קוד שגיאה	דומיין	סיבה
101	com.google.ads.mediation.pubmatic	בהגדרות השרת חסר מזהה בעל אפליקציה שנדרש.
102	com.google.ads.mediation.pubmatic	הבקשה לאיסוף אותות בידינג נכשלה כי צוינו בפרמטרים של הבקשה כמה פורמטים, לא צוין פורמט או צוין פורמט לא נתמך.
103	com.google.ads.mediation.pubmatic	הגדרת המודעה לא תקינה לטעינת מודעה.
104	com.google.ads.mediation.pubmatic	הצגת מודעת המעברון נכשלה כי המודעה לא הייתה מוכנה.
105	com.google.ads.mediation.pubmatic	המודעה המתגמלת לא הוצגה כי היא לא הייתה מוכנה.
106	com.google.ads.mediation.pubmatic	טעינת אחד ממקורות התמונות של המודעה המותאמת נכשלה.
107	com.google.ads.mediation.pubmatic	בהגדרת המודעה חסר מזהה בעל האפליקציה.
108	com.google.ads.mediation.pubmatic	בהגדרת המודעה חסר מזהה פרופיל.
109	com.google.ads.mediation.pubmatic	הגדרת המודעה מכילה מזהה פרופיל שהוא לא מספר.
110	com.google.ads.mediation.pubmatic	בהגדרת המודעה חסר מזהה יחידת מודעות.
111	com.google.ads.mediation.pubmatic	‫PubMatic OpenWrap SDK לא הצליח ליצור מופע של גודל מודעה.
1001-5002	נשלח על ידי PubMatic SDK	ה-SDK של PubMatic החזיר שגיאה. פרטים נוספים זמינים במאמרי העזרה של PubMatic.

גרסה 0.1.0

• הגרסה הראשונה.

• תמיכה בגרסה 5.3.0.1 של מתאם PubMatic ל-Android.
• תמיכה בגרסה 5.3.0.0 של מתאם PubMatic ל-iOS.
• נבנה ונבדק עם גרסה 0.1.0 של הפלאגין למודעות לנייד של Google ל-React Native.