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

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

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

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

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

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

דרישות

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין את Google Mobile Ads Applovin Mediation Plugin for Unity בפרויקט שלכם באמצעות הפקודה הבאה מספריית הבסיס של הפרויקט:

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

בכלי לעריכת פרויקטים ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את ההגדרות של מנהל החבילות ב-Unity.

בכרטיסייה Scoped Registries (מאגרי מידע בהיקף), מוסיפים את OpenUPM כמאגר מידע בהיקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפי הרשאות: com.google

פרטים על OpenUPM

לאחר מכן, עוברים אל Window (חלון) > Package Manager (מנהל החבילות) כדי לפתוח את Unity Package Manager (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המאגרים שלי) בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads Applovin Mediation ולוחצים על Install (התקנה).

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה האחרונה של הפלאגין Google Mobile Ads mediation ל-Applovin מקישור ההורדה ביומן השינויים ומחלצים את GoogleMobileAdsApplovinMediation.unitypackage מקובץ ה-ZIP.

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל תלות חיצוני > Android Resolver > Force Resolve (פתרון בכוח). ספריית External Dependency Manager (ניהול יחסי תלות חיצוניים) תבצע פתרון של יחסי תלות מאפס ותעתיק את יחסי התלות שהוגדרו לספרייה Assets/Plugins/Android של אפליקציית Unity.

אילוץ סימון שהנושא טופל

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

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

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

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

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

AppLovin.SetHasUserConsent(true);

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

AppLovin.SetIsAgeRestrictedUser(true);

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

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

חוקי הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (בהתאם להגדרה המעוגנת בחוק זה). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אל תמכרו את המידע האישי שלי". במדריך בנושא עמידה בדרישות של חוקי הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.

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

יומן השינויים של AppLovin Unity Mediation Plugin

גרסה 8.3.2

גרסה 8.3.1

גרסה 8.3.0

גרסה 8.2.1

גרסה 8.2.0

גרסה 8.1.1

גרסה 8.1.0

גרסה 8.0.4

גרסה 8.0.3

גרסה 8.0.2

גרסה 7.4.1

גרסה 7.4.0

גרסה 7.3.1

גרסה 7.3.0

גרסה 7.2.2

גרסה 7.2.1

גרסה 7.2.0

גרסה 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

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

גרסה 4.1.0

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

גרסה 4.0.0

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

גרסה 3.1.2

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

גרסה 3.1.1

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

גרסה 3.1.0

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

גרסה 3.0.3

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

גרסה 3.0.2

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

גרסה 3.0.1

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

גרסה 3.0.0

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

גרסה 2.0.0

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

גרסה 1.2.1

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

גרסה 1.2.0

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

גרסה 1.1.0

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

גרסה 1.0.0

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