שילוב שורה עם תהליך בחירת הרשת (Mediation) (בטא)

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Line באמצעות Mediation, שכוללת שילובים של Waterfall. במאמר מוסבר איך להוסיף את Line להגדרת בחירת הרשת של יחידת מודעות, ואיך לשלב את Line SDK ואת המתאם שלו באפליקציה Android .

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

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

למתאם התהליך של Line יש את היכולות הבאות:

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

¹ Integration of Waterfall is in closed beta. You can contact your account manager to request access.

דרישות

• Android API ברמה 21 ואילך

• הגרסה העדכנית ביותר של Google Mobile Ads SDK

• מדריך לתחילת העבודה בנושא בחירת הרשת

שלב 1: הגדרת ההגדרות בממשק המשתמש של Line

נכנסים לחשבון Line.

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

לוחצים על 広告枠管理 (ניהול מיקומי מודעות) > メディア (מדיה). לאחר מכן לוחצים על 新規作成 (יצירה חדשה).

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

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

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

לוחצים על המזהה של האפליקציה שרוצים להוסיף לה מיקום מודעה. לאחר מכן, בוחרים באפשרות 詳細 (פרטים).

לוחצים על スロット 追加 (הוספת מיקום מודעה).

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

הערה: כדי ליצור מיקומי מודעות מותאמים אישית בממשק המשתמש של Line, צריך לפנות למנהל החשבון שלכם ב-Line Ads Network.

שימו לב למזהה המיקום.

שלב 2: הגדרת ביקוש לקו ב- Ad Manager UI

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

הוספת שורה ב'חברות'

בידינג

השלב הזה לא נדרש בשילובי בידינג.

מפל

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

בוחרים באפשרות Line בתור Ad network, מזינים Name ייחודי ומפעילים את Mediation.

אין צורך להזין שם משתמש או סיסמה. בסיום, לוחצים על שמירה.

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

בידינג

עוברים אל ניהול > הגדרות גלובליות. עוברים לכרטיסייה הגדרות חשבון Ad Exchange, בודקים את ההגדרה שיתוף אותות מאובטח ומפעילים אותה. לוחצים על שמירה.

מפל

השלב הזה לא נדרש בשילובים של Waterfall.

הגדרת בידינג לפי שורה

בידינג

עוברים אל Delivery (הצגה) > Bidders (מגישי הצעות מחיר), ולוחצים על New bidder (מגיש הצעות מחיר חדש) בכרטיסייה SDK Bidding (בידינג באמצעות SDK).

בוחרים באפשרות Line בתור הבידינג.

מפעילים את המתגים הוספת ספריית האותות של מגיש הצעות המחיר הזה לרשימת האותות המותרים ואישור שיתוף האותות עם מגיש הצעות המחיר הזה. לאחר מכן, לוחצים על המשך.

לוחצים על המשך.

לוחצים על סיום.

מפל

השלב הזה לא נדרש בשילובים של Waterfall.

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

בידינג

עוברים אל Delivery‏ > Bidders ובוחרים את החברה של Line בכרטיסייה SDK Bidding.

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

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

חשוב: צריך לטרגט את יחידת המודעות שנבחרה באמצעות לפחות קבוצת תשואה אחת, ומזהה האפליקציה צריך להיות משויך לאפליקציה המטורגטת, כמו בממשק המשתמש של Line.

מפל

עוברים אל Delivery (הצגה) > Yield groups (קבוצות תשואה) ולוחצים על הלחצן New yield group (קבוצת תשואה חדשה). בוחרים את האפליקציה לנייד.

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

בוחרים את החברה שיצרתם ל-Line בקטע הקודם. בוחרים באפשרות Mobile SDK mediation בתור Integration type (סוג השילוב), באפשרות Android בתור Platform (פלטפורמה) ובאפשרות Active בתור Status (סטטוס).

מזינים את Application ID (מזהה האפליקציה) ו-Slot ID (מזהה המיקום) שהתקבלו בקטע הקודם, ואת הערך של Default CPM (עלות לכל אלף חשיפות שמוגדרת כברירת מחדל). לוחצים על שמירה.

חשוב: צריך לשייך את מזהה האפליקציה לאפליקציה המטורגטת, כמו בממשק המשתמש של Line.

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:line:2.8.20240827.0")
}

