Śledzenie e-commerce – pakiet SDK do systemu iOS

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
}