Jetzt starten

Fügen Sie Ihrer App zuerst das Android PAL SDK hinzu.

Android PAL SDK als Bibliothek hinzufügen

Ab Version 18.0.0 wird das PAL SDK im Maven-Repository von Google gehostet und können folgendermaßen zu Ihrer App hinzugefügt werden:

app/build.gradle

...
dependencies {
    implementation 'com.google.android.gms:play-services-pal:20.2.0'
    ...
}

Alternativ kann das PAL SDK aus dem Maven-Repository von Google heruntergeladen und manuell in die App eingefügt werden.

Nonce generieren

Ein „Nonce“ ist ein einzelner verschlüsselter String, der von PAL mithilfe der NonceLoader generiert wird. Für das PAL SDK muss jede neue Streamanfrage mit einer neuen die neu generierte Nonce. Nonces können jedoch für mehrere Anzeigenanfragen innerhalb denselben Stream ansehen. Wenn Sie mit dem PAL SDK eine Nonce generieren möchten, nehmen Sie Änderungen an MyActivity.java So zeigen Sie eine Beispiel-App, die mit PAL eine Nonce generiert: Android-Beispiel herunterladen unter GitHub

Zuerst müssen Sie das PAL SDK importieren. Erstellen Sie einige private Properties zum Speichern. NonceLoader und NonceManager und initialisieren Sie dann Ihr NonceLoader.

Wir empfehlen, nur eine Instanz der NonceLoader-Klasse für jede Nutzersitzung in Ihrer App, es sei denn, Ihre App hat mehrere Seiten oder gleichwertige Seiten Konstrukte. Dadurch bleibt der Seitenkorrelator (&correlator) während der gesamten Lebensdauer einer Seite oder einer Nutzersitzung in der App unverändert. Sie haben weiterhin die Kontrolle über den Streamkorrelator (&scor), der für jeden neuen Stream einmal zurückgesetzt werden sollte.

Für alle Anzeigenanfragen desselben Streams müssen NonceLoader und Stream-Korrelatorwert für Frequency Capping und Konkurrenzausschluss um ordnungsgemäß zu funktionieren.

import android.app.Activity;
import android.os.Bundle;
import com.google.ads.interactivemedia.pal.NonceLoader;
import com.google.ads.interactivemedia.pal.NonceManager;
import com.google.ads.interactivemedia.pal.NonceRequest;
import com.google.ads.interactivemedia.pal.ConsentSettings;
import com.google.android.gms.tasks.OnFailureListener;
import com.google.android.gms.tasks.OnSuccessListener;

import java.util.HashSet;
import java.util.Set;

public class MainActivity extends Activity {
...
  private NonceLoader nonceLoader;
  private NonceManager nonceManager = null;
  private ConsentSettings consentSettings;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // The default value for allowStorage() is false, but can be
    // changed once the appropriate consent has been gathered. The
    // getConsentToStorage() method is a placeholder for the publisher's own
    // method of obtaining user consent, either by integrating with a CMP or
    // based on other methods the publisher chooses to handle storage consent.

    boolean isConsentToStorage = getConsentToStorage();

    videoView = findViewById(R.id.video_view);
    videoView.setOnTouchListener(this::onVideoViewTouch);

    consentSettings = ConsentSettings.builder()
            .allowStorage(isConsentToStorage)
            .build();

    // It is important to instantiate the NonceLoader as early as possible to
    // allow it to initialize and preload data for a faster experience when
    // loading the NonceManager. A new NonceLoader will need to be instantiated
    //if the ConsentSettings change for the user.
    nonceLoader = new NonceLoader(this, consentSettings);
    ...
  }

Erstellen Sie als Nächstes eine Funktion, um die Nonce-Generierung auszulösen. Sie benötigen nur eine Nonce für alle Anzeigenanfragen in einer einzelnen Streamwiedergabe. Zu Testzwecken können Sie diese Funktion aufrufen, wenn Sie auf eine Schaltfläche in Ihrer Test-App klicken. Die Die hier festgelegten NonceRequest-Parameter sind Beispielparameter. Sie sollten Ihre Parameter basierend auf Ihren eigenen App-Eigenschaften.

Diese Funktion löst die Nonce-Generierung asynchron aus, daher müssen Sie Implementieren Sie einen AsyncTask, um den Erfolg oder Misserfolg der Nonce-Anfrage zu verarbeiten:

public void generateNonceForAdRequest() {
  Set supportedApiFrameWorksSet = new HashSet();
  // The values 2, 7, and 9 correspond to player support for VPAID 2.0,
  // OMID 1.0, and SIMID 1.1.
  supportedApiFrameWorksSet.add(2);
  supportedApiFrameWorksSet.add(7);
  supportedApiFrameWorksSet.add(9);

  NonceRequest nonceRequest = NonceRequest.builder()
      .descriptionURL("https://example.com/content1")
      .iconsSupported(true)
      .omidPartnerVersion("6.2.1")
      .omidPartnerName("Example Publisher")
      .playerType("ExamplePlayerType")
      .playerVersion("1.0.0")
      .ppid("testPpid")
      .sessionId("Sample SID")
      .supportedApiFrameworks(supportedApiFrameWorksSet)
      .videoPlayerHeight(480)
      .videoPlayerWidth(640)
      .willAdAutoPlay(true)
      .willAdPlayMuted(false)
      .build();
  NonceCallbackImpl callback = new NonceCallbackImpl();
  nonceLoader
      .loadNonceManager(nonceRequest)
      .addOnSuccessListener(callback)
      .addOnFailureListener(callback);
}