שילוב ידני

1. מורידים את הגרסה האחרונה של הקובץ .aar של Line SDK ומוסיפים אותו לפרויקט.

2. עוברים אל Line adapter artifacts ב-Maven Repository של Google. בוחרים את הגרסה האחרונה, מורידים את הקובץ .aar של Line adapter ומוסיפים אותו לפרויקט.

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

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

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

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

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

פועלים לפי ההוראות המפורטות במסמכי התיעוד של Line כדי להפעיל מודעות בדיקה ב-Line.

חשוב: לפני השקת האפליקציה, צריך להשבית את מצב הבדיקה ב-Ad Manager וב-Line.

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Line, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות Line (Waterfall).

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

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

מתאם הקו תומך בפרמטר בקשה נוסף שאפשר להעביר למתאם באמצעות הכיתה LineExtras. ה-constructor של הכיתה הזו כולל את הפרמטרים הבאים:

enableAdSound

A boolean כדי לציין את מצב ברירת המחדל של התחלת הצליל במודעות באנר, במודעות ביניים ובמודעות מתגמלות.

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

Java

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

Kotlin

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

שימוש במודעות מותאמות

עיבוד מודעות

מתאם השורות מאכלס את עבור NativeAd.

שדה	נכסים שתמיד נכללים על ידי מתאם קו
כותרת
תמונה
גוף
סמל האפליקציה	^1
קריאה לפעולה
Star rating
חנות
מחיר

¹ במודעות מותאמות, ערכת ה-SDK של Line לא מספקת נכס של סמל אפליקציה. במקום זאת, מתאם Line מאכלס את סמל האפליקציה בתמונה שקופה.

קודי שגיאה

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

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

אלה הקודים וההודעות שמופיעים במתאם Line כשמודעה לא נטענת:

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

יומן השינויים של מתאם LINE לבחירת רשת (Mediation) ל-Android

הגרסה הבאה

• הטמענו את AdLoader כדי לאפשר RTB למודעות באנר.
• הטמענו את AdLoader כדי לאפשר RTB למודעות מעברון.
• הטמענו את AdLoader כדי לאפשר RTB למודעות מתגמלות.
• הטמענו את AdLoader כדי לאפשר RTB למודעות מותאמות.

גרסה 2.8.20240827.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240827.0

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 23.3.0.
• FiveAd SDK גרסה 2.8.20240827.0

גרסה 2.8.20240808.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240808.0

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 23.2.0.
• FiveAd SDK גרסה 2.8.20240808.0

גרסה 2.8.20240722.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240722.0

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 23.2.0.
• FiveAd SDK גרסה 2.8.20240722.0

גרסה 2.7.20240515.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240515.0

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 23.1.0.
• FiveAd SDK גרסה 2.7.20240515.0

גרסה 2.7.20240214.1

• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-23.0.0.
• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240214.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 23.0.0.
• גרסת ה-SDK של FiveAd היא 2.7.20240214.0.

גרסה 2.7.20240214.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240214.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.6.0.
• גרסת ה-SDK של FiveAd היא 2.7.20240214.0.

גרסה 2.7.20240126.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240126.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.6.0.
• גרסת FiveAd SDK‏ 2.7.20240126.0.

גרסה 2.7.20240112.0

• הוסר הערך הוצא משימוש FiveAdViewEventListener לטובת הערכים FiveAdCustomLayoutEventListener, ‏ FiveAdVideoRewardEventListener,‏ FiveAdInterstitialEventListener ו-FiveAdNativeEventListener.
• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240112.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 22.6.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.6.0.
• גרסת FiveAd SDK‏ 2.7.20240112.

גרסה 2.6.20230607.1

• הוספנו את הכיתה LineExtras לבעלי תוכן דיגיטלי, כדי שיוכלו להגדיר הגדרות ברירת מחדל של צלילים לפורמטים של מודעות באנר, מודעות מעברון ומודעות מתגמלות.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 22.4.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.4.0.
• גרסת ה-SDK של FiveAd היא 2.6.20230607.

גרסה 2.6.20230607.0

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

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.1.0.
• גרסת ה-SDK של FiveAd היא 2.6.20230607.