במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-AppLovin באמצעות תהליך בחירת הרשת (Mediation), שכולל גם שילובים של בידינג וגם של Waterfall. נסביר איך להוסיף את AppLovin בהגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את AppLovin SDK והמתאם לאפליקציה Flutter .
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם הגישור של AppLovin כולל היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | 1 |
מעברון | |
ההטבה הופעלה |
מודעות באנר (לא כולל MREC) באנרים) נתמכים רק בתהליך בחירת הרשת. תכונת הבידינג לא תומכת באף סוג של מודעות באנר.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Flutter 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פעיל שהוגדר ב-Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: מגדירים את ההגדרות בממשק המשתמש של AppLovin
להרשמה או להתחברות לחשבון ב-AppLovin.
כדי להגדיר את יחידת המודעות ב-AdMob, צריך מפתח SDK ומפתח דוח של AppLovin. כדי למצוא אותן, עוברים אל ממשק המשתמש של AppLovin > חשבון > מקשים שאפשר לראות את שני הערכים האלה.
אם אתם מתכננים לשלב רק את הבידינג, אפשר להמשיך לקבוע את ההגדרות של תהליך בחירת הרשת.
בחירת אפליקציה לתהליך בחירת הרשת (Mediation)
בידינג
לא צריך לבצע את השלב הזה בשילוב של בידינג.
מפל
בממשק המשתמש של AppLovin, בוחרים באפשרות Applications מתחת מונטיזציה – כדי לעבור לאפליקציות הרשומות שלכם. בחירת האפליקציה שרוצים להשתמש בהם בתהליך בחירת הרשת מתוך רשימת האפליקציות הזמינות.
יצירת טווח
בידינג
לא צריך לבצע את השלב הזה בשילוב של בידינג.
מפל
בממשק המשתמש של AppLovin, בוחרים באפשרות Zones בקטע מונטיזציה. כדי לקבל את מזהי האזורים הרשומים. אם כבר יצרת את האזורים הנדרשים לאפליקציה, דלגו קדימה לשלב 2. כדי ליצור מזהה תחום חדש, לוחצים על יצירת אזור.
מזינים את השם של מזהה האזור, בוחרים את Android בתור הפלטפורמה. בוחרים באפשרות סוג מודעה.
מגדירים תמחור לאזור על ידי בחירה באפשרות עלות קבועה לאלף חשיפות (CPM) או בוצע אופטימיזציה על ידי AppLovin. ניתן להגדיר עלויות לאלף חשיפות לפי מדינה עבור האפשרות עלות קבועה לאלף חשיפות. לאחר מכן לוחצים על שמירה.
Android
iOS
אחרי שיוצרים את האזור, אפשר למצוא את מזהה האזור מתחת למזהה האזור. עמודה.
Android
iOS
הפעלת מצב בדיקה
פועלים לפי ההוראות ב-AppLovin מצב בדיקה של MAX מדריך להפעלה של מודעות בדיקה של AppLovin.
שלב 2: הגדרת ביקוש ב-AppLovin AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של AppLovin Corp. לרשימת שותפי הפרסום בנושא GDPR ותקנות במדינות בארה"ב
שלב 3: מייבאים את ה-SDK והמתאם של AppLovin
שילוב באמצעות pub.dev
צריך להוסיף את התלות הבאה בגרסאות האחרונות של
AppLovin ה-SDK והמתאם בחבילה שלך
קובץ pubspec.yaml
:
dependencies:
gma_mediation_applovin: ^1.0.0
שילוב ידני
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור AppLovin, מנתקים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את הפלאגין לקובץ pubspec.yaml
באמצעות יחסי התלות הבאים:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
שלב 4: מטמיעים את הגדרות הפרטיות ב-AppLovin SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
ב-AppLovin אפשר לקרוא את מחרוזת ההסכמה מההעדפות ומההגדרות המשותפות את סטטוס ההסכמה בהתאם.אם אתם
לא משתמשים בפלטפורמת CMP שכותבת את מחרוזת ההסכמה
בהעדפות שלך, אפשר להשתמש
GmaMediationApplovin.setHasUserConsent()
ו
GmaMediationApplovin.setIsAgeRestrictedUser()
שיטות. הקוד לדוגמה הבא מראה איך
לצורך העברת פרטי ההסכמה ל-AppLovin SDK. צריך להגדיר את האפשרויות האלה
לפני שמפעילים את Google Mobile Ads SDK
כדי לוודא שהן יועברו כראוי ל-AppLovin SDK.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
כדאי לעיין בהגדרות הפרטיות של AppLovin אפשר לקבל מידע נוסף.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-AppLovin
כוללת את
GmaMediationApplovin.setDoNotSell()
. הקוד לדוגמה הבא מראה איך להעביר
פרטי ההסכמה ל-AppLovin SDK. חובה להגדיר את האפשרויות האלה לפני
להפעיל את מודעות Google לנייד
SDK
כדי לוודא שהן יועברו כראוי ל-AppLovin SDK.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
לעיון במדיניות הפרטיות של AppLovin תיעוד אפשר לקבל מידע נוסף.
שלב 5: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב של AppLovin.
iOS
שילוב של SKAdNetwork
צריך לפעול לפי מסמכי התיעוד של AppLovin כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב AppLovin ממשק המשתמש.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-AppLovin, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות AppLovin (Bidding) and AppLovin (Waterfall) מקורות המודעות.
שלבים אופציונליים
פרמטרים ספציפיים לרשת
המתאם של AppLovin תומך בהעברת אובייקט AppLovinMediationExtras
אל
בקשה להצגת מודעה כדי להגדיר פרמטרים ספציפיים לרשת. הקוד לדוגמה הבא מראה
איך משביתים אודיו במודעות וידאו באמצעות הפרמטר isMuted
:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
אופטימיזציות
הוספת שיחה אל
GmaMediationApplovin.initializeSdk('sdkKey')
לפעילות ההשקה שלכם,
אפשרות לעקוב אחר אירועים ברגע שהאפליקציה מופעלת ב-AppLovin.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-AppLovin,
בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה עם המודעה באמצעות
ResponseInfo
מתחת לקטע
המחלקות הבאות:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
אלו הקודים וההודעות הנלוות שהופעלו על ידי מתאם AppLovin כשמודעה נכשלת להיטען:
Android
קוד שגיאה | סיבה |
---|---|
-1009 עד -1, 204 | אירעה שגיאה ב-SDK של AppLovin. צפייה מסמכי התיעוד של AppLovin אפשר לקבל פרטים נוספים. |
101 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-AppLovin. |
103 | ההקשר ריק. |
104 | אסימון הצעת המחיר AppLovin ריק. |
105 | נשלחה בקשה להצגת מודעות מרובות לאותו אזור. אפשר לטעון מודעה אחת בלבד בכל אזור ב-AppLovin. |
106 | המודעה לא מוכנה להצגה. |
108 | מתאם AppLovin לא תומך בפורמט המודעה המבוקש. |
iOS
קוד שגיאה | סיבה |
---|---|
-1009 עד -1, 204 | אירעה שגיאה ב-SDK של AppLovin. במאמרי העזרה של AppLovin אפשר לקבל פרטים נוספים. |
101 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-AppLovin. |
102 | הפרמטרים של שרת AppLovin שהוגדרו AdMob בממשק המשתמש חסרים או לא תקינים. |
103 | הצגת מודעת AppLovin נכשלה. |
104 | נשלחה בקשה להצגת מודעות מרובות לאותו אזור. אפשר לטעון מודעה אחת בלבד בכל אזור ב-AppLovin. |
105 | מפתח ה-SDK של AppLovin לא נמצא. |
107 | אסימון הצעת המחיר ריק. |
108 | מתאם AppLovin לא תומך בפורמט המודעה המבוקש. |
110 | נשלחה על ידי AppLovin קריאה חוזרת (callback) ללא שגיאות, אבל לא נטענו מודעות. |
יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-AppLovin
1.2.0
- תאימות מאומתת למתאם Android של AppLovin בגרסה 12.6.1.0.
- תאימות מאומתת למתאם iOS של AppLovin בגרסה 12.6.1.0.
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.
1.1.0
- ה-API של GmaMediationApplovein כבר לא סטטי.
- תאימות מאומתת למתאם Android של AppLovin בגרסה 12.4.3.0.
- תאימות מאומתת למתאם iOS של AppLovin בגרסה 12.4.2.0.
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.
1.0.0
- גרסה ראשונית.
- תאימות מאומתת למתאם Android של AppLovin גרסה 12.3.0.0
- תאימות מאומתת למתאם iOS של AppLovin גרסה 12.2.1.0
- נוצר ונבדק באמצעות גרסה 5.0.0 של הפלאגין של Google Mobile Ads Flutter.