Ten dokument zawiera przegląd sposobów pomiaru przychodów i płatności w aplikacji za pomocą pakietu SDK Google Analytics na Androida w wersji 2.
Przegląd
Pomiar e-commerce umożliwia przesyłanie do Google Analytics zakupów i sprzedaży w aplikacji. Dane e-commerce w Google Analytics obejmują zwykle transakcje i elementy powiązane wspólnym identyfikatorem transakcji. Aby nawiązać tę relację w pakiecie SDK Google Analytics na Androida, utwórz obiekt transakcji i dodaj do niego elementy.
Dane e-commerce są używane głównie w tych raportach:
- E-commerce ogółem
- Skuteczność produktu
- Skuteczność sprzedaży
- Transakcje
- Czas do zakupu
Implementacja
Transakcje można mierzyć za pomocą Google Analytics na 3 sposoby:
- utworzyć obiekt transakcji;
- Utwórz obiekty elementu i dodaj je do obiektu transakcji.
- Wyślij transakcję za pomocą:
sendTransaction(Transaction transObject).
W poniższym przykładzie zakładamy, że funkcja onPurchaseCompleted() jest wywoływana po dokonaniu przez użytkownika zakupu w aplikacji.
/**
* The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
* but only if the purchase has been confirmed.
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456", // (String) Transaction Id, should be unique.
(long) (2.16 * 1000000)) // (long) Order total (in micros)
.setAffiliation("In-App Store") // (String) Affiliation
.setTotalTaxInMicros((long) (0.17 * 1000000)) // (long) Total tax (in micros)
.setShippingCostInMicros(0) // (long) Total shipping cost (in micros)
.build();
myTrans.addItem(new Item.Builder(
"L_789", // (String) Product SKU
"Level Pack: Space", // (String) Product name
(long) (1.99 * 1000000), // (long) Product price (in micros)
(long) 1) // (long) Product quantity
.setProductCategory("Game expansions") // (String) Product category
.build());
Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
myTracker.sendTransaction(myTrans); // Send the transaction.
}
Rodzaje walut
W pakiecie SDK Google Analytics na Androida pola walut e-commerce muszą być podawane w mikroformatach (milionów walut).
Aby np.wysłać wartość waluty równa 4.5991, podczas wysyłania transakcji do Google Analytics musisz przeliczyć ją na mikro (tj. 4599100), jak w przykładach powyżej. Gdy pakiet SDK wysyła tę transakcję do Google Analytics, wartość ta jest automatycznie konwertowana na stałą wartość dziesiętną i wysyłana jako 4.5991.
W kodzie e-commerce nie należy umieszczać symboli walut ani przecinków.
Pola waluty e-commerce obsługują również wartości ujemne w walucie, co może być konieczne w przypadku zwrotów środków.
Określanie walut
Domyślnie wartości transakcji są przedstawiane w walucie widoku (profilu), w którym są raportowane.
Aby zastąpić walutę lokalną w transakcji, podczas tworzenia
Transaction użyj wywołania setCurrencyCode, jak w tym przykładzie:
/**
* In this example, the currency of the transaction is set to Euros. The
* currency values will appear in reports using the global currency
* type of the view (profile).
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456",
(long) (1.59 * 1000000))
.setAffiliation("In-App Store")
.setTotalTaxInMicros((long) (0.13 * 1000000))
.setShippingCostInMicros(0)
.setCurrencyCode("EUR") // (String) Set currency code to Euros.
.build();
Tracker myTracker = EasyTracker.getTracker();
myTracker.sendTransaction(myTrans);
}
Pełną listę obsługiwanych walut i ich kodów znajdziesz w dokumentacji obsługiwanych walut.