התקנה של GMA Next-Gen SDK

כדי ליהנות מהשיפורים בזמן האחזור וביציבות ב-Android, צריך להשתמש ב-GMA Next-Gen SDK. במדריך הזה מוסבר איך להגדיר את Google Mobile Ads Unity Plugin לשימוש ב-GMA Next-Gen SDK ל-Android.

דרישות מוקדמות

לפני שממשיכים, צריך לבצע את הפעולות הבאות:

• מתקינים את Google Mobile Ads Unity Plugin בגרסה 10.6.0 ואילך.
• משתמשים ב-Unity מגרסה 2019.4 ואילך.
• מגדירים את Google Mobile Ads Unity Plugin.
• פרויקט ב-Unity.

צריך לעדכן את רמת ה-API המינימלית ל-24

ב-GMA Next-Gen SDK נדרשת רמת API מינימלית של 24. כדי לעדכן את רמת ה-API המינימלית:

1. בסרגל התפריטים, לוחצים על File (קובץ) > Build Profiles (פרופילי Build) > Player Settings (הגדרות המשחק) > Android > Other Settings (הגדרות נוספות) > Identification (זיהוי).
2. מגדירים את רמת ה-API המינימלית ל-Android 7.0 'Nougat' (רמת API 24) או יותר.

שינוי קובץ התלות

‫11.1.0 ומעלה

כדי להפעיל את GMA Next-Gen SDK בגרסאות ה-Android, בוחרים באפשרות Assets > Google Mobile Ads > Settings (נכסים > Google Mobile Ads > הגדרות) בכלי העריכה של 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, משנים את קובץ התלות:

1. בפרויקט ב-Unity, עוברים לקובץ Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

   • אם אתם משתמשים ב-Unity Package Manager, עוברים אל Packages > Google Mobile Ads for Unity > GoogleMobileAds > Editor > GoogleMobileAdsDependencies.xml.

2. מאתרים את הרכיב <androidPackage> עם המפרט com.google.android.gms:play-services-ads.

3. מחליפים את הרכיב בגרסה הזמינה האחרונה של com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:

   <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0">
     <repositories>
       <repository>https://maven.google.com/</repository>
     </repositories>
   </androidPackage>
   

4. שומרים את הקובץ.

במהלך תהליך ה-build, ‏Google Mobile Ads Unity Plugin מזהה את הנוכחות של GMA Next-Gen SDK ומשתמש בהטמעה שלכם.

אזהרה: עדכון החבילה של GMA Next-Gen SDK מחליף את קובץ התלות. אם מעדכנים את החבילה, חוזרים על השלבים הקודמים.

בדוגמה הבאה מוצג קובץ GoogleMobileAdsDependencies.xml המעודכן:

<dependencies>
<androidPackages>
  <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.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)

אם אתם משתמשים בתהליך בחירת רשת (Mediation), פעלו לפי המדריך להעברת נתונים (מיגרציה) ב-Android כדי להחריג מודולים של com.google.android.gms בשילובים של בחירת הרשת, וכך למנוע שגיאות של מחלקות כפולות.