private class NonceCallbackImpl implements OnSuccessListener<NonceManager>, OnFailureListener {
  @Override
  public void onSuccess(NonceManager manager) {
    nonceManager = manager;
    String nonceString = manager.getNonce();
    Log.i("PALSample", "Generated nonce: " + nonceString);
    // from here you would trigger your ad request and move on to initialize content
  }

  @Override
  public void onFailure(Exception error) {
    Log.e("PALSample", "Nonce generation failed: " + error.getMessage());
  }
}

Nachdem ein Nonce-Manager erstellt wurde, kann die Nonce jederzeit mit nonceManager.getNonce()

Nonce an die Anzeigenanfrage anhängen

Wenn Sie den generierten Nonce verwenden möchten, hängen Sie Ihrem Anzeigen-Tag vor dem Senden Ihrer Anzeigenanfragen einen givn-Parameter mit dem Nonce-Wert an.

Achtung: Wenn Sie zuvor mit dem Parameter paln eine Nonce angegeben haben, ist sie wird dringend empfohlen, zu givn zu migrieren und keine paln mehr zu senden. Wenn beide Parameter enthalten sind, ist das Verhalten hinsichtlich der Verwendung des Nonce nicht definiert.

/**
 * The ad tag for your ad request, for example:
 * https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external\
 * /single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast&unviewed_position_start=1\
 * &cust_params=deployment%3Ddevsite%26sample_ct%3Dlinear&correlator=
 *
 * For more sample ad tags, see
 * developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/tags
 */
private static final String DEFAULT_AD_TAG = "Your ad tag";
...
@Override
public void onSuccess(NonceManager manager) {
  nonceManager = manager;
  String nonceString = manager.getNonce();
  Log.i("PALSample", "Generated nonce: " + nonceString);
  // Append the nonce to the ad tag URL.
  makeAdRequest(DEFAULT_AD_TAG + "&givn=" + nonceString);
}

Wiedergabeereignisse verfolgen

Schließlich musst du verschiedene Ereignishandler für deinen Player implementieren. Zu Testzwecken kannst du sie an Schaltflächenklick-Ereignisse anhängen. Bei einer echten Implementierung werden sie jedoch durch die entsprechenden Player-Ereignisse ausgelöst:

public void sendAdClick() {
  if (nonceManager != null) {
    nonceManager.sendAdClick();
  }
}

public void sendPlaybackStart() {
  if (nonceManager != null) {
    nonceManager.sendPlaybackStart();
  }
}

public void sendPlaybackEnd() {
  if (nonceManager != null) {
    nonceManager.sendPlaybackEnd();
  }
}

public void onVideoViewTouch(MotionEvent e) {
  if (nonceManager != null) {
    nonceManager.sendTouch(e);
  }
}

So rufen Sie die einzelnen Funktionen in Ihrer Implementierung auf:

• sendPlaybackStart(): Zeitpunkt, an dem die Videowiedergabe beginnt
• sendPlaybackEnd(): Wenn die Videowiedergabe beendet wird
• sendAdClick(): Jedes Mal, wenn der Zuschauer auf eine Anzeige klickt
• sendTouch(): Bei jeder Berührung des Players

(Optional) Google Ad Manager-Signale über Ad-Server eines Drittanbieters senden

Wenn Sie den Ad-Server eines Drittanbieters für Google Ad Manager einrichten, verweisen Sie in der Serverdokumentation, um den Nonce-Wert in jeder Anzeige zu erfassen und weiterzuleiten Im Beispiel handelt es sich um eine Anzeigenanfrage-URL mit dem Nonce-Parameter. enthalten. Der Nonce-Parameter wird vom PAL SDK über die zwischen den zwischengeschalteten Servern und dann zu Ad Manager übertragen.

Hinweis :Wenn Sie mehrere Drittanbieterlösungen verwenden, z. B. SSAI-Server einen weiteren Drittanbieter-Ad-Server aufruft, müssen Sie sicherstellen, dass der PAL Die verschlüsselte Nonce des SDK wird an jeden Drittanbieter weitergeleitet.

Konfigurieren Sie den Ad-Server eines Drittanbieters so, dass die Nonce im an Ad Manager senden. Hier ein Beispiel für ein Anzeigen-Tag, das im eines Drittanbieter-Ad-Servers:

'https://pubads.serverside.net/gampad/ads?givn=%%custom_key_for_google_nonce%%&...'

Weitere Informationen finden Sie unter Serverseitige Google Ad Manager-Implementierung .

In Ad Manager wird nach givn= gesucht, um den Nonce-Wert zu ermitteln. Drittanbieteranzeige muss ein eigenes Makro unterstützen, z. B. %%custom_key_for_google_nonce%% und ersetzen Sie es durch den Nonce-Abfrageparameter. die Sie im vorherigen Schritt angegeben haben. Weitere Informationen dazu finden Sie in der Dokumentation des Ad-Servers des Drittanbieters.