В этом документе представлен обзор того, как измерять платежи и доходы в приложениях с помощью Google Analytics SDK для Android v2.
Обзор
Измерение электронной торговли позволяет отправлять данные о покупках и продажах в приложении в Google Analytics. Данные электронной торговли в Google Analytics обычно состоят из транзакций и товаров, связанных общим идентификатором транзакции. В Google Analytics SDK для Android эта связь устанавливается путем создания объекта транзакции и добавления к нему элементов.
Данные электронной торговли используются в основном в следующих отчетах:
- Обзор электронной торговли
- Производительность продукта
- Эффективность продаж
- Транзакции
- Время покупать
Выполнение
Чтобы измерить транзакцию с помощью Google Analytics, необходимо выполнить три шага:
- Создайте объект транзакции.
- Создайте объекты элементов и добавьте их в объект транзакции.
- Отправьте транзакцию с помощью
sendTransaction(Transaction transObject).
В следующем примере мы предполагаем, что onPurchaseCompleted() вызывается после того, как пользователь совершил покупку в приложении.
/**
* 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.
}
Типы валют
В Google Analytics SDK для Android поля валюты электронной торговли должны быть указаны в микронах (миллионных долях валюты).
Например, чтобы отправить значение валюты 4.5991 , вам следует преобразовать это значение в микро (т. е. 4599100 ) при отправке транзакции в Google Analytics, как в примерах выше. Когда SDK отправляет эту транзакцию в Google Analytics, это значение автоматически преобразуется в десятичное значение с фиксированной запятой и отправляется как 4.5991 .
В код электронной торговли не следует включать символы валют и использовать запятые.
Поля валюты электронной торговли также поддерживают отрицательные значения валюты, что может быть необходимо в случае возмещения или возврата средств.
Указание валюты
По умолчанию предполагается, что значения транзакций указаны в валюте представления (профиля), в котором они представлены.
Чтобы переопределить местную валюту транзакции, вызовите setCurrencyCode при создании Transaction , как показано в следующем примере:
/**
* 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);
}
Полный список поддерживаемых валют и кодов валют см. в Справочнике поддерживаемых валют .