Werbeeinnahmen auf Impressionsebene

Plattform auswählen: Android Neu Android iOS Unity

Wenn eine Impression erfolgt, liefert Google Mobile Ads Unity Plugin Daten zu den Werbeeinnahmen , die mit dieser Impression verbunden sind. Sie können die Daten verwenden, um den Lifetime-Wert eines Nutzers zu berechnen oder die Daten an andere relevante Systeme weiterzuleiten.

In dieser Anleitung erfahren Sie, wie Sie die Erfassung von Werbeeinnahmen auf Impressionsebene in Ihrem Unity-Projekt implementieren.

Vorbereitung

Event-Handler für kostenpflichtige Ereignisse implementieren

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

Der folgende Code zeigt, wie Sie kostenpflichtige Ereignisse für eine Anzeige mit Prämie verarbeiten:

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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, 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 Anzeigenquelle, die die Auktion gewonnen hat, finden Sie unter Informationen zur Anzeigenantwort abrufen.

Mit App Attribution Partnern (AAP) verknüpfen

Ausführliche Informationen zum Weiterleiten von Werbeeinnahmendaten an Analyseplattformen finden Sie in der Anleitung des Partners:

Partner-SDK
Adjust
AppsFlyer
Singular
Tenjin

Best Practices für die Implementierung

  • Legen Sie das OnPaidEvent-Ereignis sofort fest, nachdem Sie das Anzeigenobjekt erstellt oder Zugriff darauf erhalten haben, und auf jeden Fall vor dem Ausliefern der Anzeige. So verpassen Sie keine Rückrufe.
  • Senden Sie die Informationen zu Werbeeinnahmen auf Impressionsebene sofort in Ihrem OnPaidEvent-Handler an Ihren bevorzugten Analysenserver. So vermeiden Sie, dass Rückrufe versehentlich verloren gehen, und verhindern Datenabweichungen.

AdValue

AdValue ist eine Klasse, die den monetären Wert darstellt, der mit einer Anzeige erzielt wurde. Dazu gehören der Währungscode des Werts und der Genauigkeitstyp, der wie unten codiert ist.

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

Bei der Vermittlung versucht Ad Manager, einen ESTIMATED-Wert für Anzeigenquellen bereitzustellen, bei denen die automatische Datenerfassung aktiviert ist. Weitere Informationen finden Sie unter Automatische Datenerfassung. Bei Anzeigenquellen, bei denen die automatische Datenerfassung nicht aktiviert ist, oder wenn nicht genügend aggregierte Daten vorhanden sind, um eine aussagekräftige Schätzung zu liefern, wird der Wert PUBLISHER_PROVIDED zurückgegeben.

Impressionen aus Open Bidding testen

Nachdem ein Ereignis zu Werbeeinnahmen auf Impressionsebene für eine Open Bidding Anzeigenquelle über eine Testanfrage aufgetreten ist, erhalten Sie nur die folgenden Werte:

  • Unknown gibt den Genauigkeitstyp an.
  • 0 gibt den Anzeigenwert an.

Bisher wurde der Genauigkeitstyp möglicherweise als anderer Wert als Unknown und ein Anzeigenwert über 0 angezeigt.

Weitere Informationen zum Senden einer Testanzeigenanfrage finden Sie unter Testgeräte aktivieren.