שילוב של Liftoff Monetize עם תהליך בחירת הרשת (Mediation)

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

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

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

1 שילוב הבידינג בפורמט הזה נמצא בגרסת בטא פתוחה.

2 מפל של הפורמט הזה הוא בגרסת בטא פתוחה.

דרישות

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

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

נרשמים או מתחברים ל-Liftoff ייצור הכנסות מהחשבון.

מוסיפים את האפליקציה למרכז הבקרה של Liftoff Monetize באמצעות לחיצה על הלחצן Add Application (הוספת אפליקציה).

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

Android

iOS

אחרי יצירת האפליקציה, בוחרים אותה מרכז הבקרה של האפליקציות של Liftoff Monetize

Android

iOS

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

Android

iOS

הוספת מיקומי מודעות חדשים

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

בהמשך מפורטים פרטים על הוספת מיקומי מודעות חדשים:

מודעות בפתיחת האפליקציה

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

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

באנר 300x250

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

מעברון

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

ההטבה הופעלה

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

מודעות מעברון מתגמלות

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

מותאם

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

בודקים את מזהה ההפניה ולוחצים על נשמע טוב.

מודעות בפתיחת האפליקציה

באנר בגודל 300x250

מעברון

ההטבה הופעלה

מודעות מעברון מתגמלות

מותאם

איתור מפתח Reporting API

בידינג

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

מפל

בנוסף למזהה האפליקציה ולמזהה העזרה, תצטרכו גם את מפתח ה-Reporting API של Liftoff Monetize כדי להגדיר את מזהה יחידת המודעות ב-AdMob. עוברים אל מרכז הבקרה של הדוחות של Liftoff Monetize וגם ללחוץ על מפתח Reporting API כדי להציג את Reporting API מקש.

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

כדי להפעיל מודעות בדיקה, עוברים ללוח הבקרה של Liftoff Monetize ולוחצים על Applications (אפליקציות).

בוחרים את האפליקציה שבה רוצים להפעיל מודעות בדיקה בקטע Placement Reference ID (מזהה העזר של מיקום המודעה) באפליקציה. כדי להפעיל מודעות בדיקה, בוחרים באפשרות Test Mode (מצב בדיקה) כדי להגדיר את האפשרות Show test ads only (הצגת מודעות בדיקה בלבד) בקטע Status (סטטוס).

Android

iOS

שלב 2: מגדירים את הביקוש ב-Liftoff Monetize ב AdMob ממשק המשתמש

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

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

שלב 3: מייבאים את Vungle SDK ומתאם Liftoff Monetize

שילוב באמצעות pub.dev

צריך להוסיף את התלות הבאה בגרסאות האחרונות של Liftoff Monetize ה-SDK והמתאם בחבילה שלך קובץ pubspec.yaml:

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

שילוב ידני

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

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

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

הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Liftoff Monetize כולל את אמצעי תשלום אחד (GmaMediationLiftoffmonetize.setGDPRStatus()). דוגמת הקוד הבאה מראה איך מעבירים את פרטי ההסכמה ל-Vungle SDK. אם בוחרים להפעיל את השיטה הזו, מומלץ להפעיל אותה לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

הוראות להטמעה מומלצת לפי GDPR פרטים נוספים זמינים ב-Android וב-iOS ואת הערכים שניתן לספק בשיטה.

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

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

הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור Liftoff Monetize כולל את השיטה GmaMediationLiftoffmonetize.setCCPAStatus(). דוגמת הקוד הבאה מראה איך מעבירים את פרטי ההסכמה ל-Vungle SDK. אם בוחרים להפעיל את השיטה הזו, מומלץ להפעיל אותה לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

להוראות הטמעה מומלצות של CCPA לפרטים נוספים ול-Android ול-iOS בין הערכים שאפשר לציין ב-method.

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

Android

לא צריך קוד נוסף בשילוב של Liftoff Monetize.

iOS

שילוב של SKAdNetwork

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

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

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

חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב Liftoff Monetize ממשק המשתמש.

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

