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

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

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

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

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

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

דרישות

  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • 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 כדי לראות את שני הערכים.

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

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

בידינג

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

מפל

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

יצירת טווח

בידינג

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

מפל

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

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

מגדירים את Pricing לאזור זה באמצעות Flat CPM או Optimized by AppLovin. אפשר להגדיר את העלויות לאלף חשיפות לפי מדינה לפי האפשרות Flat CPM. לאחר מכן לוחצים על שמירה.

Android

iOS

אחרי יצירת האזור, מזהה האזור מופיע בעמודה Zone ID.

Android

iOS

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Google Mobile Ads AppLovin Mediation ל-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 ובוחרים באפשרות My Registries בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads AppLovin Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

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

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות Assets‏ > External Dependency Manager‏ > 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 של הפלאגין לבחירת רשת (Mediation) של Google Mobile Ads, ב-AppLovin אפשר לקרוא את מחרוזת ההסכמה מהעדפות משותפות ולהגדיר את סטטוס ההסכמה בהתאם.

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

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

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

AppLovin.SetDoNotSell(true);

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

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

Android

אין צורך בקוד נוסף לשילוב עם AppLovin.

iOS

שילוב עם SKAdNetwork

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

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

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

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

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

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

iOS

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

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

הגרסה הבאה

  • הסרתם את השיטות הבאות מהקלאס AppLovin:
    • Initialize()
    • SetIsAgeRestrictedUser(bool)

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

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

גרסה 4.1.0

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

גרסה 4.0.0

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

גרסה 3.1.2

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

גרסה 3.1.1

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

גרסה 3.1.0

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

גרסה 3.0.3

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

גרסה 3.0.2

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

גרסה 3.0.1

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

גרסה 3.0.0

  • תמיכה ב-AppLovin Android SDK בגרסה 8.0.0.
  • תמיכה ב-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.
  • תמיכה ב-AppLovin iOS SDK בגרסה 4.8.3.

גרסה 1.2.0

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

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