Śledzenie e-commerce

Ten dokument zawiera informacje o tym, jak mierzyć przychody i płatności w aplikacji za pomocą pakietu SDK Google Analytics w wersji 4 na Androida.

Ostrzeżenie: Pakiet SDK e-commerce został wycofany. Użyj pakietu SDK Ulepszonego e-commerce.

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	Typ	Wymagane	Opis
Identyfikator transakcji	String	Tak	Unikalny identyfikator transakcji. Ten identyfikator nie powinien kolidować z innymi identyfikatorami transakcji.
Przynależność	String	Tak	Podmiot, z którym powinna być powiązana transakcja (np.konkretny sklep).
Przychody	Double	Tak	Łączne przychody z transakcji, z uwzględnieniem podatku i kosztów dostawy.
Podatek	Double	Tak	Łączna kwota podatku od transakcji
dostawa,	Double	Tak	Całkowity koszt dostawy w ramach transakcji
Kod waluty	String	Nie	Waluta lokalna transakcji. Domyślnie jest to waluta widoku (profilu), w którym wyświetlane są transakcje.

Elementy mają te pola:

Nazwa pola	Typ	Wymagane	Opis
Identyfikator transakcji	String	Tak	Identyfikator transakcji, z którą element powinien być powiązany
Nazwa	String	Tak	Nazwa produktu
SKU	String	Tak	Kod SKU produktu
Kategoria	String	Nie	Kategoria, do której należy produkt
Cena	Double	Tak	Cena produktu
Ilość	Long	Tak	Liczba sztuk produktu
Kod waluty	String	Nie	Waluta lokalna transakcji. Domyślnie jest to waluta widoku (profilu), w którym są zgłaszane transakcje

Dane e-commerce są używane przede wszystkim w następujących raportach standardowych:

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

Implementacja

TransactionBuilder i ItemBuilder służą do wysyłania danych o transakcjach i produktach do Google Analytics. Każde pole e-commerce jest ustawiane za pomocą metod pomocniczych. Na przykład:

// Build the transaction.
sendDataToTwoTrackers(new HitBuilders.TransactionBuilder()
    .setTransactionId(getOrderId())
    .setAffiliation(getStoreName())
    .setRevenue(getTotalOrder())
    .setTax(getTotalTax())
    .setShipping(getShippingCost())
    .setCurrencyCode("USD")
    .build());

// Build an item.
sendDataToTwoTrackers(new HitBuilders.ItemBuilder()
    .setTransactionId(getOrderId())
    .setName(getItemName(1))
    .setSku(getItemSku(1))
    .setCategory(getItemCategory(1))
    .setPrice(getItemPrice(getView(), 1))
    .setQuantity(getItemQuantity(getView(), 1))
    .setCurrencyCode("USD")
    .build());


// Sends the ecommerce data.
private void sendDataToTwoTrackers(Map<String, String> params) {
  AnalyticsSampleApp app = ((AnalyticsSampleApp) getActivity().getApplication());
  Tracker appTracker = app.getTracker(TrackerName.APP_TRACKER);
  Tracker ecommerceTracker = app.getTracker(TrackerName.ECOMMERCE_TRACKER);
  appTracker.send(params);
  ecommerceTracker.send(params);
}

Więcej informacji o metodzie getTracker znajdziesz w sekcji Konfiguracja zaawansowana.

Zobacz fragment kodu z przykładowej aplikacji

Ten fragment kodu zawiera pełny przykład e-commerce:

package com.google.android.apps.mobileplayground;

import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.KeyEvent;
import android.view.LayoutInflater;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.View.OnKeyListener;
import android.view.ViewGroup;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;
import com.google.android.apps.mobileplayground.AnalyticsSampleApp.TrackerName;
import com.google.android.apps.mobileplayground.MobilePlayground.UserInputException;
import com.google.android.gms.analytics.GoogleAnalytics;
import com.google.android.gms.analytics.HitBuilders;
import com.google.android.gms.analytics.Tracker;
import java.util.Map;

/**
 * Class to exercise Ecommerce hits.
 */
public class EcommerceFragment extends Fragment {

