เวอร์ชันทดลองใช้ก่อนเปิดตัวของ Google Mobile Ads Android SDK

คู่มือนี้จัดทำขึ้นเพื่อผู้เผยแพร่ที่ได้ผสานรวมบิลด์ทดลองใช้ก่อนเปิดตัวของ Google Mobile Ads Android SDK เข้ากับแอป Android ของตน เวอร์ชันทดลองใช้ก่อนเปิดตัว เป็นโอกาสให้คุณได้ใช้ประโยชน์จากฟีเจอร์ใหม่ๆ ของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โดยไม่ต้องรอบริการ Google Play รุ่นถัดไป และให้ประโยชน์ดังต่อไปนี้

  • ทางทีมจะเริ่มใช้ Google Mobile Ads SDK เวอร์ชันใหม่จาก APK ของบริการ Google Play โดยอัตโนมัติเมื่อมีการเปิดตัวฟีเจอร์ทดลองใช้ก่อนเปิดตัวใน APK

  • โดยได้รับการทดสอบอย่างสมบูรณ์และเป็นไปตามเกณฑ์สำหรับรุ่นเดียวกับบิลด์สาธารณะที่มีให้บริการในที่เก็บ Maven ของ Google หรือ SDK Manager

  • โดยเป็น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันเต็ม ซึ่งใหญ่กว่า SDK เวอร์ชัน Lite แต่ไม่ได้อยู่ภายใต้ข้อจำกัดของ SDK เวอร์ชัน Lite

  • ซึ่งสามารถใช้ได้ทั่วโลก ไม่ใช่เฉพาะในแอปที่จัดจำหน่ายผ่าน Google Play เท่านั้น

ทำตามขั้นตอนในหน้านี้เพื่อตั้งค่าที่เก็บ Maven ภายในด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันก่อนเปิดตัวและอ้างอิงว่าเป็นทรัพยากร Dependency ในแอป Android ของคุณ

ข้อกำหนดเบื้องต้น

  • ใช้ Android Studio 3.0 ขึ้นไป
  • กำหนดเป้าหมาย Android API ระดับ 16 ขึ้นไป
  • ไฟล์ ZIP ของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ก่อนเปิดตัวจากผู้จัดการฝ่ายดูแลลูกค้า

กำหนดค่าที่เก็บ Maven ที่กำหนดเอง

ดาวน์โหลดไฟล์ ZIP ของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ก่อนเปิดตัว สร้างโฟลเดอร์ gma_sdk_repo ในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ และวางเนื้อหาทั้งหมดของ ZIP ในโฟลเดอร์นั้น โครงสร้างไดเรกทอรีควรมีลักษณะเหมือน <project_root_dir>/gma_sdk_repo/com/google/...

เปิดไฟล์ระดับโปรเจ็กต์ build.gradle ของแอป

allprojects {
    repositories {
        maven {
            url "${project.rootDir}/gma_sdk_repo"
        }
        google()
        jcenter()

    }
}

เพิ่มบรรทัดเป็นตัวหนาในส่วน allprojects/repositories คำสั่งนี้จะบอกให้ Gradle ค้นหาที่เก็บ Maven ในโฟลเดอร์ gma_sdk_repo ที่คุณเพิ่งสร้างเมื่อแปลค่าทรัพยากร Dependency

เพิ่มการอ้างอิงบิลด์

หากต้องการใช้บิลด์ทดลองใช้ก่อนเปิดตัวของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ในโปรเจ็กต์ คุณจะต้องอ้างอิงว่าเป็นทรัพยากร Dependency ในไฟล์ build.gradle ระดับแอปด้วย เปิดไฟล์ build.gradle ระดับแอป แล้วเพิ่มบรรทัดตัวหนาในข้อมูลโค้ดในส่วน dependencies

dependencies {
    implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...

คุณสามารถดูเวอร์ชันทรัพยากร Dependency ที่แสดงโดย x.y.z ในข้อมูลโค้ดก่อนหน้านี้ได้โดยค้นหาเวอร์ชันล่าสุดที่แสดงอยู่ในไดเรกทอรี com/google/android/gms/play-services-ads/ ในเนื้อหาที่ยกเลิกการเก็บของไฟล์ ZIP SDK สำหรับ Android SDK สำหรับ Google Mobile เวอร์ชันทดลองใช้ก่อนเปิดตัว

แก้ไขความขัดแย้งของ Firebase

หากใช้ไลบรารี Firebase ร่วมกับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ คุณอาจมีทั้งทรัพยากร Dependency com.google.android.gms:play-services-measurement-api และ com.google.android.gms:play-services-measurement-sdk-api รวมอยู่ในโปรเจ็กต์ เวอร์ชันของทรัพยากร Dependency ทั้งสองนี้ต้องตรงกัน แต่คุณอาจพบว่าเวอร์ชันทดลองใช้ก่อนเปิดตัวของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ และ Firebase เวอร์ชันปัจจุบันที่ดึงมาในเวอร์ชันที่แตกต่างกันสําหรับทรัพยากร Dependency 2 รายการนี้

คุณบังคับให้แก้ไขการใช้ทรัพยากร Dependency เป็นเวอร์ชันเฉพาะของไลบรารี play-services-measurement-sdk-api ในไฟล์ build.gradle ของแอปได้ดังนี้

android {
    ...
    configurations.all {
        resolutionStrategy {
            force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
        }
    }
}
...

เวอร์ชัน x.y.z ขึ้นอยู่กับเวอร์ชันของ Firebase นี่คือเวอร์ชันที่ถูกต้องของ Firebase รุ่นล่าสุด

firebase-core เวอร์ชัน play-services-measurement-sdk-api เวอร์ชัน
16.0.7 16.3.0
16.0.6 16.0.4
16.0.5 16.0.3
16.0.4 16.0.2

หากต้องการค้นหาเวอร์ชันที่ถูกต้องสำหรับ Firebase เวอร์ชันอื่นๆ ให้เรียกใช้ gradle androidDependencies สำหรับแอปและใช้เวอร์ชันที่พิมพ์สำหรับทรัพยากร Dependency com.google.android.gms:play-services-measurement-api

ตอนนี้แอป Android ของคุณพร้อมที่จะใช้งานกับบิลด์ทดลองใช้ก่อนเปิดตัวของ Google Mobile Ads Android SDK แล้ว