В этом документе представлен обзор того, как измерять платежи и доходы в приложениях с помощью Google Analytics SDK для iOS v3.
Обзор
Измерение электронной торговли позволяет отправлять данные о покупках и продажах в приложении в Google Analytics. Данные электронной торговли в Google Analytics состоят из обращений к транзакциям и товарам, связанных общим идентификатором транзакции.
Транзакции имеют следующие поля:
Имя поля | Поле трекера | Тип | Необходимый | Описание |
---|---|---|---|---|
ID транзакции | kGAITransactionId | NSString | Да | Уникальный идентификатор, представляющий транзакцию. Этот идентификатор не должен конфликтовать с другими идентификаторами транзакций. |
Принадлежность | kGAITransactionAffiliation | NSString | Да | Организация, с которой должна быть связана транзакция (например, конкретный магазин) |
Доход | kGAITransactionRevenue | NSNumber | Да | Общий доход от транзакции, включая налоги и стоимость доставки. |
Налог | kGAITransactionTax | NSNumber | Да | Общий налог за транзакцию |
Перевозки | kGAITransactionShipping | NSNumber | Да | Общая стоимость доставки для транзакции |
Код валюты | kGAICurrencyCode | NSString | Нет | Местная валюта транзакции. По умолчанию используется валюта представления (профиля), в котором просматриваются транзакции. |
Элементы имеют следующие поля:
Имя поля | Поле трекера | Тип | Необходимый | Описание |
---|---|---|---|---|
ID транзакции | kGAITransactionId | NSString | Да | Идентификатор транзакции, с которой должен быть связан элемент |
Имя | kGAIItemName | NSString | Да | Название продукта |
Артикул | kGAIItemSku | NSString | Да | Артикул продукта |
Категория | kGAIItemCategory | NSString | Нет | Категория, к которой относится товар |
Цена | kGAIItemPrice | NSNumber | Да | Цена продукта |
Количество | kGAIItemQuantity | NSNumber | Да | Количество продукта |
Код валюты | kGAICurrencyCode | NSString | Нет | Местная валюта транзакции. По умолчанию используется валюта представления (профиля), в котором сообщается о транзакциях. |
Данные электронной торговли используются в основном в следующих стандартных отчетах:
- Обзор электронной торговли
- Производительность продукта
- Эффективность продаж
- Транзакции
- Время покупать
Выполнение
Для отправки данных о транзакциях и товарах в Google Analytics необходимо установить значения полей транзакции и товара на трекере и отправлять их по одному. Например:
/* * 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 }
Поля валюты электронной торговли поддерживают отрицательные значения валюты, что может быть необходимо в случае возмещения или возврата средств.
Указание валюты
По умолчанию предполагается, что значения транзакций указаны в валюте представления (профиля), в котором они представлены.
Чтобы переопределить местную валюту транзакции и любых связанных продуктов, установите в поле кода валюты транзакции и совпадений элементов новый код валюты. Полный список поддерживаемых валют и кодов валют см. в Справочнике поддерживаемых валют .
/* 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 }