Отслеживание электронной торговли – iOS SDK

В этом документе представлен обзор того, как измерять платежи и доходы в приложениях с помощью 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
}