स्क्वीज़बैक विज्ञापन (बीटा वर्शन) लागू करना

स्क्वीज़बैक

Squeezeback विज्ञापन, आपके ऐप्लिकेशन के कॉन्टेंट को छोटे व्यू में दिखाते हैं. साथ ही, आस-पास की जगह में नेटिव विज्ञापन दिखाते हैं. इस फ़ॉर्मैट की मदद से, उपयोगकर्ता विज्ञापन दिखने के दौरान भी आपके ऐप्लिकेशन से इंटरैक्ट कर सकते हैं. अगर आपको ऐसे डिसप्ले विज्ञापन दिखाने हैं जो आपके ऐप्लिकेशन के कॉन्टेंट को न छिपाएं, तो यह फ़ॉर्मैट चुनें.

इस गाइड में, GMA Next-Gen SDK का इस्तेमाल करके आपके ऐप्लिकेशन में squeezeback विज्ञापनों का अनुरोध करने और उन्हें दिखाने के बारे में बताया गया है.

शुरू करने से पहले

आगे बढ़ने से पहले, ये काम करें:

विज्ञापन लोड करना

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)
      }
    },
  )
}

Java

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.")
  }
}

Java

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.")
  }
}

Java

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}")
      }
    }
}

Java

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.")
  }
}

Java

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
}

Java

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