Products 91797a

Data collection / Apple / Ecommerce / Products

Foreword

AT Internet’s SDK enables you to tag products for sale that are viewed by your users during usage of your application.

The measurement of viewed products needs an option to be activated. Please contact the support centre for more information.

Get off to a good start

Once your tag has been initialised, you can send information of viewed products.

In cases of a Swift project, please import the Tracker module (or TrackerExtension if your target is an extension) in your ViewController. In case of an Objective-C project, please import the headers ATInternet.h, ATTracker.h, ATProduct.h

Tagging

The tracker makes a products property available. This property exposes the following methods :

• add (or addString in Objective-C) : Add a viewed product to the list and returns a Product object.
• remove: Removes a viewed product in the list.
• removeAll:Removes all viewed products.
• sendViews : Send all viewed products.

Tagging examples

1. Tagging a viewed product

   • Swift
   • Objective-C

import UIKit
import Tracker

class ViewController: UIViewController {
    let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewDidLoad() {
        super.viewDidLoad()
    }
    
    override func viewWillAppear(animated: Bool) {            
        tracker.products.add("1253[MF885FA]", category1: "1[Desktop]", category2: "10[iMac]").sendView()
    }
}

#import "ViewController.h"
#import "ATInternet.h"
#import "ATTracker.h"
#import "ATProduct.h"

@interface ViewController ()
@property (nonatomic, strong) ATTracker* tracker;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.tracker = [ATInternet sharedInstance].defaultTracker;
}

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    
    [[self.tracker.products add:@"1253[MF885FA]" category1:@"1[Desktop]" category2: @"10[iMac]"] sendView];
}

@end

2. Tagging several viewed products

   • Swift
   • Objective-C

import UIKit
import Tracker

class ViewController: UIViewController {
    let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewDidLoad() {
        super.viewDidLoad()
    }
    
    override func viewWillAppear(animated: Bool) {
        tracker.products.add("1254[MF839FA]", category1: "2[Laptop]", category2: "20[Macbook Pro]")
        tracker.products.add("1253[MF885FA]", category1: "1[Desktop]", category2: "10[iMac]")
        tracker.products.sendViews()
    }
}

#import "ViewController.h"
#import "ATInternet.h"
#import "ATTracker.h"
#import "ATProduct.h"

@interface ViewController ()
@property (nonatomic, strong) ATTracker* tracker;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.tracker = [ATInternet sharedInstance].defaultTracker;
}

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];

    [self.tracker.products add:@"1254[MF839FA]" category1: @"2[Laptop]" category2: @"20[Macbook Pro]"];
    [self.tracker.products add:@"1253[MF885FA]" category1: @"1[Desktop]" category2: @"10[iMac]"];

    [self.tracker.products sendViews];
}

@end

3. Tagging viewed products with an �add to cart

   • Swift
   • Objective-C

import UIKit
import Tracker

class ViewController: UIViewController {
    let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
    var products: [Product] = []
    
    override func viewDidLoad() {
        super.viewDidLoad()

        // Enable cart and set an ID
        tracker.cart.set("1")

        // Declare first product
        let p1 = tracker.products.add("1254[MF839FA]", category1: "2[Laptop]", category2: "20[Macbook Pro]")
        p1.quantity = 1
        p1.unitPriceTaxFree = 1839
        p1.unitPriceTaxIncluded = 2299

        products.append(p1)
        
        // Declare second product
        let p2 = tracker.products.add("1253[MF885FA]", category1: "1[Desktop]", category2: "10[iMac]")
        p2.quantity = 1
        p2.unitPriceTaxFree = 1199
        p2.unitPriceTaxIncluded = 1499

        products.append(p2)
    }
    
    override func viewWillAppear(animated: Bool) {
        // Send products views
        tracker.products.sendViews()

        // Send screen hit
        tracker.screens.add("Store").sendView()
    }

    @IBAction func addProductToCart(sender: UIButton) {
        // Add a previously declared product to the cart
        tracker.cart.products.add(products[0])
    } 

    override func prepareForSegue(segue: UIStoryboardSegue, sender: AnyObject?) {
        // Go to cart resume and send a screen hit with cart content
         let cartScreen = tracker.screens.add("Cart resume")
        // If isBasketScreen is not set to true, Cart info won't be added to Screen hit
        cartScreen.isBasketScreen = true
        cartScreen.sendView()
    }
}

#import "ViewController.h"
#import "ATInternet.h"
#import "ATTracker.h"
#import "ATScreen.h"
#import "ATCart.h"
#import "ATProduct.h"

@interface ViewController ()
@property (nonatomic, strong) ATTracker* tracker;
@property (nonatomic, strong) NSMutableArray* products;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.tracker = [ATInternet sharedInstance].defaultTracker;
    self.products = [[NSMutableArray alloc] init];

    [self.tracker.cart setWithId:@"1"];

    ATProduct *p1 = [self.tracker.products add:@"1254[MF839FA]" category1: @"2[Laptop]" category2: @"20[Macbook Pro]"];
    
    p1.quantity = 1;
    p1.unitPriceTaxFree = 1839;
    p1.unitPriceTaxIncluded = 2299;

    [self.products addObject:p1];

    ATProduct *p2 = [self.tracker.products add:@"1253[MF885FA]" category1: @"1[Desktop]" category2: @"10[iMac]"];
    
    p2.quantity = 1;
    p2.unitPriceTaxFree = 1149;
    p2.unitPriceTaxIncluded = 1499;

    [self.products addObject:p2];
}

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];

    // Send products views
    [self.tracker.products sendViews];
    
    [[self.tracker.screens addWithName:@"Store"] sendView];
}

- (IBAction) addProductToCart:(UIButton *)sender {
    // Add a previously declared product to the cart
    [self.tracker.cart.products add:self.products[0]];
}

- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
    // Go to cart resume and send a screen hit with cart content
    ATScreen* cartScreen = [self.tracker.screens addWithName:@"Cart resume"];
    // If isBasketScreen is not set to true, Cart info won't be added to Screen hit
    cartScreen.isBasketScreen = YES;
    [cartScreen sendView];
}
@end

4. Removal of a product

   • Swift
   • Objective-C

@IBAction func removeProduct(sender: UIButton) {
    tracker.products.remove("1254[MF839FA]")
}

- (IBAction) removeProduct:(UIButton *)sender {
    [self.tracker.products removeWithId:@"1254[MF839FA]"];
}

5. Removal of all products

   • Swift
   • Objective-C

@IBAction func removeProducts(sender: UIButton) {
    tracker.products.removeAll()
}

- (IBAction) removeProducts:(UIButton *)sender {
    [self.tracker.products removeAll];
}