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

В этом документе представлена краткая информация об отслеживании платежей и дохода в приложении с помощью SDK Google Analytics для iOS версии 3.

Обзор

Отслеживание электронной торговли позволяет отправлять в Google Analytics данные о покупках в вашем приложении. Данные электронной торговли в Google Analytics состоят из обращений типов transaction (транзакция) и item (товар) с общим идентификатором транзакции.

Для транзакций используются следующие поля:

Название поля Поле трекера Тип Обязательно? Описание
Идентификатор транзакции kGAITransactionId NSString Да Уникальный идентификатор транзакции. Он не должен пересекаться с другими идентификаторами транзакций.
Партнерство kGAITransactionAffiliation NSString Да Подразделение, с которым связана транзакция (например, филиал или магазин).
Доход kGAITransactionRevenue NSNumber Да Общий доход от транзакции с учетом налогов и стоимости доставки.
Налог kGAITransactionTax NSNumber Да Общая сумма налогов для транзакции.
Доставка kGAITransactionShipping NSNumber Да Общая стоимость доставки для транзакции.
Код валюты kGAICurrencyCode NSString Нет Местная валюта транзакции. По умолчанию используется валюта, заданная в представлении (профиле).

Для товаров используются следующие поля:

Название поля Поле трекера Тип Обязательно? Описание
Идентификатор транзакции 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
}