Įdiegti vaizdo vaizde skelbimus (beta versija)

Vaizdas vaizde

Vaizdas vaizde (PiP) skelbimai rodomi plaukiojančiame lange, kuris lieka virš ekrane esančio turinio, pvz., straipsnių, sklaidos kanalų ar žaidimo eigos. Šis formatas leidžia vartotojams sąveikauti su jūsų programa, kol skelbimas lieka matomas. Jei norite rodyti skelbimus, kurie neužima viso ekrano, pasirinkite šį formatą. Sužinokite daugiau apie vaizdo vaizde skelbimus .

Šiame vadove aprašoma, kaip užklausti ir rodyti paveikslėlio vaizde skelbimus programoje naudojant GMA Next-Gen SDK .

Prieš pradėdami

Prieš tęsdami, atlikite šiuos veiksmus:

Įkelti skelbimą

Norėdami įkelti PictureInPictureAd , sukurkite skelbimo užklausą ir iškvieskite „ load metodą:

Kotlinas 

private fun loadPictureInPictureAd() {
  val request = PictureInPictureAdRequest.Builder(AD_UNIT_ID).build()

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

      override fun onAdLoaded(ad: PictureInPictureAd) {
        Log.d(TAG, "Picture-in-Picture ad loaded.")

        // Capture the PictureInPictureAd reference for later use.
        pipAd = ad
        setAdEventCallback(ad)
      }
    },
  )
}

Java 

private void loadPictureInPictureAd() {
  PictureInPictureAdRequest request = new PictureInPictureAdRequest.Builder(AD_UNIT_ID).build();

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

        @Override
        public void onAdLoaded(@NonNull PictureInPictureAd ad) {
          Log.d(TAG, "Picture-in-Picture ad loaded.");

          // Capture the PictureInPictureAd reference for later use.
          pipAd = ad;
          setAdEventCallback(ad);
        }
      });
}

AD_UNIT_ID pakeiskite savo skelbimų rinkinio ID.

Rodyti skelbimą

Norėdami ekrane rodyti paveikslėlio vaizde skelbimą, sukonfigūruokite paveikslėlio vaizde parinktis ir iškvieskite metodą show . Šiame pavyzdyje nustatoma numatytoji skelbimo padėtis ir pateikimo apimtis ekrane:

Kotlinas 

private fun showPictureInPictureAd(activity: Activity) {
  // Capture the ad reference saved from the onAdLoaded callback.
  val ad = pipAd
  if (ad != null) {
    val options =
      PictureInPictureAdOptions.Builder()
        // Uses the Google Mobile Ads SDK's default screen position.
        .setPosition(PictureInPictureAdPosition.DEFAULT)
        // Binds the ad lifecycle to the host screen.
        .setPresentationScope(PictureInPictureAdPresentationScope.SCREEN)
        .build()
    ad.show(activity, options)
  } else {
    Log.d(TAG, "No ad to show.")
  }
}

Java 

private void showPictureInPictureAd(@NonNull Activity activity) {
  // Use the ad reference saved from the onAdLoaded callback.
  if (pipAd != null) {
    PictureInPictureAdOptions options =
        new PictureInPictureAdOptions.Builder()
            // Uses the Google Mobile Ads SDK's default screen position.
            .setPosition(PictureInPictureAdPosition.DEFAULT)
            // Binds the ad lifecycle to the host screen.
            .setPresentationScope(PictureInPictureAdPresentationScope.SCREEN)
            .build();
    pipAd.show(activity, options);
  } else {
    Log.d(TAG, "No ad to show.");
  }
}

Nustatykite poziciją

Pagal numatytuosius nustatymus GMA Next-Gen SDK pirmą kartą parodžius vaizdo vaizde skelbimą, jis rodomas apatiniame dešiniajame ekrano kampe arba paskutinėje žinomoje pozicijoje, jei jis buvo rodomas anksčiau. Norėdami tinkinti skelbimo rodymo vietą, nustatykite poziciją vaizdo vaizde parinktyse. Toliau pateiktame pavyzdyje nustatoma pozicija turinio viršuje, viršutiniame kairiajame ekrano kampe:

Kotlinas 

private fun createTopLeftPositionOptions(): PictureInPictureAdOptions {
  return PictureInPictureAdOptions.Builder()
    // Sets the ad position to the top-left corner of the screen.
    .setPosition(PictureInPictureAdPosition.TOP_LEFT)
    .build()
}

Java 

private PictureInPictureAdOptions createTopLeftPositionOptions() {
  return new PictureInPictureAdOptions.Builder()
      // Sets the ad position to the top-left corner of the screen.
      .setPosition(PictureInPictureAdPosition.TOP_LEFT)
      .build();
}

