คู่มือนี้จัดทำขึ้นเพื่อผู้เผยแพร่ที่ได้ผสานรวมบิลด์ทดลองใช้ก่อนเปิดตัวของ 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 แล้ว