שילוב של Moloco עם תהליך בחירת הרשת

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

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

מתאם הגישור של Moloco ל-Ad Manager כולל את היכולות הבאות:

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

דרישות

  • הגרסה העדכנית של Google Mobile Ads SDK
  • ‫Flutter 3.7.0 ומעלה
  • כדי לפרוס ב-Android
    • רמת API ‏23 ואילך ב-Android
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה עם Service Management API.
  • השלמת תהליך הגישור מדריך לתחילת העבודה

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

מתחברים ל-Moloco Publisher Portal.

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

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

Android

iOS

אחרי שיוצרים את האפליקציה, בוחרים אותה בכרטיסייה Apps כדי לראות את הפרטים שלה ורושמים את App Key.

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

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

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

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של Moloco Ads SDK ומתאם בpubspec.yaml של החבילה:

dependencies:
  gma_mediation_moloco: ^

שילוב ידני

מורידים את הגרסה העדכנית של פלאגין הגישור של Google Mobile Ads עבור Moloco Ads SDK, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:

dependencies:
  gma_mediation_moloco:
    path: path/to/local/package

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

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

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

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

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

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Moloco Ads SDK, אתם צריכים להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Moloco (Bidding).

קודי שגיאה

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

Android

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

iOS

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Android

קוד שגיאה דומיין סיבה
101 com.google.ads.mediation.moloco מפתח האפליקציה של Moloco חסר או לא תקין.
102 com.google.ads.mediation.moloco מזהה יחידת המודעות של Moloco חסר או לא תקין.
103 com.google.ads.mediation.moloco אובייקט המודעה של Moloco שהוחזר היה null.
‫‎-1 עד 5000 com.moloco.sdk ה-SDK של Moloco החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Moloco.

iOS

קוד שגיאה דומיין סיבה
101 com.google.ads.mediation.moloco ‫Moloco SDK לא תומך בהצגת מודעות ב-iOS 12 ובגרסאות קודמות.
102 com.google.ads.mediation.moloco מפתח האפליקציה של Moloco חסר או לא תקין.
103 com.google.ads.mediation.moloco מזהה יחידת המודעות של Moloco חסר או לא תקין.
104 com.google.ads.mediation.moloco המודעה לא מוכנה להצגה.
105 com.google.ads.mediation.moloco המודעה לא הוצגה.
106 com.google.ads.mediation.moloco נתוני הרינדור לא זמינים כדי לרנדר את המודעה.
‫‎-1 עד 5000 נשלחה על ידי Moloco SDK ה-SDK של Moloco החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Moloco.

אימות בצד השרת של מודעות מתגמלות

אם מאמתים קריאות חוזרות (callback) של אימות בצד השרת (SSV), מזהה מקור המודעה של Moloco הוא 8267622065755668722.

יומן השינויים של Moloco Flutter Mediation Adapter

גרסה 1.6.1 (במהלך פיתוח)

גרסה 1.6.0 (בתהליך)

גרסה 1.5.0

גרסה 1.4.0

גרסה 1.3.1

גרסה 1.3.0

גרסה 1.2.0

גרסה 1.1.0

גרסה 1.0.0