Werbeeinnahmen auf Impressionsebene

Plattform auswählen: Android iOS Unity Android (Legacy)

Sobald eine Impression erfolgt, stellt Google Mobile Ads Unity Plugin Daten zu den Werbeeinnahmen für diese Impression bereit. Sie können die Daten verwenden, um den Lifetime-Wert eines Nutzers zu berechnen, oder die Daten an andere relevante Systeme weiterleiten.

In diesem Leitfaden wird beschrieben, wie Sie die Erfassung von Daten zu 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 überwacht Google Mobile Ads Unity Plugin Impressionsereignisse und ruft den Handler mit einem verdienten Wert auf.

Der folgende Code zeigt, wie kostenpflichtige Ereignisse für eine Anzeige mit Prämie verarbeitet 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&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 erfolgreichen Anzeigenquelle finden Sie unter Informationen zur Anzeigenantwort abrufen.

App Attribution Partner (AAP) einbinden

Ausführliche Informationen zur Weiterleitung 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 oder Zugriff darauf erhalten haben, und auf jeden Fall, bevor die Anzeige ausgeliefert wird. So verpassen Sie keine Rückrufe.
  • Senden Sie die Informationen zu den Werbeeinnahmen auf Impressionsebene sofort in Ihrem OnPaidEvent-Handler an Ihren bevorzugten Analyseserver. So werden keine Callbacks versehentlich verworfen und Datenabweichungen vermieden.

AdValue

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

AdValue.PrecisionType Beschreibung
Unknown Ein unbekannter Anzeigenwert. Dieser Wert wird zurückgegeben, wenn der 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 bereitgestellter 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 anzugeben, für die die automatische Datenerhebung aktiviert ist. Weitere Informationen finden Sie unter Automatische Datenerhebung. Bei Anzeigenquellen, für die die automatische Datenerhebung nicht aktiviert ist, oder wenn nicht genügend aggregierte Daten vorhanden sind, um eine aussagekräftige Schätzung zu erstellen, wird der Wert PUBLISHER_PROVIDED zurückgegeben.

Testimpressionen aus Open Bidding

Nachdem ein Ereignis für 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 ein anderer Wert als Unknown und der Anzeigenwert als ein Wert über 0 angezeigt.

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