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

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

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

מתאם בחירת הרשת של Ad Manager ל-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.

כדי להגדיר את יחידת המודעות ב-Ad Manager, תצטרכו את מפתח ה-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 ל-Ad Manager.

כדי להטמיע app-ads.txt ב-Applovin, מוסיפים את AppLovin לקובץ app-ads.txt.

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

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

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

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

Android

הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

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

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

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

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 ל-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), בבריטניה ובשווייץ, ולקבל מהם הסכמה לשימוש בקובצי Cookie או באחסון מקומי אחר במקרים שבהם הדבר נדרש על פי חוק, וכן לאיסוף, לשיתוף ולשימוש במידע אישי לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-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: בדיקת ההטמעה

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

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

קוד שגיאה סיבה
‫‎-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 שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
103 הצגת המודעה של AppLovin נכשלה.
104 הוגשו בקשות לכמה מודעות לאותו אזור. המערכת של AppLovin יכולה לטעון רק מודעה אחת בכל פעם לכל אזור.
105 לא נמצא מפתח AppLovin SDK.
107 הטוקן של הצעת המחיר ריק.
108 המתאם של AppLovin לא תומך בפורמט המודעה שמתבקש.
110 AppLovin שלחה קריאה חוזרת (callback) לטעינה מוצלחת, אבל טענה אפס מודעות.
111 לא ניתן לאחזר מופע של AppLovin SDK.
112 המשתמש הוא ילד או ילדה.
113 המופע המשותף של AppLovin SDK לא הופעל.
114 ה-SDK של AppLovin לא מחזיר טוקן בידינג.

יומן השינויים של 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.
  • תמיכה בגרסה 4.7.0 של AppLovin iOS SDK.

גרסה 1.0.0

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