כדי ליהנות מהשיפורים בזמן האחזור וביציבות ב-Android, צריך להשתמש ב-GMA Next-Gen SDK. במדריך הזה מוסבר איך להגדיר את Google Mobile Ads Unity Plugin לשימוש ב-GMA Next-Gen SDK ל-Android.
דרישות מוקדמות
לפני שממשיכים, צריך לבצע את הפעולות הבאות:
- מתקינים את גרסה 10.6.0 ומעלה של Google Mobile Ads Unity Plugin.
- משתמשים ב-Unity בגרסה 2019.4 ואילך.
- מגדירים את Google Mobile Ads Unity Plugin.
- פרויקט ב-Unity.
צריך לעדכן את רמת ה-API המינימלית ל-24
ב-GMA Next-Gen SDK נדרשת רמת API מינימלית של 24. כדי לעדכן את רמת ה-API המינימלית:
- בסרגל התפריטים, לוחצים על קובץ > פרופילי Build > הגדרות המשחק > Android > הגדרות נוספות > זיהוי.
- מגדירים את רמת ה-API המינימלית ל-Android 7.0 'Nougat' (רמת API 24) או לרמה גבוהה יותר.
שינוי קובץ התלות
11.1.0 ומעלה
כדי להפעיל את GMA Next-Gen SDK בגרסאות ה-Android, בוחרים באפשרות Assets > Google Mobile Ads > Settings בכלי העריכה של Unity:

במפקח ההגדרות של GMA Next-Gen SDK, מפעילים את Switch Google Mobile Ads Android Architecture וגם את GMA Next-Gen SDK.

11.0.0 - 10.6.0
כדי להפעיל את GMA Next-Gen SDK בגרסאות ה-build ל-Android, משנים את קובץ התלות:
בפרויקט ב-Unity, עוברים לקובץ
Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.- אם אתם משתמשים ב-Unity Package Manager, עוברים אל Packages > Google Mobile Ads for Unity > GoogleMobileAds > Editor > GoogleMobileAdsDependencies.xml.
מאתרים את הרכיב
<androidPackage>עם המפרטcom.google.android.gms:play-services-ads.מחליפים את הרכיב בגרסה הזמינה האחרונה של
com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:<androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0"> <repositories> <repository>https://maven.google.com/</repository> </repositories> </androidPackage>שומרים את הקובץ.
במהלך תהליך ה-build, Google Mobile Ads Unity Plugin מזהה את הנוכחות של GMA Next-Gen SDK ומשתמש בהטמעה שלכם.
בדוגמה הבאה מוצג קובץ GoogleMobileAdsDependencies.xml המעודכן:
<dependencies>
<androidPackages>
<androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0">
<repositories>
<repository>https://maven.google.com/</repository>
</repositories>
</androidPackage>
<androidPackage spec="androidx.constraintlayout:constraintlayout:2.1.4">
<repositories>
<repository>https://maven.google.com/</repository>
</repositories>
</androidPackage>
<androidPackage spec="androidx.lifecycle:lifecycle-process:2.6.2">
<repositories>
<repository>https://maven.google.com/</repository>
</repositories>
</androidPackage>
</androidPackages>
<iosPods>
<iosPod name="Google-Mobile-Ads-SDK" version="~> 12.11.0">
<sources>
<source>https://github.com/CocoaPods/Specs</source>
</sources>
</iosPod>
</iosPods>
</dependencies>
החרגת מודולים של com.google.android.gms בשילובים של מנגנון בחירת הרשת (Mediation)
אם אתם משתמשים בתהליך בחירת רשת, פעלו לפי המדריך להעברת נתונים (מיגרציה) ב-Android כדי להחריג את המודולים של com.google.android.gms בשילובים של בחירת הרשת, וכך להימנע משגיאות של כפילות במחלקות.