Bu sayfa, Cloud Translation API ile çevrilmiştir.

Exoplayer IMA uzantısını kullanmaya başlayın

IMA SDK'ları, multimedya reklamları web sitelerinize ve uygulamalarınıza entegre etmenizi kolaylaştırır. IMA SDK'ları, VAST uyumlu herhangi bir reklam sunucusundan reklam isteyebilir ve uygulamalarınızda reklam oynatmayı yönetebilir. IMA istemci taraflı SDK'lar ile içeriklerin video oynatımının kontrolü sizde kalırken SDK reklam oynatma işlemini gerçekleştirir. Reklamlar, uygulamanın içerik video oynatıcısının üst kısmındaki ayrı bir video oynatıcıda oynatılır.

Bu kılavuzda, IMA SDK'nın ExoPlayer IMA uzantısı kullanılarak boş bir Android Studio projesine nasıl entegre edileceği gösterilmektedir. Tamamlanmış bir örnek entegrasyonu görüntülemek veya takip etmek isterseniz GitHub'dan BasicExample'i indirin.

IMA istemci tarafına genel bakış

IMA istemci taraflı uygulama, bu kılavuzda gösterilen dört ana SDK bileşeninden oluşur:

AdDisplayContainer: Reklamların oluşturulduğu bir kapsayıcı nesnesi.
AdsLoader: Reklam isteğinde bulunan ve reklam isteği yanıtlarından gelen etkinlikleri işleyen bir nesnedir. Uygulamanın kullanım süresi boyunca tekrar kullanılabilecek bir reklam yükleyicisi başlatmalısınız.
AdsRequest: Reklam isteğini tanımlayan bir nesne. Reklam istekleri, reklam boyutları gibi ek parametrelerin yanı sıra VAST reklam etiketine ilişkin URL'yi de belirtir.
AdsManager: Reklam isteğine verilen yanıtı içeren, reklam oynatmayı kontrol eden ve SDK tarafından tetiklenen reklam etkinliklerini dinleyen bir nesnedir.

Not: ExoPlayer IMA uzantısı bu kılavuzdaki IMA SDK'yı sarmaladığından hem AdsRequest hem de AdsManager kullanılmakta ancak açıkça çağrılmamaktadır.

Ön koşullar

Başlamadan önce Android Studio 3.0 veya sonraki bir sürüme ihtiyacınız vardır.

1. Yeni Android Studio projesi oluşturma

Android Studio projenizi oluşturmak için aşağıdaki adımları tamamlayın:

Android Studio'yu başlatın.
Yeni bir Android Studio projesi başlat'ı seçin.
Projenizi seçin sayfasında Etkinlik Boş şablonunu seçin.
Sonraki'yi tıklayın.
Projenizi yapılandırın sayfasında, projenize bir ad verin ve dil olarak Java'yı seçin.
Not: IMA SDK'sı Kotlin ile uyumludur. Ancak, bu kılavuzda ele alınan örnekte Java kullanılmıştır.
Son'u tıklayın.

2. Projenize ExoPlayer IMA uzantısını ekleyin

Öncelikle uygulama düzeyindeki build.gradle dosyasında bağımlılıklar bölümüne uzantı için içe aktarmaları ekleyin. ExoPlayer IMA uzantısının boyutundan dolayı, multidex'i burada uygulayın ve etkinleştirin. Bu, minSdkVersion değeri 20 veya daha düşük bir değere ayarlanmış uygulamalar için gereklidir. Ayrıca, Java sürümü uyumluluk bilgilerini belirtmek için yeni compileOptions öğesini ekleyin.

app/build.gradle

android {
    namespace 'com.google.ads.interactivemedia.v3.samples.exoplayerexample'
    compileSdkVersion 34

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
  }

  defaultConfig {
      applicationId "com.google.ads.interactivemedia.v3.samples.exoplayerexample"
      minSdkVersion 21
      targetSdkVersion 34
      multiDexEnabled true
      versionCode 1
      versionName "1.0"
  }

    ...
}
dependencies {
    implementation 'androidx.multidex:multidex:2.0.1'
    implementation 'androidx.media3:media3-ui:1.2.1'
    implementation 'androidx.media3:media3-exoplayer:1.2.1'
    implementation 'androidx.media3:media3-exoplayer-ima:1.2.1'

    ...
}

IMA SDK'nın reklam isteğinde bulunmak için ihtiyaç duyduğu kullanıcı izinlerini ekleyin.

