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 3.
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ą działania dotyczące transakcji i produktu powiązane ze wspólnym identyfikatorem transakcji.
Transakcje zawierają te pola:
Nazwa pola | Pole skryptu śledzenia | Typ | Wymagane | Opis |
---|---|---|---|---|
Identyfikator transakcji | Fields.TRANSACTION_ID
|
String
|
Tak | Unikalny identyfikator transakcji. Ten identyfikator nie powinien kolidować z innymi identyfikatorami transakcji. |
Przynależność | Fields.TRANSACTION_AFFILIATION
|
String
|
Tak | Podmiot, z którym powinna być powiązana transakcja (np.konkretny sklep). |
Przychody | Fields.TRANSACTION_REVENUE
|
Double
|
Tak | Łączne przychody z transakcji, z uwzględnieniem podatku i kosztów dostawy. |
Podatek | Fields.TRANSACTION_TAX
|
Double
|
Tak | Łączna kwota podatku od transakcji |
dostawa, | Fields.TRANSACTION_SHIPPING
|
Double
|
Tak | Całkowity koszt dostawy w ramach transakcji |
Kod waluty | Fields.CURRENCY_CODE
|
String
|
Nie | Waluta lokalna transakcji. Domyślnie jest to waluta widoku (profilu), w którym wyświetlane są transakcje. |
Elementy mają te pola:
Nazwa pola | Pole skryptu śledzenia | Typ | Wymagane | Opis |
---|---|---|---|---|
Identyfikator transakcji | Fields.TRANSACTION_ID
|
String
|
Tak | Identyfikator transakcji, z którą element powinien być powiązany |
Nazwa | Fields.ITEM_NAME
|
String
|
Tak | Nazwa produktu |
SKU | Fields.ITEM_SKU
|
String
|
Tak | Kod SKU produktu |
Kategoria | Fields.ITEM_CATEGORY
|
String
|
Nie | Kategoria, do której należy produkt |
Cena | Fields.ITEM_PRICE
|
Double
|
Tak | Cena produktu |
Ilość | Fields.ITEM_QUANTITY
|
Long
|
Tak | Liczba sztuk produktu |
Kod waluty | Fields.CURRENCY_CODE
|
String
|
Nie | Waluta lokalna transakcji. Domyślnie jest to waluta widoku (profilu), w którym raportowane są transakcje. |
Dane e-commerce są używane głównie w tych raportach standardowych:
- E-commerce ogółem
- Skuteczność produktu
- Skuteczność sprzedaży
- Transakcje
- Czas do zakupu
Implementacja
Wysyłanie do Google Analytics danych o transakcjach i produktach wymaga ustawienia w module śledzenia wartości pól transakcji i produktów oraz wysyłania ich pojedynczo. Na przykład:
import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; import com.google.analytics.tracking.android.MapBuilder; public class CheckoutActivity extends Activity { /* * Called when a purchase is processed and verified. */ public void onPurchaseCompleted() { // May return null if EasyTracker has not yet been initialized with a // property ID. EasyTracker easyTracker = EasyTracker.getInstance(this); easyTracker.send(MapBuilder .createTransaction("0_123456", // (String) Transaction ID "In-app Store", // (String) Affiliation 2.16d, // (Double) Order revenue 0.17d, // (Double) Tax 0.0d, // (Double) Shipping "USD") // (String) Currency code .build() ); easyTracker.send(MapBuilder .createItem("0_123456", // (String) Transaction ID "Level Pack: Space", // (String) Product name "L_789", // (String) Product SKU "Game expansions", // (String) Product category 1.99d, // (Double) Product price 1L, // (Long) Product quantity "USD") // (String) Currency code .build() ); } // ... Rest of the Activity definition }
Pola waluty e-commerce obsługują wartości ujemne, 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ą transakcji i wszystkich powiązanych produktów, ustaw nowy kod waluty w polu kodu waluty transakcji i działań produktu. Pełną listę obsługiwanych walut i ich kodów znajdziesz w dokumentacji obsługiwanych walut.
import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; import com.google.analytics.tracking.android.MapBuilder; public class CheckoutActivity extends Activity { /** * 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() { // Assumes a tracker has already been initialized with a property ID, otherwise // this call returns null. EasyTracker easyTracker = EasyTracker.getInstance(this); easyTracker.send(MapBuilder .createTransaction("0_123456", // (String) Transaction ID, should be unique among transactions. "In-app Store", // (String) Affiliation (long) 2.16, // (long) Order revenue (includes tax and shipping) (long) 0.17, // (long) Tax 0.0, // (long) Shipping cost "EUR") // (String) Currency code .build(); } // ... Rest of the Activity definition. }