GAIEcommerceProductAction Class Reference

Overview

Class to construct transaction/checkout or other product interaction related information for a Google Analytics hit.

Use this class to report information about products sold, viewed or refunded. This class is intended to be used with GAIDictionaryBuilder.
Typical usage:

[tracker set:kGAIScreenName value:@"MyScreen"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];
GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPAPurchase];
[action setTransactionId:@"TT-1234"];
[action setRevenue:@3.14];
[action setCouponCode:@"EXTRA100"];
[builder setProductAction:action];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@""PID-1234""];
[product setName:@"Space Monkeys!"];
[product setPrice:@100];
[product setQuantity:@2];
[builder addProduct:product];
[tracker send:[builder build]];

Inherits NSObject.

Instance Methods

(GAIEcommerceProductAction *) - setAction:
 Sets the product action field for this product action. More...
 
(GAIEcommerceProductAction *) - setTransactionId:
 The unique id associated with the transaction. More...
 
(GAIEcommerceProductAction *) - setAffiliation:
 Sets the transaction's affiliation value. More...
 
(GAIEcommerceProductAction *) - setRevenue:
 Sets the transaction's total revenue. More...
 
(GAIEcommerceProductAction *) - setTax:
 Sets the transaction's total tax. More...
 
(GAIEcommerceProductAction *) - setShipping:
 Sets the transaction's total shipping costs. More...
 
(GAIEcommerceProductAction *) - setCouponCode:
 Sets the coupon code used in this transaction. More...
 
(GAIEcommerceProductAction *) - setCheckoutStep:
 Sets the checkout process's progress. More...
 
(GAIEcommerceProductAction *) - setCheckoutOption:
 Sets the option associated with the checkout. More...
 
(GAIEcommerceProductAction *) - setProductActionList:
 Sets the list name associated with the products in Google Analytics beacons. More...
 
(GAIEcommerceProductAction *) - setProductListSource:
 Sets the list source name associated with the products in Google Analytics beacons. More...
 
(NSDictionary *) - build
 Builds an NSDictionary of fields stored in this instance representing this product action. More...
 

Method Documentation

- (GAIEcommerceProductAction *) setAction: (NSString *)  productAction

Sets the product action field for this product action.

Valid values can be found in GAIEcommerceFields.h under "product action values".

- (GAIEcommerceProductAction *) setTransactionId: (NSString *)  transactionId

The unique id associated with the transaction.

This value is used for kGAIPAPurchase and kGAIPARefund product actions.

- (GAIEcommerceProductAction *) setAffiliation: (NSString *)  affiliation

Sets the transaction's affiliation value.

This value is used for kGAIPAPurchase and kGAIPARefund product actions.

- (GAIEcommerceProductAction *) setRevenue: (NSNumber *)  revenue

Sets the transaction's total revenue.

This value is used for kGAIPAPurchase and kGAIPARefund product actions.

- (GAIEcommerceProductAction *) setTax: (NSNumber *)  tax

Sets the transaction's total tax.

This value is used for kGAIPAPurchase and kGAIPARefund product actions.

- (GAIEcommerceProductAction *) setShipping: (NSNumber *)  shipping

Sets the transaction's total shipping costs.

This value is used for kGAIPAPurchase and kGAIPARefund product actions.

- (GAIEcommerceProductAction *) setCouponCode: (NSString *)  couponCode

Sets the coupon code used in this transaction.

This value is used for kGAIPAPurchase and kGAIPARefund product actions.

- (GAIEcommerceProductAction *) setCheckoutStep: (NSNumber *)  checkoutStep

Sets the checkout process's progress.

This value is used for kGAICheckout and kGAICheckoutOptions product actions.

- (GAIEcommerceProductAction *) setCheckoutOption: (NSString *)  checkoutOption

Sets the option associated with the checkout.

This value is used for kGAICheckout and kGAICheckoutOptions product actions.

- (GAIEcommerceProductAction *) setProductActionList: (NSString *)  productActionList

Sets the list name associated with the products in Google Analytics beacons.

This value is used in kGAIPADetail and kGAIPAClick product actions.

- (GAIEcommerceProductAction *) setProductListSource: (NSString *)  productListSource

Sets the list source name associated with the products in Google Analytics beacons.

This value is used in kGAIPADetail and kGAIPAClick product actions.

- (NSDictionary *) build

Builds an NSDictionary of fields stored in this instance representing this product action.


Normally, users will have no need to call this method.