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

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

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

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

שילוב
בידינג
מפל
פורמטים
כרזה  1
פרסומת מרווח ביניים
ההטבה הופעלה

מודעות באנר (למעט מודעות באנר מסוג MREC) נתמכות רק בתהליך בחירת הרשת. בידינג אינו תומך באף סוג של מודעות באנר.

דרישות

  • ה-SDK העדכני של מודעות Google לנייד
  • Unity 5.6 ואילך
  • [לבידינג]: הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-AppLovin מגרסה 4.2.0 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
  • כדי לפרוס ב-Android
    • Android API ברמת 21 ואילך
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Unity עבודה שהוגדר באמצעות 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) ביחידת המודעות

Android

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

iOS

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

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

פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את AppLovin Corp. לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .

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

מורידים את הגרסה האחרונה של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads ל-AppLovin מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsAppLovinMediation.unitypackage מקובץ ה-ZIP.

בעורך הפרויקטים ב-Unity, לוחצים על Assets > Import Package > Custom Package (נכסים > ייבוא חבילה > חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsAppLovinMediation.unitypackage שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.

לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force resolve. ספריית Unity Play Services Solutionr תבצע פתרון בעיות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android של אפליקציית Unity.

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

בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.

החל מגרסה 7.0.0 של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads, ב-AppLovin יש תמיכה בקריאת מחרוזת ההסכמה מההעדפות המשותפות והגדרת סטטוס ההסכמה בהתאם.

אם אתם לא משתמשים בפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads בגרסה 7.0.0 ואילך או לא משתמשים בפלטפורמת CMP שכותבת את מחרוזת ההסכמה בהעדפות המשותפות, אפשר להשתמש בשיטות AppLovin.SetHasUserConsent() וגם AppLovin.SetIsAgeRestrictedUser() . הקוד לדוגמה הבא מראה איך להעביר פרטי הסכמה ל-SDK של AppLovin. חשוב להגדיר את האפשרויות האלה לפני שמאתחלים את Google Mobile Ads SDK כדי לוודא שהן מועברות כראוי ל-AppLovin SDK.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

בנוסף, אם ידוע שהמשתמש נמצא בקטגוריית הגבלת גיל, אפשר להגדיר גם את הדגל הבא לערך true.

AppLovin.SetIsAgeRestrictedUser(true);

מידע נוסף זמין בהגדרות הפרטיות של AppLovin.

חוקי הפרטיות במדינות בארה"ב

חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.

פלאגין תהליך בחירת הרשת של Google Mobile Ads עבור AppLovin גרסה 6.3.1 כולל את השיטה AppLovin.SetDoNotSell() . הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה ל-SDK של AppLovin. חשוב להגדיר את האפשרויות האלה לפני שמאתחלים את ה-SDK של מודעות Google לנייד, כדי לוודא שהן מועברות כראוי ל-AppLovin SDK.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

מידע נוסף זמין במסמכי התיעוד של AppLovin בנושא פרטיות.

שלב 5: מוסיפים את קוד החובה

Android

לא נדרש קוד נוסף לשילוב של AppLovin.

iOS

שילוב של SKAdNetwork

פועלים לפי חומרי העזר של AppLovin כדי להוסיף את מזהי SKAdNetwork לקובץ ה-Info.plist של הפרויקט.

שלב 6: בודקים את ההטמעה

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

חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב AppLovin ממשק המשתמש.

אימות מודעות בדיקה

כדי לוודא שמוצגות לך מודעות לבדיקה מ-AppLovin, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות AppLovin (Bidding) and AppLovin (Waterfall) מקורות המודעות.

שלבים אופציונליים

אופטימיזציות

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

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

גרסה 7.1.0

גרסה 7.0.1

גרסה 7.0.0

גרסה 6.9.1

גרסה 6.9.0

גרסה 6.8.0

גרסה 6.7.0

גרסה 6.6.0

גרסה 6.5.1

גרסה 6.5.0

גרסה 6.4.3

גרסה 6.4.2

גרסה 6.4.1

גרסה 6.4.0

גרסה 6.3.1

גרסה 6.3.0

גרסה 6.2.1

גרסה 6.2.0

גרסה 6.1.0

גרסה 6.0.0

גרסה 5.1.3

גרסה 5.1.2

גרסה 5.1.1

גרסה 5.1.0

גרסה 5.0.0

גרסה 4.8.1

גרסה 4.8.0

גרסה 4.7.0

גרסה 4.6.2

גרסה 4.6.1

גרסה 4.6.0

גרסה 4.5.8

גרסה 4.5.7

גרסה 4.5.6

גרסה 4.5.5

גרסה 4.5.4

גרסה 4.5.3

גרסה 4.5.2

גרסה 4.5.1

גרסה 4.5.0

גרסה 4.4.1

גרסה 4.4.0

גרסה 4.3.0

גרסה 4.2.0

  • יש תמיכה במתאם Android AppLovin בגרסה 9.4.2.0.
  • יש תמיכה במתאם AppLovin ל-iOS בגרסה 6.6.1.0.

גרסה 4.1.0

  • הפלאגין עודכן ועכשיו הוא יתמוך ב-API החדש של תוכנית הבטא הפתוחה.
  • יש תמיכה במתאם Android AppLovin בגרסה 9.2.1.1.
  • יש תמיכה במתאם AppLovin ל-iOS בגרסה 6.3.0.0.

גרסה 4.0.0

  • יש תמיכה במתאם Android AppLovin בגרסה 9.2.1.0.
  • יש תמיכה במתאם AppLovin ל-iOS בגרסה 6.2.0.0.

גרסה 3.1.2

  • יש תמיכה במתאם Android AppLovin בגרסה 8.1.4.0.
  • יש תמיכה במתאם iOS של AppLovin בגרסה 5.1.2.0.

גרסה 3.1.1

  • יש תמיכה במתאם Android AppLovin בגרסה 8.1.0.0.
  • יש תמיכה במתאם iOS של AppLovin בגרסה 5.1.1.0.

גרסה 3.1.0

  • יש תמיכה במתאם Android AppLovin בגרסה 8.1.0.0.
  • יש תמיכה במתאם iOS של AppLovin בגרסה 5.1.0.0.

גרסה 3.0.3

  • יש תמיכה במתאם Android AppLovin בגרסה 8.0.2.1.
  • יש תמיכה במתאם iOS של AppLovin בגרסה 5.0.2.0.

גרסה 3.0.2

  • יש תמיכה ב-AppLovin Android SDK בגרסה 8.0.1.
  • יש תמיכה ב-AppLovin iOS SDK בגרסה 5.0.1.

גרסה 3.0.1

  • יש תמיכה ב-AppLovin Android SDK בגרסה 8.0.0.
  • יש תמיכה ב-AppLovin iOS SDK בגרסה 5.0.1.
  • נוספה שיטת AppLovin.SetIsAgeRestrictedUser() כדי לציין אם ידוע שהמשתמש מסווג בקטגוריה שחלה עליו הגבלת גיל.

גרסה 3.0.0

  • יש תמיכה ב-AppLovin Android SDK בגרסה 8.0.0.
  • יש תמיכה ב-AppLovin iOS SDK בגרסה 5.0.1.
  • נוספה שיטת AppLovin.SetHasUserConsent() כדי להעביר את סימון ההסכמה של המשתמש ל-AppLovin SDK.

גרסה

  • יש תמיכה ב-AppLovin Android SDK בגרסה 7.8.6.
  • יש תמיכה ב-AppLovin iOS SDK בגרסה 5.0.1.

גרסה 1.2.1

  • יש תמיכה ב-AppLovin Android SDK בגרסה 7.8.6.
  • יש תמיכה ב-AppLovin iOS SDK בגרסה 4.8.3.

גרסה 1.2.0

  • יש תמיכה ב-AppLovin Android SDK בגרסה 7.8.5.
  • יש תמיכה ב-AppLovin iOS SDK בגרסה 4.8.3.

גרסה 1.1.0

  • יש תמיכה ב-AppLovin Android SDK בגרסה 7.7.0.
  • יש תמיכה ב-AppLovin iOS SDK בגרסה 4.7.0.

גרסה 1.0.0

  • השקה ראשונה!
  • יש תמיכה ב-AppLovin Android SDK בגרסה 7.4.1.
  • יש תמיכה ב-AppLovin iOS SDK בגרסה 4.4.1.