כדי לוודא שמוצגות לך מודעות לבדיקה מ-Liftoff Monetize, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) מקורות המודעות.

קודי שגיאה

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

Android

פורמט שם הכיתה
מודעות בפתיחת אפליקציה (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות בפתיחת האפליקציה (Waterfall) com.google.ads.mediation.vungle.VungleMediationAdapter
באנר (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
באנר (מפל מים) com.vungle.mediation.VungleInterstitialAdapter
מודעות מעברון (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות מעברון (Waterfall) com.vungle.mediation.VungleInterstitialAdapter
מודעות מתגמלות (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות מתגמלות (Waterfall) com.vungle.mediation.VungleAdapter
מודעות מעברון מתגמלות (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות מעברון מתגמלות (Waterfall) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

פורמט שם הכיתה
מודעות בפתיחת האפליקציה (בידינג) GADMediationAdapterVungle
מודעות בפתיחת אפליקציה (Waterfall) GADMediationAdapterVungle
מודעת באנר (בידינג) GADMediationAdapterVungle
באנר (מפל מים) GADMAdapterVungleInterstitial
מודעות מעברון (בידינג) GADMediationAdapterVungle
מודעות מעברון (Waterfall) GADMAdapterVungleInterstitial
מתגמלות (בידינג) GADMediationAdapterVungle
מודעות מתגמלות (Waterfall) GADMAdapterVungleRewardBasedVideoAd
מודעות מעברון מתגמלות (בידינג) GADMediationAdapterVungle
מודעות מעברון מתגמלות (Waterfall) GADMediationAdapterVungle

בטבלה הבאה מפורטים הקודים וההודעות הנלוות ל-Liftoff Monetize כשמודעה נכשלת להיטען:

Android

קוד שגיאה סיבה
101 פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום מודעה).
102 גודל הבאנר המבוקש לא ממופה למודעת Liftoff Monetize חוקית גודל.
103 כדי לבקש מודעות, נדרש הקשר Activity ב-Liftoff Monetize.
104 ה-SDK של Vungle לא יכול לטעון כמה מודעות לאותו מזהה מיקום מודעה.
105 לא הצלחנו לאתחל את ה-SDK של Vungle.
106 הקריאה החוזרת (callback) של הטעינה החוזרת בוצעה בהצלחה, אבל Banners.getBanner() או Vungle.getNativeAd() החזירו null.
107 Vungle SDK לא מוכן להפעלת המודעה.
108 Vungle SDK החזיר אסימון לא חוקי לבידינג.

iOS

קוד שגיאה סיבה
101 פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום מודעה).
102 כבר נטענה מודעה בהגדרת הרשת הזו. Vungle SDK לא ניתן לטעון מודעה שנייה עבור אותו מזהה מיקום.
103 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-Liftoff Monetize.
104 לא ניתן היה להציג את מודעת הבאנר באמצעות Vungle SDK.
105 Vungle SDK תומך בטעינה של מודעת באנר אחת בלבד בכל פעם, ללא קשר ל מזהה של מיקום המודעה.
106 נשלחה שיחה חוזרת מ-Vungle SDK ואומרת שלא ניתן להפעיל את המודעה.
107 Vungle SDK לא מוכן להפעלת המודעה.

אם מדובר בשגיאות שמקורן ב-Vungle SDK, אפשר לעיין במאמר קודי שגיאה: Vungle SDK ל-iOS ול-Android.

יומן השינויים של מתאם בחירת הרשת (Mediation) של Liftoff Monetize ל-Flutter

גרסה 1.1.0

  • תאימות מאומתת למתאם Liftoff Monetize ב-Android גרסה 7.4.0.1
  • תאימות מאומתת עם מתאם LiftoffMonetize ל-iOS בגרסה 7.4.0.1
  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.

גרסה 1.0.0

  • הגרסה הראשונית.
  • תאימות מאומתת עם מתאם Liftoff Monetize ל-Android בגרסה 7.3.1.0
  • תאימות מאומתת למתאם LiftoffMonetize ל-iOS בגרסה 7.3.2.0
  • נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.