Ten dokument zawiera przegląd sposobów pomiaru przychodów i płatności w aplikacji za pomocą pakietu SDK Google Analytics na iOS 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 |
kGAITransactionId |
NSString |
Tak | Unikalny identyfikator transakcji. Ten identyfikator nie powinien kolidować z innymi identyfikatorami transakcji. |
Przynależność |
kGAITransactionAffiliation |
NSString |
Tak | Podmiot, z którym powinna być powiązana transakcja (np.konkretny sklep). |
Przychody |
kGAITransactionRevenue |
NSNumber |
Tak | Łączne przychody z transakcji, z uwzględnieniem podatku i kosztów dostawy. |
Podatek |
kGAITransactionTax |
NSNumber |
Tak | Łączna kwota podatku od transakcji |
dostawa, |
kGAITransactionShipping |
NSNumber |
Tak | Całkowity koszt dostawy w ramach transakcji |
Kod waluty |
kGAICurrencyCode |
NSString |
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 |
kGAITransactionId |
NSString |
Tak | Identyfikator transakcji, z którą element powinien być powiązany |
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 |
Ilość |
kGAIItemQuantity |
NSNumber |
Tak | Liczba sztuk produktu |
Kod waluty |
kGAICurrencyCode |
NSString |
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:
/* * 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, 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.
/* 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 }