משלבים את AppLovin עם תהליך בחירת הרשת (Mediation)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-AppLovin באמצעות תהליך בחירת הרשת (Mediation), שכולל גם שילובים של בידינג וגם של Waterfall. במאמר מוסבר איך להוסיף את AppLovin להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את AppLovin SDK והמתאם באפליקציה 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 > Account > Keys כדי לראות את שני הערכים.

אם אתם מתכננים לשלב רק בידינג, תוכלו להמשיך אל הגדרת ההגדרות של תהליך בחירת הרשת.

בחירת אפליקציה לתהליך בחירת הרשת (Mediation)

בידינג

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

מפל

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

יצירת טווח

בידינג

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

מפל

בממשק המשתמש של 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

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

Android

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

iOS

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

הוספת 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

בהתאם למדיניות 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) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.

הפלאגין של Google Mobile Ads לתהליך בחירת הרשת ב-AppLovin כולל את ה-method GmaMediationApplovin.setDoNotSell() . דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה ל-AppLovin SDK. צריך להגדיר את האפשרויות האלה לפני אתחול ה-SDK של Google Mobile Ads כדי להבטיח שהן יועברו כראוי ל-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

קוד שגיאה סיבה
-1009 עד -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 קריאה חוזרת (callback) ללא שגיאות, אבל לא נטענו מודעות.
111 לא ניתן לאחזר מופע של AppLovin SDK.
112 המשתמש הוא ילד או ילדה.

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

הגרסה הבאה

  • נוצר ונבדק באמצעות גרסה 5.2.0 של הפלאגין של Google Mobile Ads Flutter.

1.2.0

  • תאימות מאומתת למתאם Android של AppLovin בגרסה 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

  • הגרסה הראשונית.
  • תאימות מאומתת למתאם Android של AppLovin גרסה 12.3.0.0
  • תאימות מאומתת למתאם iOS של AppLovin גרסה 12.2.1.0
  • נוצר ונבדק באמצעות גרסה 5.0.0 של הפלאגין של Google Mobile Ads Flutter.