W tym dokumencie znajdziesz omówienie pomiaru płatności i przychodów w aplikacji za pomocą pakietu SDK Google Analytics na iOS w wersji 3.
Przegląd
Pomiar e-commerce umożliwia wysyłanie informacji o zakupach i sprzedaży w aplikacji do Google Analytics. Dane e-commerce w Google Analytics obejmują działania transakcji i produkty powiązane ze wspólnym identyfikatorem transakcji.
Transakcje zawierają te pola:
Nazwa pola | Pole trackera | Typ | Wymagany | Opis |
---|---|---|---|---|
Identyfikator transakcji |
kGAITransactionId |
NSString |
Tak | Unikalny identyfikator transakcji. Ten identyfikator nie może kolidować z innymi identyfikatorami transakcji. |
Przynależność |
kGAITransactionAffiliation |
NSString |
Tak | Podmiot, z którym transakcja powinna być powiązana (np. określony sklep) |
Przychody |
kGAITransactionRevenue |
NSNumber |
Tak | Łączne przychody z transakcji, w tym z podatkiem i kosztami dostawy |
Podatek |
kGAITransactionTax |
NSNumber |
Tak | Łączny podatek od transakcji |
dostawa, |
kGAITransactionShipping |
NSNumber |
Tak | Łączny koszt dostawy transakcji |
Kod waluty |
kGAICurrencyCode |
NSString |
Nie | Waluta lokalna transakcji. Domyślnie jest to waluta widoku, w którym wyświetlane są transakcje. |
Elementy zawierają te pola:
Nazwa pola | Pole trackera | Typ | Wymagany | Opis |
---|---|---|---|---|
Identyfikator transakcji |
kGAITransactionId |
NSString |
Tak | Identyfikator transakcji, z którą powinien być powiązany element |
Nazwa |
kGAIItemName |
NSString |
Tak | Nazwa produktu |
SKU |
kGAIItemSku |
NSString |
Tak | Kod SKU produktu |
Kategoria |
kGAIItemCategory |
NSString |
Nie | Kategoria, do której należy produkt |
Cena |
kGAIItemPrice |
NSNumber |
Tak | Cena produktu |
Liczba |
kGAIItemQuantity |
NSNumber |
Tak | Liczba sztuk produktu |
Kod waluty |
kGAICurrencyCode |
NSString |
Nie | Waluta lokalna transakcji. Domyślnie jest ustawiona waluta widoku, w którym podawane są transakcje. |
Dane e-commerce są używane głównie w tych standardowych raportach:
- E-commerce ogółem
- Skuteczność produktu
- Skuteczność sprzedaży
- Transakcje
- Czas do zakupu
Wdrażanie
Wysyłanie danych o transakcjach i elementach do Google Analytics wymaga ustawienia wartości transakcji i pola w narzędziu do śledzenia, a potem po kolei. Przykład:
/* * Called when a purchase is processed and verified. */ - (void)onPurchaseCompleted { // Assumes a tracker has already been initialized with a property ID, otherwise // this call returns null. id tracker = [[GAI sharedInstance] defaultTracker]; [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456" // (NSString) Transaction ID affiliation:@"In-app Store" // (NSString) Affiliation revenue:@2.16F // (NSNumber) Order revenue (including tax and shipping) tax:@0.17F // (NSNumber) Tax shipping:@0 // (NSNumber) Shipping currencyCode:@"USD"] build]]; // (NSString) Currency code [tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456" // (NSString) Transaction ID name:@"Space Expansion" // (NSString) Product Name sku:@"L_789" // (NSString) Product SKU category:@"Game expansions" // (NSString) Product category price:@1.9F // (NSNumber) Product price quantity:@1 // (NSInteger) Product quantity currencyCode:@"USD"] build]]; // (NSString) Currency code }
Pola waluty e-commerce obsługują wartości ujemne, które mogą być niezbędne w przypadku zwrotów środków lub produktów.
Określanie walut
Domyślnie przyjmuje się, że wartości transakcji są podane w walucie widoku danych (profilu), w którym są zgłaszane.
Aby zastąpić walutę lokalną transakcji i powiązanych produktów, ustaw w polu kodu waluty transakcji i działań produktu nowy kod waluty. Pełną listę obsługiwanych walut i kodów walut znajdziesz w artykule Obsługiwane waluty.
/* 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). */ - (void)onPurchaseCompleted { // Assumes a tracker has already been initialized with a property ID, otherwise // this call returns null. id tracker = [[GAI sharedInstance] defaultTracker]; [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456", // (NSString) Transaction ID, should be unique among transactions. affiliation:@"In-app Store", // (NSString) Affiliation revenue:(int64_t) 2.16, // (int64_t) Order revenue (including tax and shipping) tax:(int64_t) 0.17, // (int64_t) Tax shipping:(int64_t) 0, // (int64_t) Shipping currencyCode:@"EUR"] build]]; // (NSString) Currency code }