การติดตามอีคอมเมิร์ซ

เอกสารนี้จะแสดงภาพรวมของวิธีวัดการชำระเงินในแอปและ รายได้โดยใช้ Google Analytics SDK v4 สำหรับ Android

คำเตือน: SDK อีคอมเมิร์ซเลิกใช้งานแล้ว ใช้ SDK อีคอมเมิร์ซที่เพิ่มประสิทธิภาพ

ภาพรวม

การวัดอีคอมเมิร์ซช่วยให้คุณส่งยอดขายและการซื้อในแอปไปยัง Google Analytics ได้ ข้อมูลอีคอมเมิร์ซใน Google Analytics ประกอบด้วยธุรกรรมและ Hit ของรายการ ซึ่งเกี่ยวข้องกันโดยรหัสธุรกรรมที่ใช้ร่วมกัน

ธุรกรรมมีช่องต่อไปนี้

ชื่อช่อง	ประเภท	จำเป็น	คำอธิบาย
รหัสธุรกรรม	String	ได้	รหัสที่ไม่ซ้ำกันซึ่งแสดงธุรกรรม รหัสนี้ไม่ควรขัดแย้งกับรหัสธุรกรรมอื่นๆ
แอฟฟิลิเอต	String	ได้	บุคคลที่ควรมีส่วนเกี่ยวข้องกับธุรกรรม (เช่น ร้านค้าหนึ่งๆ)
รายได้	Double	ได้	รายได้ทั้งหมดของธุรกรรม รวมภาษีและค่าจัดส่ง
ภาษี	Double	ได้	ภาษีรวมสำหรับธุรกรรม
การจัดส่ง	Double	ได้	ค่าจัดส่งรวมสำหรับธุรกรรม
รหัสสกุลเงิน	String	ไม่ได้	สกุลเงินท้องถิ่นของธุรกรรม ค่าเริ่มต้นเป็นสกุลเงินของข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่ใช้ดูธุรกรรม

รายการจะมีช่องต่อไปนี้

ชื่อช่อง	ประเภท	จำเป็น	คำอธิบาย
รหัสธุรกรรม	String	ได้	รหัสธุรกรรมที่ควรเชื่อมโยงกับสินค้า
ชื่อ	String	ได้	ชื่อผลิตภัณฑ์
SKU	String	ได้	SKU ของผลิตภัณฑ์
หมวดหมู่	String	ไม่ได้	หมวดหมู่ที่มีผลิตภัณฑ์ดังกล่าว
ราคา	Double	ได้	ราคาของผลิตภัณฑ์
จำนวน	Long	ได้	จำนวนผลิตภัณฑ์
รหัสสกุลเงิน	String	ไม่ได้	สกุลเงินท้องถิ่นของธุรกรรม ค่าเริ่มต้นเป็นสกุลเงินของข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่มีการรายงานธุรกรรม

ระบบจะใช้ข้อมูลอีคอมเมิร์ซเป็นหลักในรายงานมาตรฐานต่อไปนี้

• ภาพรวมอีคอมเมิร์ซ
• ประสิทธิภาพผลิตภัณฑ์
• ประสิทธิภาพการขาย
• ธุรกรรม
• ระยะเวลาจนถึงวันซื้อ

การใช้งาน

ระบบใช้ TransactionBuilder และ ItemBuilder เพื่อส่งข้อมูลธุรกรรมและข้อมูลสินค้าไปยัง Google Analytics ช่องอีคอมเมิร์ซแต่ละช่องจะตั้งค่าโดยใช้เมธอดตัวช่วย เช่น

// 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);
}

ดูรายละเอียดเกี่ยวกับเมธอด getTracker ได้ที่ การกำหนดค่าขั้นสูง

ดูข้อมูลโค้ดจากแอปพลิเคชันตัวอย่าง

ข้อมูลโค้ดต่อไปนี้แสดงตัวอย่างอีคอมเมิร์ซแบบเต็ม

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);
  }
}

ช่องสกุลเงินอีคอมเมิร์ซรองรับค่าสกุลเงินที่ติดลบ ซึ่งอาจเป็นความจําเป็นในกรณีของการคืนเงินหรือการคืนสินค้า

ข้อควรระวัง: อย่าใส่สัญลักษณ์สกุลเงินหรือคอมมาในช่องสกุลเงิน

การระบุสกุลเงิน

โดยค่าเริ่มต้น ระบบจะถือว่ามูลค่าธุรกรรมเป็นสกุลเงินของข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่มีการรายงาน

หากต้องการลบล้างสกุลเงินท้องถิ่นของธุรกรรมและผลิตภัณฑ์ที่เกี่ยวข้อง ให้ตั้งค่าช่องรหัสสกุลเงินของรายการและ Hit ของรายการด้วยรหัสสกุลเงินใหม่ ดูรายการสกุลเงินและรหัสสกุลเงินที่รองรับทั้งหมดได้ใน ข้อมูลอ้างอิงสกุลเงินที่รองรับ