ข้อกำหนดเบื้องต้น
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.7.0 ขึ้นไป
- ทำตามคู่มือเริ่มต้นใช้งานจนจบ
ทดสอบด้วยโฆษณาทดสอบเสมอ
เมื่อสร้างและทดสอบแอป โปรดตรวจสอบว่าคุณใช้โฆษณาทดสอบแทน โฆษณาที่ใช้งานจริง หากไม่ดำเนินการ บัญชีจะถูกระงับ
วิธีที่ง่ายที่สุดในการโหลดโฆษณาทดสอบคือการใช้รหัสหน่วยโฆษณาทดสอบโดยเฉพาะของเรา โฆษณาที่มีการให้รางวัลของ Android
ca-app-pub-3940256099942544/5224354917
โดยได้รับการกำหนดค่าเป็นพิเศษให้ส่งคืนโฆษณาทดสอบสำหรับทุกคำขอ โดยคุณจะ นำไปใช้ในแอปของคุณเองขณะเขียนโค้ด ทดสอบ และแก้ไขข้อบกพร่องได้ฟรี ทำ อย่าลืมแทนที่ด้วยรหัสหน่วยโฆษณาของคุณเองก่อนที่จะเผยแพร่แอป
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของโฆษณาทดสอบ SDK โฆษณาบนอุปกรณ์เคลื่อนที่ โปรดดูการทดสอบ โฆษณา
โหลดออบเจ็กต์โฆษณาที่มีการให้รางวัล
โฆษณาที่มีการให้รางวัลจะโหลดโดยการเรียกใช้เมธอด load()
แบบคงที่ใน
RewardedAd
ชั้นเรียนและการสอบผ่านใน RewardedAdLoadCallback
ปกติแล้ว
ดำเนินการในเมธอด onCreate()
ของ Activity
โปรดสังเกตว่าเหมือนกับการโหลด Callback รูปแบบอื่นๆ RewardedAdLoadCallback
ใช้ประโยชน์จาก LoadAdError
เพื่อระบุรายละเอียดข้อผิดพลาดเกี่ยวกับความแม่นยำที่สูงขึ้น
Java
import com.google.android.gms.ads.rewarded.RewardedAd;
public class MainActivity extends Activity {
private RewardedAd rewardedAd;
private final String TAG = "MainActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
RewardedAd.load(this, "ca-app-pub-3940256099942544/5224354917",
adRequest, new RewardedAdLoadCallback() {
@Override
public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
// Handle the error.
Log.d(TAG, loadAdError.toString());
rewardedAd = null;
}
@Override
public void onAdLoaded(@NonNull RewardedAd ad) {
rewardedAd = ad;
Log.d(TAG, "Ad was loaded.");
}
});
}
}
Kotlin
class MainActivity : AppCompatActivity() {
private var rewardedAd: RewardedAd? = null
private final var TAG = "MainActivity"
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
var adRequest = AdManagerAdRequest.Builder().build()
RewardedAd.load(this,"ca-app-pub-3940256099942544/5224354917", adRequest, object : RewardedAdLoadCallback() {
override fun onAdFailedToLoad(adError: LoadAdError) {
Log.d(TAG, adError?.toString())
rewardedAd = null
}
override fun onAdLoaded(ad: RewardedAd) {
Log.d(TAG, "Ad was loaded.")
rewardedAd = ad
}
})
}
}
ตั้งค่า FullScreenContentCallback
FullScreenContentCallback
จะจัดการกิจกรรมที่เกี่ยวข้องกับการแสดง
RewardedAd
อย่าลืมตั้งค่า Callback ก่อนแสดง RewardedAd
ดังนี้
Java
rewardedAd.setFullScreenContentCallback(new FullScreenContentCallback() {
@Override
public void onAdClicked() {
// Called when a click is recorded for an ad.
Log.d(TAG, "Ad was clicked.");
}
@Override
public void onAdDismissedFullScreenContent() {
// Called when ad is dismissed.
// Set the ad reference to null so you don't show the ad a second time.
Log.d(TAG, "Ad dismissed fullscreen content.");
rewardedAd = null;
}
@Override
public void onAdFailedToShowFullScreenContent(AdError adError) {
// Called when ad fails to show.
Log.e(TAG, "Ad failed to show fullscreen content.");
rewardedAd = null;
}
@Override
public void onAdImpression() {
// Called when an impression is recorded for an ad.
Log.d(TAG, "Ad recorded an impression.");
}
@Override
public void onAdShowedFullScreenContent() {
// Called when ad is shown.
Log.d(TAG, "Ad showed fullscreen content.");
}
});
Kotlin
rewardedAd?.fullScreenContentCallback = object: FullScreenContentCallback() {
override fun onAdClicked() {
// Called when a click is recorded for an ad.
Log.d(TAG, "Ad was clicked.")
}
override fun onAdDismissedFullScreenContent() {
// Called when ad is dismissed.
// Set the ad reference to null so you don't show the ad a second time.
Log.d(TAG, "Ad dismissed fullscreen content.")
rewardedAd = null
}
override fun onAdFailedToShowFullScreenContent(adError: AdError?) {
// Called when ad fails to show.
Log.e(TAG, "Ad failed to show fullscreen content.")
rewardedAd = null
}
override fun onAdImpression() {
// Called when an impression is recorded for an ad.
Log.d(TAG, "Ad recorded an impression.")
}
override fun onAdShowedFullScreenContent() {
// Called when ad is shown.
Log.d(TAG, "Ad showed fullscreen content.")
}
}
แสดงโฆษณา
เมื่อแสดงโฆษณาที่มีการให้รางวัล คุณจะใช้ออบเจ็กต์ OnUserEarnedRewardListener
เพื่อจัดการกิจกรรมเกี่ยวกับรางวัล
Java
if (rewardedAd != null) {
Activity activityContext = MainActivity.this;
rewardedAd.show(activityContext, new OnUserEarnedRewardListener() {
@Override
public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
// Handle the reward.
Log.d(TAG, "The user earned the reward.");
int rewardAmount = rewardItem.getAmount();
String rewardType = rewardItem.getType();
}
});
} else {
Log.d(TAG, "The rewarded ad wasn't ready yet.");
}
Kotlin
rewardedAd?.let { ad ->
ad.show(this, OnUserEarnedRewardListener { rewardItem ->
// Handle the reward.
val rewardAmount = rewardItem.amount
val rewardType = rewardItem.type
Log.d(TAG, "User earned the reward.")
})
} ?: run {
Log.d(TAG, "The rewarded ad wasn't ready yet.")
}
คำถามที่พบบ่อย
- มีการหมดเวลาสำหรับการเรียกการเริ่มต้นหรือไม่
- หลังผ่านไป 10 วินาที SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะเรียกใช้
OnInitializationCompleteListener
แม้ว่าเครือข่ายสื่อกลางจะยังไม่ เริ่มต้นเสร็จสมบูรณ์แล้ว - จะเกิดอะไรขึ้นหากเครือข่ายสื่อกลางบางเครือข่ายยังไม่พร้อมเมื่อฉันได้รับการติดต่อกลับเพื่อเริ่มต้น
เราขอแนะนำให้โหลดโฆษณาภายใน Callback ของ
OnInitializationCompleteListener
แม้ว่าเครือข่ายสื่อกลางจะยังไม่พร้อม SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ยังคงขอโฆษณาจากเครือข่ายนั้น ดังนั้นถ้า เครือข่ายสื่อกลางเริ่มต้นทำงานให้เสร็จสิ้นหลังจากหมดเวลา คำขอโฆษณาในอนาคตในเซสชันนั้นคุณสามารถสำรวจสถานะการเริ่มต้นของอะแดปเตอร์ทั้งหมดต่อไปได้ เซสชันแอปของคุณโดยโทรหา
MobileAds.getInitializationStatus()
- ฉันจะทราบได้อย่างไรว่าเครือข่ายสื่อกลางหนึ่งๆ ไม่พร้อมใช้งาน
AdapterStatus.getDescription()
อธิบายสาเหตุที่อะแดปเตอร์ยังไม่พร้อม คำขอโฆษณาบริการ- ระบบเรียก Callback
onUserEarnedReward()
ก่อนการเรียกกลับonAdDismissedFullScreenContent()
ทุกครั้งไหม สำหรับโฆษณา Google การเรียก
onUserEarnedReward()
ทั้งหมดจะเกิดขึ้นก่อนonAdDismissedFullScreenContent()
สำหรับโฆษณาที่แสดงผ่าน Mediation โฆษณาของบุคคลที่สาม การใช้งาน SDK เครือข่ายจะกำหนดลำดับการติดต่อกลับ สำหรับเครือข่ายโฆษณา SDK ที่มีการเรียกกลับแบบปิดครั้งเดียวพร้อมข้อมูลรางวัล อะแดปเตอร์สื่อกลางจะเรียกใช้onUserEarnedReward()
ก่อนวันที่onAdDismissedFullScreenContent()
ตัวอย่างใน GitHub
ขั้นตอนถัดไป
สำรวจหัวข้อต่อไปนี้