במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-AppLovin באמצעות תהליך בחירת רשת, תוך התייחסות לשילובים של בידינג ושל רשימת רשתות. במאמר מוסבר איך להוסיף את AppLovin להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של AppLovin באפליקציה Flutter .
השילובים והפורמטים של המודעות הנתמכים
AdMob למתאם בחירת הרשת של AppLovin יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעת באנר | 1 |
מעברון | |
ההטבה הופעלה |
יש תמיכה במודעות באנר (לא כולל מודעות באנר מסוג MREC) רק בתהליך בחירת הרשת (Mediation). הבידינג לא תומך בשום סוג של מודעות באנר.
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- 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 כדי לראות את שני הערכים.
אם אתם מתכננים לשלב רק בידינג, תוכלו להמשיך אל הגדרת ההגדרות של תהליך בחירת הרשת.
בחירת אפליקציה לבחירת רשת
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
בממשק המשתמש של AppLovin, בוחרים באפשרות Applications בקטע Monetization כדי להגיע לאפליקציות הרשומים. בוחרים את האפליקציה שבה רוצים להשתמש עם תהליך בחירת הרשת מרשימת האפליקציות הזמינות.
יצירת אזור
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
בממשק המשתמש של AppLovin, בוחרים באפשרות Zones בקטע Monetization כדי להגיע למזהי האזורים הרשומים. אם כבר יצרתם את האזורים הנדרשים לאפליקציה, תוכלו לדלג אל שלב 2. כדי ליצור מזהה תחום חדש, לוחצים על Create Zone.
מזינים את השם של מזהה האזור, בוחרים באפשרות Android בתור פלטפורמה ובוחרים את סוג המודעה.
מגדירים את התמחור של האזור על ידי בחירה באפשרות Flat CPM או באפשרות Optimized by AppLovin. אפשר להגדיר עלויות לאלף חשיפות (CPM) לכל מדינה בנפרד באפשרות עלות לאלף חשיפות קבועה. לאחר מכן לוחצים על שמירה.
Android
iOS
אחרי יצירת האזור, מזהה האזור מופיע בעמודה Zone ID.
Android
iOS
הפעלת מצב בדיקה
כדי להפעיל מודעות בדיקה של AppLovin, פועלים לפי ההוראות במדריך של AppLovin בנושא מצב בדיקה של MAX.
שלב 2: הגדרת הביקוש מ-AppLovin בממשק המשתמש AdMob
הגדרת הגדרות בחירת הרשת ליחידת המודעות
הוספת AppLovin Corp. לרשימה של שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות ארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Applovin Corp. לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob.
שלב 3: מייבאים את ה-SDK ואת המתאם של AppLovin
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK ושל המתאם שלAppLovin בקובץ 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 Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.
מערכת AppLovin תומכת בקריאת מחרוזת ההסכמה מההעדפות המשותפות ובהגדרת סטטוס ההסכמה בהתאם.אםאתם לא משתמשים בפלטפורמה לניהול הסכמה שמזינה את מחרוזת ההסכמה בהעדפות המשותפות, תוכלו להשתמש בשיטות
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 לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.
הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ל-AppLovin
כולל את השיטה
GmaMediationApplovin.setDoNotSell()
. דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה ל-AppLovin SDK. צריך להגדיר את האפשרויות האלה לפני שמפעילים את Google Mobile Ads 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) ו-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
קוד שגיאה | סיבה |
---|---|
-1,009 עד -1,204 | ה-SDK של AppLovin החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של AppLovin. |
101 | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-AppLovin. |
103 | ההקשר ריק. |
104 | טוקן הצעת המחיר של AppLovin ריק. |
105 | נשלחו מספר בקשות להצגת מודעות באותו תחום. מערכת AppLovin יכולה לטעון רק מודעה אחת בכל פעם בכל תחום. |
106 | המודעה לא מוכנה להצגה. |
108 | מתאם AppLovin לא תומך בפורמט המודעה המבוקש. |
iOS
קוד שגיאה | סיבה |
---|---|
-1,009 עד -1,204 | ה-SDK של AppLovin החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של AppLovin. |
101 | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-AppLovin. |
102 | פרמטרים של שרת AppLovin שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים. |
103 | הצגת מודעת AppLovin נכשלה. |
104 | נשלחו מספר בקשות להצגת מודעות באותו תחום. מערכת AppLovin יכולה לטעון רק מודעה אחת בכל פעם בכל תחום. |
105 | לא נמצא מפתח SDK של AppLovin. |
107 | אסימון הצעת המחיר ריק. |
108 | מתאם AppLovin לא תומך בפורמט המודעה המבוקש. |
110 | מערכת AppLovin שלחה קריאה חוזרת לטעינה שהצליחה, אבל לא נטענו אף מודעות. |
111 | לא ניתן לאחזר מופע של AppLovin SDK. |
112 | המשתמש הוא ילד או ילדה. |
יומן השינויים של מתאם תהליך בחירת הרשת (Mediation) של AppLovin ל-Flutter
הגרסה הבאה
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.2.0.
1.2.0
- תאימות מאומתת למתאם AppLovin ל-Android בגרסה 12.6.1.0.
- תאימות מאומתת עם מתאם AppLovin ל-iOS בגרסה 12.6.1.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
1.1.0
- ה-API של GmaMediationApplovin כבר לא סטטי.
- תאימות מאומתת למתאם AppLovin ל-Android בגרסה 12.4.3.0.
- תאימות מאומתת עם מתאם AppLovin ל-iOS בגרסה 12.4.2.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
1.0.0
- הגרסה הראשונית.
- תאימות מאומתת למתאם AppLovin ל-Android בגרסה 12.3.0.0
- תאימות מאומתת עם מתאם AppLovin ל-iOS בגרסה 12.2.1.0
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.0.0.