Werbeeinnahmen auf Impressionsebene

Wenn eine Impression erzielt wird, stellt das Google Mobile Ads SDK die zugehörigen Werbeeinnahmendaten bereit. Sie können die Daten verwenden, um den Lifetime-Wert eines Nutzers zu berechnen, oder sie an andere relevante Systeme weiterleiten.

In diesem Leitfaden erfahren Sie, wie Sie die Erfassung von Daten zu Werbeeinnahmen auf Impressionsebene in Ihrem Unity-Projekt implementieren.

Vorbereitung

Handler für kostenpflichtige Ereignisse implementieren

Für jedes Anzeigenformat gibt es ein OnAdPaid-Ereignis. Während des Lebenszyklus eines Anzeigenereignisses überwacht das Google Mobile Ads SDK Impressionsereignisse und ruft den Handler mit einem AdValue auf, der den erzielten Wert darstellt.

Im folgenden Beispiel werden kostenpflichtige Ereignisse für eine Anzeige mit Prämie verarbeitet:

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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 ausgelieferten Anzeigenquelle finden Sie unter Informationen zur Anzeigenantwort abrufen.

App Attribution Partner (AAP) einbinden

Ausführliche Informationen zum Weiterleiten von Daten zu Werbeumsätzen an Analyseplattformen findest du 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 darauf zugegriffen 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 Analyseserver. So wird verhindert, dass versehentlich Rückrufe verworfen werden, und es kommt nicht zu Datenabweichungen.

AdValue

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

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 angegebener Anzeigenwert, z. B. manuelle CPMs in einer Vermittlungsgruppe.
Precise Der genaue Wert dieser Anzeige.

Bei der Vermittlung versucht AdMob, einen Estimated-Wert für Anzeigenquellen anzugeben, die optimiert sind. Bei nicht optimierten Anzeigenquellen oder wenn nicht genügend aggregierte Daten vorhanden sind, um eine aussagekräftige Schätzung zu liefern, wird der Wert PublisherProvided zurückgegeben.

Impressionen aus Bidding-Anzeigenquellen testen

Wenn ein Werbeeinnahmenereignis auf Impressionsebene für eine Anzeigenquelle mit Geboten über eine Testanfrage auftritt, erhalten Sie nur die folgenden Werte:

  • Unknown: Gibt den Genauigkeitstyp an.
  • 0: Gibt den Anzeigenwert an.

Bisher wurde der Genauigkeitstyp möglicherweise mit einem anderen Wert als Unknown und einem Anzeigenwert von mehr als 0 angezeigt.

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