پیاده‌سازی آگهی‌های فشرده‌سازی (بتا)

اسکوییزبک

آگهی‌های Squeezeback محتوای برنامه شما را در نمای کوچک‌تری قرار می‌دهند و آگهی بومی را در فضای اطراف نمایش می‌دهند. این قالب به کاربران اجازه می‌دهد با برنامه‌تان تعامل داشته باشند درحالی‌که آگهی همچنان نمایان است. برای نمایش آگهی‌هایی که محتوای برنامه‌تان را نمی‌پوشانند، این قالب را انتخاب کنید.

این راهنما درخواست و نمایش آگهی‌های squeezeback در برنامه‌تان را بااستفاده از GMA Next-Gen SDK پوشش می‌دهد.

قبل‌از شروع

قبل‌از ادامه دادن، کارهای زیر را انجام دهید:

بار کردن آگهی

برای بار کردن شیء SqueezebackAd ، درخواست آگهی ایجاد کنید و روش load را فراخوانی کنید. مثال زیر آگهی squeezeback بارشده را ذخیره می‌کند، برای رویدادهای آگهی ثبت‌نام می‌کند، و خطا را درصورت ناموفق بودن ثبت می‌کند:

Kotlin

private fun loadSqueezebackAd() {
  val request = SqueezebackAdRequest.Builder(AD_UNIT_ID).build()

  SqueezebackAd.load(
    request,
    object : AdLoadCallback<SqueezebackAd> {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.w(TAG, "Squeezeback ad failed to load: $adError")
      }

      override fun onAdLoaded(ad: SqueezebackAd) {
        Log.d(TAG, "Squeezeback ad loaded.")

        // Capture the SqueezebackAd reference for later use.
        squeezebackAd = ad
        setAdEventCallback(ad)
      }
    },
  )
}

جاوا

private void loadSqueezebackAd() {
  SqueezebackAdRequest request = new SqueezebackAdRequest.Builder(AD_UNIT_ID).build();

  SqueezebackAd.load(
      request,
      new AdLoadCallback<SqueezebackAd>() {
        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.w(TAG, "Squeezeback ad failed to load: " + adError);
        }

        @Override
        public void onAdLoaded(@NonNull SqueezebackAd ad) {
          Log.d(TAG, "Squeezeback ad loaded.");

          // Capture the SqueezebackAd reference for later use.
          squeezebackAd = ad;
          setAdEventCallback(ad);
        }
      });
}

AD_UNIT_ID را با شناسه واحد آگهی‌تان جایگزین کنید.

نمایش آگهی

برای نمایش آگهی squeezeback در صفحه، روش show را فراخوانی کنید:

Kotlin

private fun showSqueezebackAd(activity: Activity) {
  // Capture the ad reference saved from the onAdLoaded callback.
  val ad = squeezebackAd
  if (ad != null) {
    ad.show(activity)
  } else {
    Log.d(TAG, "No ad to show.")
  }
}

جاوا

private void showSqueezebackAd(@NonNull Activity activity) {
  // Use the ad reference saved from the onAdLoaded callback.
  if (squeezebackAd != null) {
    squeezebackAd.show(activity);
  } else {
    Log.d(TAG, "No ad to show.");
  }
}

تنظیم رنگ پس‌زمینه بازگشتی

به‌طور پیش‌فرض، GMA Next-Gen SDK پس‌زمینه خاکستری تیره‌ای را پشت محتوای برنامه و آگهی کاهش‌یافته نمایش می‌دهد. برای سفارشی‌سازی این رنگ، رنگ پس‌زمینه جایگزینی را در گزینه‌های آگهی‌تان هنگام نمایش آگهی مشخص کنید. مثال زیر رنگ پس‌زمینه جایگزین را روی خاکستری تیره تنظیم می‌کند و آگهی را نشان می‌دهد:

Kotlin

private fun showSqueezebackAdWithFallbackBackgroundColor(activity: Activity) {
  // Capture the ad reference saved from the onAdLoaded callback.
  val ad = squeezebackAd
  if (ad != null) {
    val options =
      SqueezebackAdOptions.Builder()
        // Sets the fallback background color for the space behind the shrunken content and ad.
        .setFallbackBackgroundColor(Color.DKGRAY)
        .build()
    ad.show(activity, options)
  } else {
    Log.d(TAG, "No ad to show.")
  }
}

جاوا

private void showSqueezebackAdWithFallbackBackgroundColor(@NonNull Activity activity) {
  // Use the ad reference saved from the onAdLoaded callback.
  if (squeezebackAd != null) {
    SqueezebackAdOptions options =
        new SqueezebackAdOptions.Builder()
            // Sets the fallback background color for the space behind the shrunken content and
            // ad.
            .setFallbackBackgroundColor(Color.DKGRAY)
            .build();
    squeezebackAd.show(activity, options);
  } else {
    Log.d(TAG, "No ad to show.");
  }
}

گوش دادن به رویدادهای آگهی