Visas galimas pozicijas žr. PictureInPictureAdPosition “.

Nustatykite pristatymo apimtį

Pagal numatytuosius nustatymus GMA Next-Gen SDK susieja vaizdo vaizde reklamą su dabartiniu pagrindiniu ekranu. GMA Next-Gen SDK atmeta reklamą, kai pagrindinio ekrano peržiūros hierarchijos nebėra atmintyje. Kad reklama išliktų matoma pašalinus pagrindinį ekraną iš atminties, nustatykite pateikimo apimtį į programą:

Kotlinas 

private fun createApplicationScopedOptions(): PictureInPictureAdOptions {
  return PictureInPictureAdOptions.Builder()
    // Keeps the ad visible beyond the host screen's lifecycle.
    .setPresentationScope(PictureInPictureAdPresentationScope.APPLICATION)
    .build()
}

Java 

private PictureInPictureAdOptions createApplicationScopedOptions() {
  return new PictureInPictureAdOptions.Builder()
      // Keeps the ad visible beyond the host screen's lifecycle.
      .setPresentationScope(PictureInPictureAdPresentationScope.APPLICATION)
      .build();
}

Daugiau informacijos žr. Skelbimo matomumas skirtinguose ekranuose .

Nustatyti skelbimo įvykio grįžtamąjį ryšį

Norėdami tvarkyti vaizdo vaizde skelbimo gyvavimo ciklo įvykius, prieš rodydami skelbimą, nustatykite jame įvykio grįžtamąjį iškvietimą. Šis grįžtamasis iškvietimas praneša apie standartinius įvykius, pvz., paspaudimus ir parodymus. Šis grįžtamasis iškvietimas taip pat praneša apie vaizdo vaizde konkrečius įvykius, pvz., kada skelbimas rodomas arba paslėptas:

Kotlinas 

private fun setAdEventCallback(pipAd: PictureInPictureAd) {
  pipAd.adEventCallback =
    object : PictureInPictureAdEventCallback {
      override fun onAdShown() {
        Log.d(TAG, "Picture-in-Picture ad shown.")
      }

      override fun onAdHidden() {
        Log.d(TAG, "Picture-in-Picture ad hidden.")
      }

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

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

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

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

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

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

Java 

private void setAdEventCallback(@NonNull PictureInPictureAd pipAd) {
  pipAd.setAdEventCallback(
      new PictureInPictureAdEventCallback() {
        @Override
        public void onAdShown() {
          Log.d(TAG, "Picture-in-Picture ad shown.");
        }

        @Override
        public void onAdHidden() {
          Log.d(TAG, "Picture-in-Picture ad hidden.");
        }

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

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

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

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

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

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

Slėpti skelbimą

Norėdami pašalinti plaukiojančią reklamą iš ekrano, iškvieskite metodą hide . Šis metodas iškviečia įvykio „ad hidden“ atgalinę iškvietą:

Kotlinas 

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

Java 

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

Išvalykite reklamos išteklius

Kad išvengtumėte atminties nutekėjimo, pašalinkite nuorodą į skelbimo objektą, kai programa baigia naudoti skelbimą. Pavyzdžiui, kai programa neberodo skelbimo arba su juo nebesąveikauja. Ekrano apimties skelbimų atveju pašalinkite nuorodą, kai programa pašalina pagrindinį ekraną iš atminties. Programos apimties skelbimų atveju išsaugokite skelbimo nuorodą, kol vartotojas naršo per ekranus, ir pašalinkite nuorodą, kai vartotojas uždaro skelbimą:

Kotlinas 

private fun cleanUpPictureInPictureAd() {
  pipAd?.destroy()
  pipAd = null
}

Java 

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

Skelbimą laikykite matomą visuose ekranuose

Kai nustatote pateikimo apimtį programai, vaizdo vaizde reklama lieka matoma net ir tada, kai programa pašalina talpinimo ekraną iš atminties. Kad programa galėtų sąveikauti su reklama arba ją atmesti, kai vartotojas išeina iš talpinimo ekrano, ji turi išlaikyti prieigą prie vaizdo vaizde reklamos. Rekomenduojame reklamą laikyti programos lygio atskirame kintamajame arba bendrinamame būsenos tvarkytuve, o ne vieno ekrano egzemplioriaus kintamajame.

Norėdami pamatyti pavyzdį, kaip išlaikyti skelbimą matomą skirtinguose ekranuose, žr. mūsų pavyzdines programas: