משלבים את 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 Mobile Ads לתהליך בחירת הרשת (Mediation) ב-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 כדי לראות את שני הערכים.

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

בחירת אפליקציה לתהליך בחירת הרשת (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 Ad Manager בממשק המשתמש

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

Android

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

iOS

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

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

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

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

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

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

לאחר מכן, בוחרים נכסים > Play Services Resolutionr > Android resolver > אילוץ פתרון. ספריית Unity Play Services Resolutionr תפתור את יחסי התלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה 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 לתהליך בחירת הרשת ב-Applosin בגרסה 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 לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.

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

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

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