app/src/main/AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.project name">

    <!-- Required permissions for the IMA SDK -->
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

    ...

</manifest>

Amaç bildirimleri ekle

Uygulamanız Android 11 (API düzeyi 30) veya sonraki sürümleri hedefliyorsa IMA SDK'nın mevcut ve son sürümleri, web bağlantılarını açmak için açık bir niyet beyanı gerektirir. Reklam tıklamalarını etkinleştirmek için (kullanıcılar Daha fazla bilgi düğmesini tıklar) uygulamanızın manifest dosyasına aşağıdaki snippet'i ekleyin.

  <?xml version="1.0" encoding="utf-8"?>
  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.example.project name">

      ...

    </application>

    <queries>
      <intent>
          <action android:name="android.intent.action.VIEW" />
          <data android:scheme="https" />
      </intent>
      <intent>
          <action android:name="android.intent.action.VIEW" />
          <data android:scheme="http" />
      </intent>
    </queries>
  </manifest>

3. Reklam kullanıcı arayüzü kapsayıcısı oluşturma

Uygun bir kimliğe sahip StyledPlayerView nesnesi oluşturarak ExoPlayer PlayerView olarak kullanılacak görünümü oluşturun. Ayrıca androidx.constraintlayout.widget.ConstraintLayout özelliğini LinearLayout olarak değiştirin.

app/src/main/res/layout/activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <androidx.media3.ui.PlayerView
        android:id="@+id/player_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

4. Reklam isteği için içerik URL'nizi ve reklam etiketi URL'nizi ekleyin

İçerik URL'nizi ve VAST reklam etiketi URL'nizi depolamak için strings.xml öğesine girişler ekleyin.

app/src/main/res/values/strings.xml