برای مدیریت رویدادهای چرخه حیات آگهی squeezeback، قبل‌از نمایش آگهی‌تان، برای رویدادهای آگهی ثبت‌نام کنید. این رویدادها تعاملات آگهی را گزارش می‌کنند، مانند کلیک‌ها و ظهورها. این رویدادها همچنین رویدادهای خاص squeezeback را گزارش می‌کنند، مانند زمانی که آگهی نمایش داده می‌شود، نمایش داده نمی‌شود، یا پنهان می‌شود.

Kotlin

private fun setAdEventCallback(squeezebackAd: SqueezebackAd) {
  squeezebackAd.adEventCallback =
    object : SqueezebackAdEventCallback {
      override fun onAdShown() {
        Log.d(TAG, "Squeezeback ad shown.")
      }

      override fun onAdHidden() {
        // Called when hide() is invoked or the user taps the close button.
        // The ad cannot be shown again after it is hidden.
        Log.d(TAG, "Squeezeback ad hidden.")
      }

      override fun onAdFailedToShow(error: FullScreenContentError) {
        Log.w(TAG, "Squeezeback ad failed to show: $error")
      }

      override fun onAdImpression() {
        Log.d(TAG, "Squeezeback ad recorded an impression.")
      }

      override fun onAdClicked() {
        Log.d(TAG, "Squeezeback ad recorded a click.")
      }

      override fun onAdShowedFullScreenContent() {
        Log.d(TAG, "Squeezeback ad showed full screen content.")
      }

      override fun onAdDismissedFullScreenContent() {
        Log.d(TAG, "Squeezeback ad dismissed full screen content.")
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        Log.w(TAG, "Squeezeback ad failed to show full screen content: $fullScreenContentError")
      }

      override fun onAdPaid(value: AdValue) {
        Log.d(TAG, "Squeezeback ad paid: ${value.valueMicros} ${value.currencyCode}")
      }
    }
}

جاوا

private void setAdEventCallback(@NonNull SqueezebackAd squeezebackAd) {
  squeezebackAd.setAdEventCallback(
      new SqueezebackAdEventCallback() {
        @Override
        public void onAdShown() {
          Log.d(TAG, "Squeezeback ad shown.");
        }

        @Override
        public void onAdHidden() {
          // Called when hide() is invoked or the user taps the close button.
          // The ad cannot be shown again after it is hidden.
          Log.d(TAG, "Squeezeback ad hidden.");
        }

        @Override
        public void onAdFailedToShow(@NonNull FullScreenContentError error) {
          Log.w(TAG, "Squeezeback ad failed to show: " + error);
        }

        @Override
        public void onAdImpression() {
          Log.d(TAG, "Squeezeback ad recorded an impression.");
        }

        @Override
        public void onAdClicked() {
          Log.d(TAG, "Squeezeback ad recorded a click.");
        }

        @Override
        public void onAdShowedFullScreenContent() {
          Log.d(TAG, "Squeezeback ad showed full screen content.");
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          Log.d(TAG, "Squeezeback ad dismissed full screen content.");
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          Log.w(
              TAG,
              "Squeezeback ad failed to show full screen content: " + fullScreenContentError);
        }

        @Override
        public void onAdPaid(@NonNull AdValue value) {
          Log.d(
              TAG,
              "Squeezeback ad paid: " + value.getValueMicros() + " " + value.getCurrencyCode());
        }
      });
}

پس‌از اینکه کاربر آگهی را رد کرد، GMA Next-Gen SDK رویداد پنهان آگهی را فراخوانی می‌کند و دیگر نمی‌توانید آگهی را دوباره نشان دهید.

پنهان کردن آگهی

برای برداشتن آگهی و بازیابی محتوای برنامه به اندازه کامل، روش hide را فراخوانی کنید. این روش رویداد پنهان آگهی را فراخوانی می‌کند. مثال زیر وجود مرجع آگهی squeezeback ذخیره‌شده را بررسی می‌کند و درصورت وجود، آگهی را پنهان می‌کند:

Kotlin

private fun hideSqueezebackAd() {
  // Capture the ad reference saved from the onAdLoaded callback.
  val ad = squeezebackAd
  if (ad != null) {
    ad.hide()
  } else {
    Log.d(TAG, "No ad to hide.")
  }
}

جاوا

private void hideSqueezebackAd() {
  // Use the ad reference saved from the onAdLoaded callback.
  if (squeezebackAd != null) {
    squeezebackAd.hide();
  } else {
    Log.d(TAG, "No ad to hide.");
  }
}

پاک‌سازی منابع آگهی

برای جلوگیری از نشت حافظه، وقتی برنامه‌تان استفاده از آگهی را تمام کرد، ارجاع به شیء آگهی را رها کنید. مثال زیر آگهی را پاک می‌کند:

Kotlin

private fun cleanUpSqueezebackAd() {
  squeezebackAd?.destroy()
  squeezebackAd = null
}

جاوا

private void cleanUpSqueezebackAd() {
  // Use the ad reference saved from the onAdLoaded callback.
  if (squeezebackAd != null) {
    squeezebackAd.destroy();
    squeezebackAd = null;
  }
}