Śledzenie e-commerce – pakiet SDK do systemu iOS

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
}