  @Override
  public View onCreateView(LayoutInflater inflater, ViewGroup container,
      Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    View view = inflater.inflate(R.layout.ecommerce, container, false);

    setUniqueOrderId(view);
    calculate(view);

    setupAutoCalculate(view, R.id.item1Quantity);
    setupAutoCalculate(view, R.id.item1Price);
    setupAutoCalculate(view, R.id.item2Quantity);
    setupAutoCalculate(view, R.id.item2Price);

    final Button sendButton = (Button) view.findViewById(R.id.ecommerceSend);
    sendButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        sendEcommerce();
      }
    });

    final Button dispatchButton = (Button) view.findViewById(R.id.ecommerceDispatch);
    dispatchButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        // Manually start a dispatch (Unnecessary if the tracker has a dispatch interval).
        GoogleAnalytics.getInstance(getActivity().getBaseContext()).dispatchLocalHits();
      }
    });
    return view;
  }

  private void sendEcommerce() {
    try {
      // Build the transaction.
      sendDataToTwoTrackers(new HitBuilders.TransactionBuilder()
          .setTransactionId(getOrderId())
          .setAffiliation(getStoreName())
          .setRevenue(getTotalOrder())
          .setTax(getTotalTax())
          .setShipping(getShippingCost())
          .setCurrencyCode("USD")
          .build());

      // Build an item.
      sendDataToTwoTrackers(new HitBuilders.ItemBuilder()
          .setTransactionId(getOrderId())
          .setName(getItemName(1))
          .setSku(getItemSku(1))
          .setCategory(getItemCategory(1))
          .setPrice(getItemPrice(getView(), 1))
          .setQuantity(getItemQuantity(getView(), 1))
          .setCurrencyCode("USD")
          .build());

      sendDataToTwoTrackers(new HitBuilders.ItemBuilder()
          .setTransactionId(getOrderId())
          .setName(getItemName(2))
          .setSku(getItemSku(2))
          .setCategory(getItemCategory(2))
          .setPrice(getItemPrice(getView(), 2))
          .setQuantity(getItemQuantity(getView(), 2))
          .setCurrencyCode("USD")
          .build());
    } catch (UserInputException e) {
      Toast.makeText(getActivity(), e.getMessage(), Toast.LENGTH_SHORT).show();
    }
    setUniqueOrderId(getView());
  }
  private void sendDataToTwoTrackers(Map<String, String> params) {
    AnalyticsSampleApp app = ((AnalyticsSampleApp) getActivity().getApplication());
    Tracker appTracker = app.getTracker(TrackerName.APP_TRACKER);
    Tracker ecommerceTracker = app.getTracker(TrackerName.ECOMMERCE_TRACKER);
    appTracker.send(params);
    ecommerceTracker.send(params);
  }
  private double calculate(View view) {
    double item1Total = getItemQuantity(view, 1) * getItemPrice(view, 1);
    ((TextView) view.findViewById(R.id.item1Total)).setText(Double.toString(item1Total));
    double item2Total = getItemQuantity(view, 2) * getItemPrice(view, 2);
    ((TextView) view.findViewById(R.id.item2Total)).setText(Double.toString(item2Total));
    double itemTotal = item1Total + item2Total;
    ((TextView) view.findViewById(R.id.itemTotal)).setText(Double.toString(itemTotal));
    return itemTotal;
  }

  private void setUniqueOrderId(View view) {
    final EditText orderIdButton = (EditText) view.findViewById(R.id.orderId);
    orderIdButton.setText(getString(R.string.orderId) + System.currentTimeMillis());
  }

  private void setupAutoCalculate(View view, int editTextId) {
    final EditText editText = (EditText) view.findViewById(editTextId);
    editText.setOnKeyListener(new OnKeyListener() {
      @Override
      public boolean onKey(View v, int keyCode, KeyEvent event) {
        calculate(getView());
        return false;
      }
    });
  }

  private String getStoreName() {
    String storeName =
        ((EditText) getView().findViewById(R.id.storeName)).getText().toString().trim();
    if (storeName.length() == 0) {
      return null;
    }
    return storeName;
  }

  private String getOrderId() throws UserInputException {
    String orderId = ((EditText) getView().findViewById(R.id.orderId)).getText().toString().trim();
    if (orderId.length() == 0) {
      throw new UserInputException(getString(R.string.orderIdWarning));
    }
    return orderId;
  }

  private double getTotalOrder() {
    String total = ((TextView) getView().findViewById(R.id.itemTotal)).getText().toString().trim();
    if (total.length() == 0) {
      return 0;
    }
    return Double.valueOf(total);
  }

  private double getTotalTax() {
    String tax = ((EditText) getView().findViewById(R.id.totalTax)).getText().toString().trim();
    if (tax.length() == 0) {
      return 0;
    }
    return Double.valueOf(tax);
  }

  private double getShippingCost() {
    String shipping =
        ((EditText) getView().findViewById(R.id.shippingCost)).getText().toString().trim();
    if (shipping.length() == 0) {
      return 0;
    }
    return Double.valueOf(shipping);
  }

  private String getItemName(int index) {
    int buttonId = index == 1 ? R.id.item1Name : R.id.item2Name;
    String name = ((EditText) getView().findViewById(buttonId)).getText().toString().trim();
    if (name.length() == 0) {
      return null;
    }
    return name;
  }

  private String getItemCategory(int index) {
    int buttonId = index == 1 ? R.id.item1Category : R.id.item2Category;
    String name = ((EditText) getView().findViewById(buttonId)).getText().toString().trim();
    if (name.length() == 0) {
      return null;
    }
    return name;
  }

  private String getItemSku(int index) throws UserInputException {
    int buttonId = index == 1 ? R.id.item1Sku : R.id.item2Sku;
    String sku = ((EditText) getView().findViewById(buttonId)).getText().toString().trim();
    if (sku.length() == 0) {
      int warningId = index == 1 ? R.string.item1SkuWarning : R.string.item2SkuWarning;
      throw new UserInputException(getString(warningId));
    }
    return sku;
  }

  private long getItemQuantity(View view, int index) {
    int buttonId = index == 1 ? R.id.item1Quantity : R.id.item2Quantity;
    String quantity = ((EditText) view.findViewById(buttonId)).getText().toString().trim();
    if (quantity.length() == 0) {
      return 0;
    }
    return Long.valueOf(quantity);
  }

  private double getItemPrice(View view, int index) {
    int buttonId = index == 1 ? R.id.item1Price : R.id.item2Price;
    String price = ((EditText) view.findViewById(buttonId)).getText().toString().trim();
    if (price.length() == 0) {
      return 0;
    }
    return Double.valueOf(price);
  }
}

Pola waluty e-commerce obsługują wartości ujemne, co może być konieczne w przypadku zwrotów środków.

Uwaga: w polach walut nie używaj symboli walut ani przecinkó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.