מודעות מעברון הן מודעות במסך מלא שמכסות את הממשק של האפליקציה המארחת שלהן. הם מוצגים בדרך כלל בנקודות מעבר טבעיות בזרימה של האפליקציה, למשל, בין פעילויות או בזמן ההפסקה בין שלבים במשחק. כשאפליקציה מציגה מודעת מעברון, המשתמש יכול להקיש על ממשיכים למודעה וממשיכים ליעד שלה או סוגרים אותה וחוזרים לאפליקציה.
במדריך הזה מוסבר איך לשלב מודעות מעברון במכשיר Android אפליקציה.
דרישות מוקדמות
- Google Mobile Ads SDK מגרסה 19.7.0 ואילך.
- מבצעים את ההוראות במדריך לתחילת העבודה.
ביצוע בדיקות באמצעות מודעות בדיקה תמיד
כשיוצרים ובודקים אפליקציות, חשוב להשתמש במודעות בדיקה במקום במודעות בדיקה של מודעות בשידור חי. אם לא תעשו זאת, ייתכן שהחשבון שלכם יושעה.
הדרך הקלה ביותר לטעון מודעות בדיקה היא להשתמש במזהה הייעודי של יחידת מודעות לבדיקה עבור מודעות מעברון ב-Android:
/21775744923/example/interstitial
הוא הוגדר במיוחד להחזרת מודעות בדיקה עבור כל בקשה, לשימוש בחינם באפליקציות שלכם תוך כדי תכנות, בדיקות וניפוי באגים. צריך רק ליצור יש להחליף אותו במזהה יחידת המודעות שלך לפני פרסום האפליקציה.
למידע נוסף על אופן הפעולה של מודעות בדיקה ב-Mobile Ads SDK, אפשר לעיין במאמר מודעות בדיקה.
טעינת מודעה
כדי לטעון מודעת מעברון, יש להתקשר אל AdManagerInterstitialAd
סטטי
השיטה load()
ומעבירים
AdManagerInterstitialAdLoadCallback
כדי לקבל את הגרסה שנטענה
מודעה או שגיאות אפשריות כלשהן. שימו לב שבדומה לקריאות חוזרות (callback) שטוענים בפורמט אחר,
AdManagerInterstitialAdLoadCallback
מינוף
LoadAdError
כדי לספק פרטים של שגיאה באיכות גבוהה יותר.
Java
import com.google.android.gms.ads.admanager.AdManagerInterstitialAd;
import com.google.android.gms.ads.admanager.AdManagerInterstitialAdLoadCallback;
public class MainActivity extends Activity {
private AdManagerInterstitialAd mAdManagerInterstitialAd;
private static final String TAG = "MainActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
AdManagerInterstitialAd.load(this,"/21775744923/example/interstitial", adRequest,
new AdManagerInterstitialAdLoadCallback() {
@Override
public void onAdLoaded(@NonNull AdManagerInterstitialAd interstitialAd) {
// The mAdManagerInterstitialAd reference will be null until
// an ad is loaded.
mAdManagerInterstitialAd = interstitialAd;
Log.i(TAG, "onAdLoaded");
}
@Override
public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
// Handle the error
Log.d(TAG, loadAdError.toString());
mAdManagerInterstitialAd = null;
}
});
}
}
Kotlin
import com.google.android.gms.ads.admanager.AdManagerInterstitialAd;
import com.google.android.gms.ads.admanager.AdManagerInterstitialAdLoadCallback;
class MainActivity : AppCompatActivity() {
private var mAdManagerInterstitialAd: AdManagerInterstitialAd? = null
private final val TAG = "MainActivity"
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
var adRequest = AdRequest.Builder().build()
AdManagerInterstitialAd.load(this,"/21775744923/example/interstitial", adRequest, object : AdManagerInterstitialAdLoadCallback() {
override fun onAdFailedToLoad(adError: LoadAdError) {
Log.d(TAG, adError?.toString())
mAdManagerInterstitialAd = null
}
override fun onAdLoaded(interstitialAd: AdManagerInterstitialAd) {
Log.d(TAG, 'Ad was loaded.')
mAdManagerInterstitialAd = interstitialAd
}
})
}
}
הגדרת FullScreenContentCallback
FullScreenContentCallback
מטפל באירועים שקשורים להצגת
InterstitialAd
. לפני הצגה של InterstitialAd
, עליך לוודא שהגדרת
קריאה חוזרת:
Java
mAdManagerInterstitialAd.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.");
mAdManagerInterstitialAd = null;
}
@Override
public void onAdFailedToShowFullScreenContent(AdError adError) {
// Called when ad fails to show.
Log.e(TAG, "Ad failed to show fullscreen content.");
mAdManagerInterstitialAd = 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
mAdManagerInterstitialAd?.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.
Log.d(TAG, "Ad dismissed fullscreen content.")
mAdManagerInterstitialAd = null
}
override fun onAdFailedToShowFullScreenContent(adError: AdError?) {
// Called when ad fails to show.
Log.e(TAG, "Ad failed to show fullscreen content.")
mAdManagerInterstitialAd = 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.")
}
}
הצגת המודעה
צריך להציג את מודעות המעברון כשיש השהיות טבעיות בזרימה של האפליקציה.
דוגמה טובה לכך היא בין שלבים במשחק, או אחרי שהמשתמש משלים משימה.
כדי להציג מודעת מעברון, צריך להשתמש
show()
.
Java
if (mAdManagerInterstitialAd != null) {
mAdManagerInterstitialAd.show(MyActivity.this);
} else {
Log.d("TAG", "The interstitial ad wasn't ready yet.");
}
Kotlin
if (mAdManagerInterstitialAd != null) {
mAdManagerInterstitialAd?.show(this)
} else {
Log.d("TAG", "The interstitial ad wasn't ready yet.")
}
כמה שיטות מומלצות
- כדאי לבדוק אם מודעות מעברון הן סוג המודעה המתאים לאפליקציה שלכם.
- מודעות מעברון פועלות בצורה הטובה ביותר באפליקציות עם נקודות מעבר טבעיות. המסקנה של משימה בתוך אפליקציה, כמו שיתוף תמונה או השלמת משימה שלב במשחק, יוצרת נקודה כזו. חשוב לשקול את הנקודות תהליך העבודה של האפליקציה יאפשר להציג מודעות מעברון ואת הסבירות שהמשתמש להשיב.
- זכרו להשהות את הפעולה בזמן ההצגה של מודעת מעברון.
- יש כמה סוגים שונים של מודעות מעברון: טקסט, תמונה, וידאו ועוד. חשוב לוודא שכאשר האפליקציה מציגה כמודעת מעברון, היא גם משעה את השימוש במשאבים מסוימים כדי לאפשר למודעה לנצל אותם. לדוגמה, כשמתקשרים כדי להציג מודעת מעברון, הקפידו להשהות את כל פלט האודיו באפליקציה.
- צריך לאפשר זמן טעינה מתאים.
- בדיוק כמו שחשוב לוודא שמודעות המעברון מוצגות
מתאים, חשוב גם לוודא שהמשתמש לא צריך
להמתין לטעינה שלהן. טעינת המודעה מראש באמצעות התקשרות
load()
לפני שמתכוונים להתקשר האפליקציהshow()
יכולה לוודא שיש באפליקציה מודעת מעברון נטענת כשיגיע הזמן להציג סרטון כזה. - אסור להציף את המשתמש במודעות.
- למרות שהגברת התדירות של מודעות מעברון באפליקציה שלך, זה עשוי להיראות כמו דרך נהדרת להגדיל את ההכנסות, היא גם יכולה לפגוע בחוויית המשתמש ושיעורי קליקים נמוכים יותר. ודאו שהמשתמשים לא בתדירות גבוהה במקרה שהם לא יוכלו יותר ליהנות מהשימוש באפליקציה שלך.
דוגמאות ב-GitHub
השלבים הבאים
- למידע נוסף בנושא מיקוד מודעות.
- מידע נוסף על פרטיות המשתמשים
- מידע נוסף על אתחול וטעינת מודעות שעברו אופטימיזציה ל-SDK (בטא).