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

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

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

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

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

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

בידינג

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

מפל

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

יצירת אזור

בידינג

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

מפל

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

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 לבחירת רשת (Mediation) של Applovin ל-Unity בפרויקט שלכם. לשם כך, מריצים את הפקודה הבאה מהספרייה ברמה הבסיסית (root) של הפרויקט:

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 שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

ייבוא מ-Unity

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

אילוץ פתרון

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

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

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

אם אתם לא משתמשים בפלאגין של תהליך בחירת הרשת של Google Mobile Ads ל-Applovin בגרסה 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.

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

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

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

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

חשוב לרשום את מכשיר הבדיקה ב-Ad Manager ולהפעיל את מצב הבדיקה בממשק המשתמש של 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

קוד שגיאה סיבה
-1,009 עד -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 שלחה קריאה חוזרת לטעינה שהצליחה, אבל לא נטענו אף מודעות.
111 לא ניתן לאחזר מופע של AppLovin SDK.
112 המשתמש הוא ילד או ילדה.

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

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

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

גרסה 4.1.0

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

גרסה 4.0.0

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

גרסה 3.1.2

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

  • תמיכה ב-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.

גרסה 2.0.0

  • תמיכה ב-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.