Werbeeinnahmen auf Impressionsebene

Wenn eine Impression erfolgt, stellt das Google Mobile Ads SDK Daten zum Werbeumsatz bereit, die mit dieser Impression verknüpft sind. Sie können die Daten verwenden, um den Lifetime-Wert eines Nutzers zu berechnen, oder die Daten nachgelagert an andere relevante Systeme weiterleiten.

Dieser Leitfaden soll Ihnen helfen, die Erfassung der Werbeeinnahmen aus Anzeigen auf Impressionsebene in Ihrem Unity-Projekt zu implementieren.

Voraussetzungen

• In der AdMob-Benutzeroberfläche muss die Funktion für Werbeeinnahmen auf Impressionsebene aktiviert sein.
• Unity-Plug-in 5.0.0 oder höher
• Schließen Sie Erste Schritte ab. Das Unity-Plug-in von Google Mobile Ads sollte bereits in Ihre Unity-App importiert sein.

• Damit Sie Daten zu Werbeeinnahmen auf Impressionsebene erhalten können, müssen Sie mindestens ein Anzeigenformat implementieren:

  • Banner
  • Interstitial
  • Mit Prämie
  • Interstitial mit Prämie
  • Nativ

Kostenpflichtigen Event-Handler implementieren

Jedes Anzeigenformat hat ein OnPaidEvent-Ereignis. Während des Lebenszyklus eines Anzeigenereignisses überwacht das Google Mobile Ads SDK Impressionsereignisse und ruft den Handler mit einem erzielten Wert auf.

Der folgende Code zeigt, wie bezahlte Ereignisse für eine Anzeige mit Prämie gehandhabt werden:

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

Weitere Informationen zur erfolgreichen Anzeigenquelle finden Sie unter Informationen zur Anzeigenantwort abrufen.

App Attribution Partners (AAP) einbinden

Ausführliche Informationen zum Weiterleiten von Daten zu Werbeeinnahmen an Analyseplattformen finden Sie im Leitfaden des Partners:

Partner-SDK
Anpassen
AppsFlyer
Singular
Tenjin

Best Practices für die Implementierung

• Legen Sie das Ereignis OnPaidEvent sofort fest, nachdem Sie das Anzeigenobjekt erstellt haben oder Zugriff darauf erhalten, und auf jeden Fall, bevor die Anzeige ausgeliefert wird. Dadurch wird sichergestellt, dass keine Callbacks übersehen werden.
• Senden Sie die Informationen zum Werbeumsatz auf Impressionsebene direkt in Ihrem OnPaidEvent-Handler an Ihren bevorzugten Analyseserver. Dadurch wird sichergestellt, dass Sie nicht versehentlich Callbacks verwerfen und Datenabweichungen vermeiden.

AdValue

AdValue ist eine Klasse, die den Geldwert einer Anzeige darstellt, einschließlich des Währungscodes des Werts und des wie unten codierten Genauigkeitstyps.

Wichtiger Hinweis :Der Wert von AdValue ist ein Mikrowert, der den Wert jeder Anzeige darstellt. Ein Wert von 5.000 bedeutet beispielsweise, dass diese Anzeige einen geschätzten Wert von 0,005 $hat.

AdValue.PrecisionType	Beschreibung
Unknown	Der Anzeigenwert ist unbekannt. Dieser Wert wird zurückgegeben, wenn das LTV-Pingback aktiviert ist, aber nicht genügend Daten verfügbar sind.
Estimated	Ein Anzeigenwert, der aus aggregierten Daten geschätzt wird.
PublisherProvided	Ein vom Publisher bereitgestellter Anzeigenwert, z. B. manuelle CPMs in einer Vermittlungsgruppe.
Precise	Der genaue Wert dieser Anzeige.

Im Fall der Vermittlung wird in AdMob versucht, einen ESTIMATEDWert für Anzeigenquellen bereitzustellen, die optimiert sind. Bei nicht optimierten Anzeigenquellen oder wenn nicht genügend aggregierte Daten für eine aussagekräftige Schätzung vorhanden sind, wird der Wert PUBLISHER_PROVIDED zurückgegeben.