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

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

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

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

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

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

  1. בסרגל התפריטים, לוחצים על קובץ > פרופילי Build > הגדרות המשחק > Android > הגדרות נוספות > זיהוי.
  2. מגדירים את רמת ה-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, משנים את קובץ התלות:

  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.5.0">
      <repositories>
        <repository>https://maven.google.com/</repository>
      </repositories>
    </androidPackage>
    
  4. שומרים את הקובץ.

במהלך תהליך ה-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 בשילובים של בחירת הרשת, וכך להימנע משגיאות של כפילות במחלקות.