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

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

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

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

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

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

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

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

• הגרסה העדכנית של 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: קובעים את ההגדרות בממשק המשתמש של רשת המודעות של LY

נרשמים ונכנסים לחשבון LY Ads Network.

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

עוברים לכרטיסייה App ולוחצים על הכפתור New registration.

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

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

שימו לב למזהה האפליקציה.

Android

iOS

יצירת מיקום מודעה בדף

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

ממלאים את הטופס עם פרטי המשבצת. בקטע Bidding Type (סוג הבידינג), בוחרים באפשרות Standard (רגיל) כדי להגדיר את המיקום הזה לרשימת רשתות בתהליך בחירת רשת, או באפשרות Google SDK Bidding (בידינג מבוסס SDK חיצוני של Google) כדי להגדיר את המיקום הזה לבידינג. אחרי שממלאים את הטופס, לוחצים על יצירה.

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

שימו לב לערך של מזהה המשבצת.

אחרי שיוצרים את מיקום המודעה הראשון, לוחצים על בדיקה בדף הפרטים של האפליקציה כדי לקבל אישור מ-LY רשת מודעות. יכול להיות שזה ייקח קצת זמן. אם יש לכם שאלות, אתם יכולים לפנות לנציג של LY Ads Network.

יצירת מפתח Reporting API

עוברים לכרטיסייה Managing reporting API keys ולוחצים על הכפתור Create API key.

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

שימו לב למזהה מפתח ה-API ולסוד מפתח ה-API.

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

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

כדי להטמיע את app-ads.txt ב-LY Ads Network, אפשר לעיין במאמר מידע על app-ads.txt.

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

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

Android

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

iOS

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

שלב 3: מייבאים את ה-SDK והמתאם של LY Ads Network

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

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

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

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

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

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

   npm

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

   חוטי סריגה

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

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

Android

לא נדרש קוד נוסף כדי לשלב את LY Ads Network.

iOS

שילוב של SKAdNetwork

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

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

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

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

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

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-LY Ads Network, הפעילו בדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות של LY Ads Network.

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

פרמטרים ספציפיים לרשת

הפלאגין של LY Ads Network לתהליך בחירת הרשת ב-React Native תומך בפרמטר הבא של בקשה נוספת, שאפשר להעביר למתאם דרך המחלקה LineMediationExtras:

• ‫enableAdSound : מציין את מצב ברירת המחדל של הצליל בתחילת ההפעלה של מודעות באנר, מודעות מעברון ומודעות מתגמלות.

הנה דוגמה לקוד שמראה איך ליצור בקשה להצגת מודעה שמגדירה את הפרמטרים האלה:

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

קודי שגיאה

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

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

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

Android

קוד שגיאה	דומיין	סיבה
1-10	com.five_corp.ad	‫LY Ads Network SDK החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LY Ads Network.
101	com.google.ads.mediation.line	מזהה האפליקציה חסר או לא תקין.
102	com.google.ads.mediation.line	מזהה המיקום חסר או לא תקין.
103	com.google.ads.mediation.line	גודל המודעה המבוקש לא תואם לגודל של מודעת באנר שנתמך ב-LY Ads Network.
104	com.google.ads.mediation.line	הטעינה של מודעת מעברון או מודעה מתגמלת נכשלה כי חסר הקשר לפעילות.
105	com.google.ads.mediation.line	‫LY Ads Network SDK לא הצליח להציג מודעת מעברון או מודעה מתגמלת.
106	com.google.ads.mediation.line	המודעה המותאמת לא נטענה כי חסרים נכסים.
107	com.google.ads.mediation.line	‫FiveAd SDK החזיר טוען מודעות מסוג null.

iOS

קוד שגיאה	דומיין	סיבה
1-10	נשלח על ידי LY Ads Network SDK	‫LY Ads Network SDK החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LY Ads Network.
101	com.google.ads.mediation.line	פרמטרים לא תקינים של השרת (למשל, חסר מזהה אפליקציה או מזהה מיקום מודעה).
102	com.google.ads.mediation.line	גודל המודעה המבוקש לא תואם לגודל של מודעת באנר שנתמך ב-LY Ads Network.
103	com.google.ads.mediation.line	נכס התמונה של סמל המידע לא נטען במודעה מותאמת.
104	com.google.ads.mediation.line	איסוף האותות לבידינג נכשל.
105	com.google.ads.mediation.line	האתחול של טוען המודעות ב-LINE Ads SDK נכשל.

גרסה 0.1.0

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

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