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

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

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

המתאם של תהליך בחירת הרשת (Mediation) ב-AdMob ל-AppLovin כולל את היכולות הבאות:

שילוב
בידינג
מפל
פורמטים
מודעת באנר  1
מעברון
ההטבה הופעלה

בשיטת Waterfall נתמכים רק גדלי הבאנר 320x50 ו-728x90. בידינג לא תומך במודעות באנר.

דרישות

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

שלב 1: הגדרת תצורות בממשק המשתמש של AppLovin

נרשמים או מתחברים לחשבון AppLovin.

כדי להגדיר את יחידת המודעות ב-AdMob, תצטרכו את מפתח ה-SDK ואת מפתח הדוח של AppLovin. כדי למצוא אותם, עוברים אל ממשק המשתמש של AppLovin > Account > Keys כדי לראות את שני הערכים.

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

בחירת אפליקציה לגישור

בידינג

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

מפל

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

יצירת אזור

בידינג

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

מפל

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

מזינים את השם Zone ID, בוחרים באפשרות Android בתור Platform ובוחרים את Ad Type.

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

Android

iOS

אחרי שיוצרים את האזור, אפשר למצוא את מזהה האזור בעמודה מזהה אזור.

Android

iOS

עדכון של קובץ app-ads.txt

Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

כדי להטמיע app-ads.txt ב-Applovin, מוסיפים את AppLovin לקובץ app-ads.txt.

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

כדי להפעיל מודעות בדיקה של AppLovin, פועלים לפי ההוראות במדריך מצב בדיקה של MAX של AppLovin.

שלב 2: הגדרת הביקוש של AppLovin בממשק המשתמש של AdMob

הגדרת הגדרות הגישור ליחידת המודעות

Android

הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

הוספת AppLovin Corp. לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב

כדי להוסיף את Applovin Corp. לרשימת שותפי הפרסום שמספקים לכם שירותים שקשורים לבקשת הסכמה בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב בממשק המשתמש של AdMob.

שלב 3: ייבוא ה-SDK והמתאם של AppLovin

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של Applovin SDK והמתאם בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_applovin: ^

שילוב ידני

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

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

כדי לעמוד בדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לחשוף מידע מסוים למשתמשים באזור הכלכלי האירופי (EEA), בבריטניה ובשווייץ, ולקבל מהם הסכמה לשימוש בקובצי Cookie או באחסון מקומי אחר במקרים שבהם הדבר נדרש על פי חוק, וכן לאיסוף, לשיתוף ולשימוש במידע אישי לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, 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 לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.

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

קוד שגיאה סיבה
‫‎-1009 עד ‎-1, 204 ה-SDK של AppLovin החזיר שגיאה. פרטים נוספים זמינים בתיעוד של AppLovin'.
101 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך על ידי AppLovin.
103 ההקשר הוא null.
104 טוקן הצעת המחיר של AppLovin ריק.
105 הוגשו בקשות לכמה מודעות לאותו אזור. המערכת של AppLovin יכולה לטעון רק מודעה אחת בכל פעם לכל אזור.
106 המודעה לא מוכנה להצגה.
108 המתאם של AppLovin לא תומך בפורמט המודעה שמתבקש.
109 ההקשר הוא לא מופע של פעילות.
110 פרמטרים לא תקינים של השרת (למשל, מפתח ה-SDK הוא null).
112 המשתמש הוא ילד או ילדה.

iOS

קוד שגיאה סיבה
‫‎-1009 עד ‎-1, 204 ה-SDK של AppLovin החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של AppLovin.
101 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך על ידי AppLovin.
102 פרמטרים של שרת AppLovin שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
103 הצגת המודעה של AppLovin נכשלה.
104 הוגשו בקשות לכמה מודעות לאותו אזור. המערכת של AppLovin יכולה לטעון רק מודעה אחת בכל פעם לכל אזור.
105 לא נמצא מפתח AppLovin SDK.
107 הטוקן של הצעת המחיר ריק.
108 המתאם של AppLovin לא תומך בפורמט המודעה שמתבקש.
110 AppLovin שלחה קריאה חוזרת (callback) לטעינה מוצלחת, אבל טענה אפס מודעות.
111 לא ניתן לאחזר מופע של AppLovin SDK.
112 המשתמש הוא ילד או ילדה.
113 המופע המשותף של AppLovin SDK לא הופעל.
114 ה-SDK של AppLovin לא מחזיר טוקן בידינג.

יומן השינויים של AppLovin Flutter Mediation Adapter

גרסה 2.3.2

  • התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 2.3.1

  • התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 2.3.0

  • התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 2.2.1

  • התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 2.2.0

  • התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 2.1.0

  • התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.

גרסה 2.0.0

  • התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.

גרסה 1.2.0

  • התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 5.1.0.

גרסה 1.1.0

  • התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 5.1.0.

גרסה 1.0.0

  • זו הגרסה הראשונה.
  • התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 5.0.0.