במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-AppLovin באמצעות תהליך בחירת הרשת (Mediation), שמכסה גם שילובים של בידינג וגם שילובים של Waterfall. נסביר איך מוסיפים את AppLovin להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של AppLovin באפליקציה Flutter .
שילובים נתמכים ופורמטים נתמכים של מודעות
המתאם של AdMob תהליך בחירת הרשת ב-AppLovin כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | 1 |
פרסומת מרווח ביניים | |
ההטבה הופעלה |
מודעות באנר (למעט מודעות באנר מסוג MREC) נתמכות רק בתהליך בחירת הרשת. בידינג אינו תומך באף סוג של מודעות באנר.
דרישות
- ה-SDK העדכני של מודעות Google לנייד
- Flutter 3.7.0 ואילך
- כדי לפרוס ב-Android
- Android API ברמת 21 ואילך
- כדי לפרוס ב-iOS
- יעד הפריסה של iOS הוא 12.0 ומעלה
- פרויקט Flutter עבודה שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה
שלב 1: הגדרת הגדרות בממשק המשתמש של AppLovin
נרשמים או מתחברים לחשבון ב-AppLovin.
כדי להגדיר את AdMob יחידת המודעות, נדרש מפתח ה-SDK של AppLovin ומפתח הדיווח. כדי למצוא אותם, נכנסים אל AppLovin UI > Account > Keys כדי לראות את שני הערכים.
אם אתם מתכננים לשלב רק בידינג, תוכלו להמשיך לקביעת ההגדרות של תהליך בחירת הרשת.
בחירת אפליקציה לתהליך בחירת הרשת (Mediation)
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
בממשק המשתמש של AppLovin, בוחרים באפשרות Applications בקטע מונטיזציה כדי להגיע לאפליקציות הרשומות. ברשימת האפליקציות הזמינות, בוחרים את האפליקציה שבה רוצים להשתמש בתהליך בחירת הרשת.
יצירת אזור
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
בממשק המשתמש של AppLovin, בוחרים באפשרות zones בקטע מונטיזציה כדי להגיע למזהי התחומים הרשומים. אם כבר יצרתם את האזורים הנדרשים לאפליקציה, דלגו קדימה לשלב 2. כדי ליצור מזהה אזור חדש, לוחצים על Create Zone (יצירת אזור).
מזינים את השם של Zone ID, בוחרים באפשרות Android בתור הפלטפורמה ובוחרים באפשרות סוג המודעה.
כדי להגדיר את תמחור לתחום מסוים, בוחרים באפשרות Flat CPM או Optimized by AppLovin. ניתן להגדיר עלויות לאלף חשיפות (CPM) לכל מדינה בנפרד לאפשרות עלות קבועה לאלף חשיפות. לאחר מכן לוחצים על שמירה.
Android
iOS
אחרי שיוצרים אותו, מזהה התחום מופיע בעמודה Zone ID.
Android
iOS
הפעלת מצב בדיקה
פועלים לפי ההוראות ב-AppLovin מצב הבדיקה של MAX המדריך להפעלת מודעות בדיקה ב-AppLovin.
שלב 2: הגדרת הביקוש ב-AppLovin AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של AppLovin Corp. לרשימת שותפי הפרסום לתקנות ה-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את AppLovin Corp. לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK והמתאם של AppLovin
שילוב דרך pub.dev
מוסיפים את יחסי התלות הבאים עם הגרסאות העדכניות שלAppLovin ה-SDK והמתאם בקובץ pubspec.yaml
של החבילה:
dependencies:
gma_mediation_applovin: ^1.0.0
שילוב ידני
הורד את הגרסה האחרונה של פלאגין הגישור של Google Mobile Ads עבור AppLovin, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter שלכם. לאחר מכן, מוסיפים את התלות הבאה לפלאגין בקובץ pubspec.yaml
:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
שלב 4: מטמיעים את הגדרות הפרטיות ב-AppLovin SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.
ב-AppLovin יש תמיכה בקריאת מחרוזת ההסכמה מההעדפות המשותפות והגדרת סטטוס ההסכמה בהתאם.אם אתם
לא משתמשים בפלטפורמת CMP שכותבת את מחרוזת ההסכמה בהעדפות המשותפות, אפשר להשתמש בשיטות
GmaMediationApplovin.setHasUserConsent()
וגם
GmaMediationApplovin.setIsAgeRestrictedUser()
. הקוד לדוגמה הבא מראה איך להעביר פרטי הסכמה ל-SDK של AppLovin. חשוב להגדיר את האפשרויות האלה לפני שמאתחלים את Google Mobile Ads SDK כדי לוודא שהן מועברות כראוי ל-AppLovin SDK.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
מידע נוסף זמין בהגדרות הפרטיות של AppLovin.
חוקי הפרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.
פלאגין תהליך בחירת הרשת של Google Mobile Ads עבור AppLovin
כולל את
השיטה
GmaMediationApplovin.setDoNotSell()
. הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה ל-SDK של AppLovin. חשוב להגדיר את האפשרויות האלה לפני שמאתחלים את ה-SDK של מודעות Google לנייד, כדי לוודא שהן מועברות כראוי ל-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 | ההקשר הוא null. |
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 שלח קריאה חוזרת בטעינה, אבל אפס מודעות נטענו. |
יומן שינויים של מתאם תהליך בחירת הרשת ב-AppLovin Flutter
1.1.0
- ה-API של GmaMediationAppלובin כבר לא סטטי.
- תאימות מאומתת עם מתאם Android AppLovin בגרסה 12.4.3.0.
- תאימות מאומתת עם מתאם iOS 12.4.2.0 של AppLovin.
- התוסף נוצר ונבדק עם Google Mobile Ads Flutter גרסה 5.1.0.
1.0.0
- גרסה ראשונית.
- תאימות מאומתת למתאם Android AppLovin בגרסה 12.3.0.0
- תאימות מאומתת למתאם iOS 12.2.1.0 של AppLovin
- נוצר ונבדק עם פלאגין Google Mobile Ads Flutter גרסה 5.0.0.