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

בחירת פלטפורמה: ‫Android (בטא) Android iOS Unity Flutter

במדריך הזה מוסבר איך להשתמש ב-GMA Next-Gen SDK כדי לטעון ולהציג מודעות מ-AppLovin באמצעות מנגנון בחירת הרשת. המדריך כולל הסברים על שילובים של שיטת ה-Waterfall ושל בידינג. המאמר מסביר איך להוסיף את AppLovin להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של AppLovin באפליקציית Android.

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

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

‫¹ הפורמט של מודעות בפתיחת האפליקציה זמין רק לשילובים של Waterfall.

‫² בשיטת Waterfall נתמכים רק מודעות באנר בגדלים 320x50 ו-728x90. בידינג לא תומך במודעות באנר.

דרישות

• רמת API‏ 24 ומעלה ב-Android

• ‫[לבידינג]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בגרסה 9.4.2.0 של AppLovin adapter ואילך (מומלץ להשתמש בגרסה העדכנית).

• חדש מערוץ GMA Next-Gen SDK

• ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה

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

נרשמים או מתחברים לחשבון ב-AppLovin.

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

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

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

יצירת אזור

עדכון של הקובץ 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

נכנסים לחשבון Ad Manager.

הוספת AppLovin בקטע 'חברות'

הפעלת שיתוף אותות מאובטח

שיתוף אותות מאובטחים בבקשות להצעות מחיר

איך מאפשרים שיתוף אותות מאובטחים בבידינג מבוסס SDK

הגדרת בידינג ב-AppLovin

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

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

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

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

שילוב עם Android Studio (מומלץ)

בקובץ gradle ברמת האפליקציה, מוסיפים את התלות וההגדרות הבאות של implementation:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:applovin:13.5.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:applovin:13.5.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

שילוב ידני

• מורידים את AppLovin Android SDK, מחלצים את applovin-sdk-x.y.z.jar ומוסיפים אותו לפרויקט.

• עוברים אל הארטיפקטים של מתאם AppLovin במאגר ה-Maven של Google. בוחרים את הגרסה העדכנית, מורידים את קובץ ה-‎ .aar של המתאם של AppLovin ומוסיפים אותו לפרויקט.

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

הסכמה בהתאם לתקנות האירופאיות ול-GDPR

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

החל מגרסה 12.0.0 של SDK, ‏ AppLovin תומכת בקריאת מחרוזת ההסכמה מההעדפות שמשותפות ובהגדרת סטטוס ההסכמה בהתאם.

אם אתם לא משתמשים ב-AppLovin SDK בגרסה 12.0.0 ומעלה או בפלטפורמת CMP שכותבת את מחרוזת ההסכמה להעדפות המשותפות, אתם יכולים להשתמש בשיטה setHasUserConsent. בדוגמה הבאה אפשר לראות איך מעבירים את פרטי ההסכמה אל AppLovin SDK. צריך להגדיר את האפשרויות האלה לפני שמבצעים הפעלה של GMA Next-Gen SDK, כדי לוודא שהן יועברו בצורה תקינה אל AppLovin SDK.

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setHasUserConsent(true)
AppLovinMediationSnippets.kt

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

הצהרה על משתמשים קטינים

החל מגרסה 13.0.0 של AppLovin SDK,‏ AppLovin לא תומכת יותר בסימון משתמשים עם הגבלת גיל, ואסור לכם לאתחל את AppLovin SDK או להשתמש בו בהקשר של 'ילד' כהגדרתו בחוקים הרלוונטיים. מידע נוסף מופיע במסמכי העזרה של AppLovin בנושא איסור שימוש בנתונים של ילדים או שימוש בשירותים לילדים או באפליקציות שמיועדות לילדים בלבד.

מתאם AppLovin מגרסה 13.0.0.1 ואילך משבית אוטומטית את תהליך בחירת הרשת של AppLovin באפליקציות שמוצהרות בהן אחת מההגדרות הבאות עם התג GMA Next-Gen SDK:

• הגדרה של תוכן לילדים

• משתמשים מתחת לגיל המינימלי

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

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

ערכת AppLovin SDK כוללת את השיטה setDoNotSell שמאפשרת לבעלי אפליקציות לבטל את ההסכמה למכירת מידע אישי.

בדוגמה הבאה אפשר לראות איך מעבירים את פרטי ההסכמה אל AppLovin SDK. צריך להגדיר את האפשרויות האלה לפני שמבצעים הפעלה של GMA Next-Gen SDK, כדי לוודא שהן יועברו בצורה תקינה אל AppLovin SDK.

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setDoNotSell(true)
AppLovinMediationSnippets.kt

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

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

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

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

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

חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager והפעלתם את מצב הבדיקה בממשק המשתמש של AppLovin.

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-AppLovin, מפעילים בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות AppLovin (Bidding)‎ (AppLovin (בידינג)) ו-AppLovin (Waterfall)‎ (AppLovin (Waterfall)).

שלבים אופציונליים

פרמטרים ספציפיים לרשת

המתאם של AppLovin תומך ב-setMuteAudio(), שמאפשר להשבית את האודיו במודעות וידאו. אפשר להפעיל את השיטה הזו מאובייקט AppLovinExtras.Builder():

Bundle extras = new AppLovinExtras.Builder()
  .setMuteAudio(true)
  .build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
  .putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
  .build();

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

אופטימיזציות

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-AppLovin, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo.getAdSourceResponses() במחלקות הבאות:

com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של AppLovin כשהטעינה של מודעה נכשלת: