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

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

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

Ad Manager מתאם הגישור של AppLovin כולל היכולות הבאות:

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

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

דרישות

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

שלב 1: מגדירים את ההגדרות בממשק המשתמש של AppLovin

להרשמה או להתחברות לחשבון ב-AppLovin.

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

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

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

בידינג

לא צריך לבצע את השלב הזה בשילוב של בידינג.

מפל

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

יצירת טווח

בידינג

לא צריך לבצע את השלב הזה בשילוב של בידינג.

מפל

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

מזינים את השם של מזהה האזור, בוחרים את Android בתור הפלטפורמה. בוחרים באפשרות סוג מודעה.

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

Android

iOS

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

Android

iOS

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

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

שלב 2: הגדרת ביקוש ב-AppLovin Ad Manager בממשק המשתמש

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

אם יש לכם את OpenUPM-CLI תוכל להתקין את האפליקציה Google Mobile Ads AppLovin הפלאגין של תהליך בחירת הרשת (Mediation) ל-Unity בפרויקט, על ידי הרצת הפקודה הבאה מספריית השורש של הפרויקט:

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

OpenUPM

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

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

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

פרטי OpenUPM

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

רשימות של Unity

בוחרים את החבילה Google Mobile Ads AppLovin Mediation לוחצים על התקנה.

התקנה מ-OpenUPM

חבילת Unity

כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור AppLovin מקישור ההורדה ב- ה יומן שינויים ומחלצים את הקטע GoogleMobileAdsAppLovinMediation.unitypackage מהמיקוד חדש.

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

ייבוא מ-Unity

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

אילוץ החלטה

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

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

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

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

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

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

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

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

AppLovin.SetDoNotSell(true);

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

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

Android

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

iOS

שילוב של SKAdNetwork

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

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

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

חשוב לרשום את מכשיר הבדיקה ל- Ad Manager ולהפעיל את מצב הבדיקה ב 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 ההקשר ריק.
104 אסימון הצעת המחיר AppLovin ריק.
105 נשלחה בקשה להצגת מודעות מרובות לאותו אזור. אפשר לטעון מודעה אחת בלבד בכל אזור ב-AppLovin.
106 המודעה לא מוכנה להצגה.
108 מתאם AppLovin לא תומך בפורמט המודעה המבוקש.

iOS

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

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

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

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

גרסה 4.1.0

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

גרסה 4.0.0

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

גרסה 3.1.2

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

גרסה 3.1.1

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

גרסה 3.1.0

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

גרסה 3.0.3

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

גרסה 3.0.2

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

גרסה 3.0.1

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

גרסה 3.0.0

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

גרסה 2.0.0

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

גרסה 1.2.1

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

גרסה 1.2.0

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

גרסה 1.1.0

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

גרסה 1.0.0

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