Gdy użytkownik wyświetli reklamę, pakiet SDK do reklam mobilnych Google dostarcza powiązanych z nim danych o przychodach z reklam. Możesz na podstawie tych danych obliczyć wartość użytkownika od początku śledzenia lub przekazać dane do innych odpowiednich systemów.
Ten przewodnik pomoże Ci wdrożyć w aplikacji na Androida zbieranie danych o przychodach z reklam na poziomie wyświetleń.
Wymagania wstępne
- Sprawdź, czy w interfejsie AdMob masz włączoną funkcję przychodów z reklam na poziomie wyświetleń.
- Zaimportuj pakiet SDK do reklam mobilnych Google w wersji 21.1.0 lub nowszej.
- Wykonaj czynności opisane w przewodniku dla początkujących.
Aby otrzymywać przychody z reklam na poziomie wyświetleń, musisz zaimplementować co najmniej jeden format reklamy:
Moduł obsługi płatnych zdarzeń
Każdy format reklamy ma OnPaidEventListener
. W trakcie cyklu życia zdarzenia reklamowego pakiet SDK do reklam mobilnych Google monitoruje zdarzenia wyświetlenia i wywołuje moduł obsługi z wypracowaną wartością.
Poniższy kod pokazuje, jak obsługiwać płatne zdarzenia w przypadku reklamy z nagrodą:
Java
import com.google.android.gms.ads.rewarded.RewardedAd;
public class MainActivity extends Activity {
private RewardedAd rewardedAd;
private final String TAG = "MainActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
AdRequest adRequest = new AdRequest.Builder().build();
RewardedAd.load(this, "AD_UNIT_ID",
adRequest, new RewardedAdLoadCallback(){
@Override
public void onAdLoaded(@NonNull RewardedAd ad) {
rewardedAd = ad;
// Set paid event listener
rewardedAd.setOnPaidEventListener(new OnPaidEventListener() {
@Override
public void onPaidEvent(AdValue adValue) {
// TODO: Send the impression-level ad revenue information to your
//preferred analytics server directly within this callback.
// Extract the impression-level ad revenue data.
long valueMicros = adValue.getValueMicros();
String currencyCode = adValue.getCurrencyCode();
int precision = adValue.getPrecisionType();
// Get the ad unit ID.
String adUnitId = rewardedAd.getAdUnitId();
AdapterResponseInfo loadedAdapterResponseInfo = rewardedAd.getResponseInfo().
getLoadedAdapterResponseInfo();
String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();
Bundle extras = rewardedAd.getResponseInfo().getResponseExtras();
String mediationGroupName = extras.getString("mediation_group_name");
String mediationABTestName = extras.getString("mediation_ab_test_name");
String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
}
});
}
});
}
}
Kotlin
import com.google.android.gms.ads.rewarded.RewardedAd
class MainActivity : AppCompatActivity() {
private var rewardedAd: RewardedAd? = null
private final var TAG = "MainActivity"
override fun onCreate(savedInstanceState: Bundle?) {
AdRequest adRequest = new AdRequest.Builder().build()
RewardedAd.load(this, "AD_UNIT_ID",
adRequest, object: RewardedAdLoadCallback() {
override fun onAdLoaded(ad: RewardedAd) {
rewardedAd = ad
// Set paid event listener
rewardedAd.onPaidEventListener = OnPaidEventListener { adValue ->
// TODO: Send the impression-level ad revenue information to your preferred
// analytics server directly within this callback.
// Extract the impression-level ad revenue data.
val valueMicros = adValue.valueMicros
val currencyCode = adValue.currencyCode
val precision = adValue.precisionType
// Get the ad unit ID.
val adUnitId = rewardedAd.adUnitId
val loadedAdapterResponseInfo = rewardedAd.responseInfo.loadedAdapterResponse
val adSourceName = loadedAdapterResponseInfo.adSourceName
val adSourceId = loadedAdapterResponseInfo.adSourceId
val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
val extras = rewardedAd.responseInfo.responseExtras
val mediationGroupName = extras.getString("mediation_group_name")
val mediationABTestName = extras.getString("mediation_ab_test_name")
val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
}
}
})
}
}
Więcej informacji o zwycięskim źródle reklam znajdziesz w artykule Pobieranie informacji o odpowiedzi na żądanie reklamy.
Integracja z programem App Attribution Partners (AAP)
Szczegółowe informacje o przekazywaniu danych o przychodach z reklam na platformy analityczne znajdziesz w przewodniku partnera:
Pakiet SDK partnera |
---|
Adjust |
AppsFlyer |
Singular |
Tenjin |
Sprawdzone metody wdrażania
- Ustaw odbiornik od razu po utworzeniu obiektu reklamy lub uzyskaniu do niego dostępu, i zdecydowanie przed wyświetleniem reklamy. Dzięki temu nie przegapisz żadnych wywołań zwrotnych płatnych zdarzeń.
- Wysyłaj informacje o przychodach z reklam na poziomie wyświetleń do preferowanego serwera analitycznego natychmiast po wywołaniu metody
onPaidEvent()
. Dzięki temu nie stracisz żadnych wywołań zwrotnych i unikniesz rozbieżności w danych.
AdValue
AdValue
to klasa reprezentująca wartość pieniężną uzyskaną za reklamę, w tym kod waluty tej wartości i jej typ precyzji zakodowane w następujący sposób.
PrecisionType | Opis |
---|---|
UNKNOWN |
Nieznana wartość reklamy. Ta wartość jest zwracana, gdy pingback wartości od początku śledzenia jest włączony, ale nie ma wystarczającej ilości danych. |
ESTIMATED |
Wartość reklamy oszacowana na podstawie danych zbiorczych. |
PUBLISHER_PROVIDED |
Wydawca podał wartość reklamy, np. samodzielnie ustalany CPM w grupie zapośredniczenia. |
PRECISE |
Dokładna wartość zapłacona za tę reklamę. |
W przypadku zapośredniczenia AdMob próbuje podać wartość ESTIMATED
dla źródeł reklam,któresą zoptymalizowane.
W przypadku niezoptymalizowanych źródeł reklam oraz gdy nie ma wystarczająco dużo danych zbiorczych, aby podać sensowne oszacowanie, zwracana jest wartość PUBLISHER_PROVIDED
.