<resources>
    <string name="app_name">Your_Project_Name</string>
    <string name="content_url"><![CDATA[https://storage.googleapis.com/gvabox/media/samples/stock.mp4]]></string>
    <string name="ad_tag_url"><![CDATA[https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=]]></string>

</resources>

5. ExoPlayer IMA uzantısını içe aktarın

ExoPlayer uzantısının içe aktarma ifadelerini ekleyin. Ardından PlayerView, SimpleExoPlayer ve ImaAdsLoader için özel değişkenler ekleyerek MainActivity sınıfını Activity kapsamını genişletecek şekilde güncelleyin.

app/src/main/java/com/example/project name/MainActivity.java


import android.app.Activity;
import android.net.Uri;
import android.os.Bundle;
import androidx.media3.common.MediaItem;
import androidx.media3.common.util.Util;
import androidx.media3.datasource.DataSource;
import androidx.media3.datasource.DefaultDataSource;
import androidx.media3.exoplayer.ExoPlayer;
import androidx.media3.exoplayer.ima.ImaAdsLoader;
import androidx.media3.exoplayer.source.DefaultMediaSourceFactory;
import androidx.media3.exoplayer.source.MediaSource;
import androidx.media3.ui.PlayerView;
import androidx.multidex.MultiDex;

...

public class MainActivity extends Activity {

  private PlayerView playerView;
  private ExoPlayer player;
  private ImaAdsLoader adsLoader;

}

6. `adsLoader` örneği oluşturun

onCreate yönteminin üzerine yazın ve reklam etiketi URL'siyle yeni bir adsLoader nesnesi oluşturmak için gerekli değişken atamalarını ekleyin.

app/src/main/java/com/example/project name/MainActivity.java


...

public class MainActivity extends Activity {

  private PlayerView playerView;
  private ExoPlayer player;
  private ImaAdsLoader adsLoader;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    MultiDex.install(this);

    playerView = findViewById(R.id.player_view);

    // Create an AdsLoader.
      adsLoader =
        new ImaAdsLoader.Builder(/* context= */ this)
            .setAdEventListener(buildAdEventListener())
            .build();
  }

  public AdEvent.AdEventListener buildAdEventListener() {

    AdEvent.AdEventListener imaAdEventListener = event -> {
      AdEvent.AdEventType eventType = event.getType();
      // Log IMA events for debugging.
      // The ExoPlayer IMA extension already handles IMA events and does not need anything
      // additional here to function.
    };

    return imaAdEventListener;
  }

}

7. Oynatıcıyı başlatma ve serbest bırakma

Oynatıcıyı başlatmak ve serbest bırakmak için yöntemler ekleyin. Başlatma yönteminde SimpleExoPlayer oluşturun. Ardından AdsMediaSource öğesini oluşturun ve oynatıcıya ayarlayın.

app/src/main/java/com/example/project name/MainActivity.java

public class MainActivity extends Activity {

  ...

  private void releasePlayer() {
    adsLoader.setPlayer(null);
    playerView.setPlayer(null);
    player.release();
    player = null;
  }

  private void initializePlayer() {
    // Set up the factory for media sources, passing the ads loader and ad view providers.
    DataSource.Factory dataSourceFactory = new DefaultDataSource.Factory(this);

    MediaSource.Factory mediaSourceFactory =
        new DefaultMediaSourceFactory(dataSourceFactory)
            .setLocalAdInsertionComponents(unusedAdTagUri -> adsLoader, playerView);

    // Create an ExoPlayer and set it as the player for content and ads.
    player = new ExoPlayer.Builder(this).setMediaSourceFactory(mediaSourceFactory).build();
    playerView.setPlayer(player);
    adsLoader.setPlayer(player);

    // Create the MediaItem to play, specifying the content URI and ad tag URI.
    Uri contentUri = Uri.parse(getString(R.string.content_url));
    Uri adTagUri = Uri.parse(getString(R.string.ad_tag_url));
    MediaItem mediaItem =
        new MediaItem.Builder()
            .setUri(contentUri)
            .setAdsConfiguration(new MediaItem.AdsConfiguration.Builder(adTagUri).build())
            .build();

    // Prepare the content and ad to be played with the SimpleExoPlayer.
    player.setMediaItem(mediaItem);
    player.prepare();

    // Set PlayWhenReady. If true, content and ads will autoplay.
    player.setPlayWhenReady(false);
  }
}

8. Oynatıcı etkinliklerini yönetin

Son olarak, oynatıcının yaşam döngüsü olayları için geri çağırmalar oluşturun:

onStart
onResume
onStop
onPause
onDestroy

Not: Örnek kod, Android SDK 24 ve sonraki sürümler için onStart/onStop, 24 ve önceki sürümler için onResume/onPause kullanır.

app/src/main/java/com/example/project name/MainActivity.java

public class MainActivity extends Activity {

  private PlayerView playerView;
  private SimpleExoPlayer player;
  private ImaAdsLoader adsLoader;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_my);

      playerView = findViewById(R.id.player_view);

      // Create an AdsLoader.
      adsLoader =
        new ImaAdsLoader.Builder(/* context= */ this)
            .setAdEventListener(buildAdEventListener())
            .build();
  }

  @Override
  public void onStart() {
    super.onStart();
    //
    if (Util.SDK_INT > 23) {
      initializePlayer();
      if (playerView != null) {
        playerView.onResume();
      }
    }
  }

  @Override
  public void onResume() {
    super.onResume();
    if (Util.SDK_INT <= 23 || player == null) {
      initializePlayer();
      if (playerView != null) {
        playerView.onResume();
      }
    }
  }

  @Override
  public void onPause() {
    super.onPause();
    if (Util.SDK_INT <= 23) {
      if (playerView != null) {
        playerView.onPause();
      }
      releasePlayer();
    }
  }

  @Override
  public void onStop() {
    super.onStop();
    if (Util.SDK_INT > 23) {
      if (playerView != null) {
        playerView.onPause();
      }
      releasePlayer();
    }
  }

  @Override
  protected void onDestroy() {
    super.onDestroy();
    adsLoader.release();
  }

  ...

}

İşte bu kadar. Artık IMA SDK ile reklam istiyor ve gösteriyorsunuz. Ek SDK özellikleri hakkında bilgi edinmek için diğer kılavuzlara veya GitHub'daki örnekleri inceleyin.

Exoplayer IMA uzantısını kullanmaya başlayın

IMA istemci tarafına genel bakış

Ön koşullar

1. Yeni Android Studio projesi oluşturma

2. Projenize ExoPlayer IMA uzantısını ekleyin

Amaç bildirimleri ekle

3. Reklam kullanıcı arayüzü kapsayıcısı oluşturma

4. Reklam isteği için içerik URL'nizi ve reklam etiketi URL'nizi ekleyin

5. ExoPlayer IMA uzantısını içe aktarın

6. adsLoader örneği oluşturun

7. Oynatıcıyı başlatma ve serbest bırakma

8. Oynatıcı etkinliklerini yönetin

6. `adsLoader` örneği oluşturun