Śledzenie e-commerce – pakiet SDK do Androida (wersja 2)

W tym dokumencie znajdziesz ogólne informacje o tym, jak mierzyć przychody z aplikacji i przychody za pomocą pakietu SDK Google Analytics na Androida w wersji 2.

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 składają się zwykle z transakcji i elementów powiązanych ze wspólnym identyfikatorem transakcji. Pakiet SDK Google Analytics na Androida umożliwia nawiązanie tej relacji przez utworzenie obiektu transakcji i dodanie do niego elementów.

Dane e-commerce są wykorzystywane w tych raportach:

  • E-commerce ogółem
  • Skuteczność produktu
  • Skuteczność sprzedaży
  • Transakcje
  • Czas do zakupu

Wdrażanie

Pomiar transakcji za pomocą Google Analytics składa się z 3 kroków:

  1. utworzyć obiekt transakcji,
  2. Tworzenie obiektów produktów i dodawanie ich do obiektu transakcji.
  3. Wyślij transakcję przez sendTransaction(Transaction transObject).

W tym przykładzie zakładamy, że obiekt onPurchaseCompleted() jest wywoływany po dokonaniu zakupu w aplikacji przez użytkownika.

/**
 * The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
 * but only if the purchase has been confirmed.
 */
public void onPurchaseCompleted() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",                                           // (String) Transaction Id, should be unique.
      (long) (2.16 * 1000000))                              // (long) Order total (in micros)
      .setAffiliation("In-App Store")                       // (String) Affiliation
      .setTotalTaxInMicros((long) (0.17 * 1000000))         // (long) Total tax (in micros)
      .setShippingCostInMicros(0)                           // (long) Total shipping cost (in micros)
      .build();

  myTrans.addItem(new Item.Builder(
      "L_789",                                              // (String) Product SKU
      "Level Pack: Space",                                  // (String) Product name
      (long) (1.99 * 1000000),                              // (long) Product price (in micros)
      (long) 1)                                             // (long) Product quantity
      .setProductCategory("Game expansions")                // (String) Product category
      .build());

    Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
    myTracker.sendTransaction(myTrans); // Send the transaction.
}

Typy walut

W pakiecie SDK Google Analytics na Androida pola waluty e-commerce muszą być podane w milionowych walutach.

Aby na przykład wysłać wartość pieniężną 4.5991, musisz ją przeliczyć na mikro (tj. 4599100), gdy wysyłasz transakcję do Google Analytics, jak pokazano w powyższych przykładach. Gdy pakiet SDK wysyła tę transakcję do Google Analytics, ta wartość jest automatycznie konwertowana na stałą wartość dziesiętną i wysyłana jako 4.5991.

W kodzie e-commerce nie należy umieszczać symboli walut ani używać przecinków.

Pola waluty e-commerce obsługują także wartości ujemne, które mogą być niezbędne w przypadku zwrotów lub reklamacji.

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, wywołaj właściwość setCurrencyCode podczas tworzenia elementu Transaction, jak w tym przykładzie:

/**
 * 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() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",
      (long) (1.59 * 1000000))
      .setAffiliation("In-App Store")
      .setTotalTaxInMicros((long) (0.13 * 1000000))
      .setShippingCostInMicros(0)
      .setCurrencyCode("EUR")                               // (String) Set currency code to Euros.
      .build();

    Tracker myTracker = EasyTracker.getTracker();
    myTracker.sendTransaction(myTrans);
}

Pełną listę obsługiwanych walut i kodów walut znajdziesz w artykule Obsługiwane waluty.