התקנה של 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 בגרסאות ה-Build של Android, בוחרים באפשרות Assets > Google Mobile Ads > Settings (נכסים > Google Mobile Ads > הגדרות) בכלי Unity Editor:

בתוך 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 בשילובים של בחירת רשת

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