שילוב של LY Ads Network עם תהליך בחירת הרשת

בחירת פלטפורמה: Android חדש Android iOS Unity Flutter

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

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

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

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

דרישות

  • חדש מערוץ Google Mobile Ads Unity Plugin
  • ‫Unity 4 ואילך
  • ‫[לבידינג]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בגרסה 1.5.0 ואילך של Google Mobile Ads mediation plugin for LY Ads Network SDK (מומלץ להשתמש בגרסה העדכנית)
  • כדי לפרוס ב-Android
    • רמת API‏ 23 ומעלה ב-Android
  • כדי לפרוס ב-iOS
    • יעד פריסה 13.3 ומעלה ב-iOS
  • פרויקט Unity פעיל שמוגדר עם Google Mobile Ads Unity Plugin. פרטים נוספים זמינים במאמר בנושא הגדרת Google Mobile Ads Unity Plugin.
  • הגדרת תהליך בחירת הרשת.

שלב 1: הגדרת תצורות בממשק המשתמש של LY Ads Network

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

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

עוברים לכרטיסייה App (אפליקציה) ולוחצים על הלחצן New registration (רישום חדש).

הרשמה חדשה

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

טופס הרשמה חדש

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

Android

פרטי רישום

iOS

פרטי רישום

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

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

הוספת משבצת

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

הוספת טופס משבצת

רושמים את מזהה מיקום המודעה.

פרטי מיקום מודעה

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

בקשת בדיקה

יצירת מפתח API לדיווח

עוברים לכרטיסייה Managing reporting API keys (ניהול מפתחות Reporting API) ולוחצים על הלחצן Create API key (יצירת מפתח API).

הכרטיסייה Reporting API Key

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

טופס מפתח Reporting API

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

טופס מפתח Reporting API

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

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

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

שלב 2: הגדרת הביקוש של רשת LY Ads בממשק המשתמש של Ad Manager

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

Android

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

iOS

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את התוסף Google Mobile Ads LY Ads Network Mediation Plugin for Unity בפרויקט שלכם באמצעות הפקודה הבאה מספריית הבסיס של הפרויקט:

openupm add com.google.ads.mobile.mediation.line

OpenUPM

בכלי לעריכת פרויקטים ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את ההגדרות של מנהל החבילות ב-Unity.

בכרטיסייה Scoped Registries (מאגרי חבילות עם היקף), מוסיפים את OpenUPM כמאגר חבילות עם היקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפי הרשאות: com.google

פרטים על OpenUPM

אחר כך עוברים אל Window > Package Manager (חלון > כלי לניהול חבילות) כדי לפתוח את Unity Package Manager (כלי לניהול חבילות של Unity) ובוחרים באפשרות My Registries (המאגרים שלי) בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads Line Mediation ולוחצים על Install (התקנה).

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור LY Ads Network מקישור ההורדה ביומן השינויים ומחלצים את GoogleMobileAdsLineMediation.unitypackage מקובץ ה-ZIP.

בכלי לעריכת פרויקטים ב-Unity, בוחרים באפשרות Assets (נכסים) > Import Package (ייבוא חבילה) > Custom Package (חבילה מותאמת אישית) ומחפשים את הקובץ GoogleMobileAdsLineMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל תלות חיצוני > Android Resolver > Force Resolve (פתרון בכוח). ספריית External Dependency Manager (ניהול יחסי תלות חיצוניים) תבצע פתרון של יחסי תלות מאפס ותעתיק את יחסי התלות שהוגדרו לספרייה Assets/Plugins/Android של אפליקציית Unity.

אילוץ פתרון בעיה

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

Android

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

iOS

שילוב עם SKAdNetwork

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

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

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

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

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

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

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

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

התוסף לבחירת רשת של LY Ads Network Unity תומך בפרמטר הבקשה הנוסף הבא, שאפשר להעביר למתאם דרך המחלקה LineMediationExtras:

  • ‫SetEnableAdSound(boolean) : מציין את מצב ההתחלה של הצליל כברירת מחדל במודעות באנר, במודעות מעברון ובמודעות מתגמלות.

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

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-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 טעינת המודעה המותאמת נכשלה בגלל נכסים חסרים.

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 טעינת נכס התמונה של סמל המידע במודעה המקורית נכשלה.

יומן השינויים של פלאגין מנגנון בחירת הרשת של Unity

גרסה 2.1.0

גרסה 2.0.2

גרסה 2.0.1

גרסה 2.0.0

גרסה 1.5.10

גרסה 1.5.9

גרסה 1.5.8

גרסה 1.5.7

גרסה 1.5.6

גרסה 1.5.5

  • תוקנה בעיה שבה התקנה דרך OpenUPM גרמה לכך שהפלאגין לא ייבא את החבילות כמו שצריך.

גרסה 1.5.4

גרסה 1.5.3

גרסה 1.5.2

גרסה 1.5.1

גרסה 1.5.0

גרסה 1.4.0

גרסה 1.3.1

גרסה 1.3.0

גרסה 1.2.0

גרסה 1.1.2

גרסה 1.1.1

גרסה 1.1.0

גרסה 1.0.0