Rokt Ecommerce SDK+ Integration Guides

window.mParticle.ready(function() {
mParticle.logPageView("page_view", {
  screenname: "order-10482",
  pagetype: "confirmation",
  url: window.location.toString(),
  title: document.title,
  sitesection: "checkout",
  referringpage: document.referrer
});
});

// 1. Create the identifyRequest object
var identifyRequest = new IdentityApiRequest();
identifyRequest.UserIdentities = new Dictionary<UserIdentity, string>()
{
#if __ANDROID__
  { UserIdentity.Email, "j.smith@example.com" },
  { UserIdentity.MobileNumber, "+13125551515" },
  { UserIdentity.CustomerId, "cust_10482" }
#elif __IOS__
  { UserIdentity.Email, "j.smith@example.com" },
  { UserIdentity.MobileNumber, "+13125551515" },
  { UserIdentity.CustomerId, "cust_10482" }
#endif
};

// 2. Call the method matching the user action
MParticle.Instance.Identity.Login(identifyRequest)
  .AddSuccessListener(result =>
  {
      result.User.SetUserAttribute("firstname", "Jane");
      result.User.SetUserAttribute("lastname", "Smith");
  });

import mParticle_Apple_SDK
import RoktPaymentExtension

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
  let options = MParticleOptions(key: "your-key", secret: "your-secret")
  options.environment = .development

  let networkOptions = MPNetworkOptions()
  networkOptions.customBaseURL = URL(string: "https://rkt.example.com")
  options.networkOptions = networkOptions

  let identifyRequest = MPIdentityApiRequest.withEmptyUser()
  identifyRequest.email = "j.smith@example.com"
  // For hashed email: identifyRequest.setIdentity("sha256 hashed email", identityType: .other)

  options.identifyRequest = identifyRequest
  options.onIdentifyComplete = { (result, error) in
      if let user = result?.user {
          user.setUserAttribute("example attribute key", value: "example attribute value")
      }
  }
  MParticle.sharedInstance().start(with: options)
  return true
}

using mParticle.MAUI;

var attributes = new Dictionary<string, string>
{
  // Identity
  ["email"] = "j.smith@example.com",
  ["firstname"] = "Jenny",
  ["lastname"] = "Smith",
  ["mobile"] = "+13125551515",

  // Transaction
  ["confirmationref"] = "54321",
  ["currency"] = "USD",
  ["country"] = "US",
  ["language"] = "en",
  ["totalprice"] = "149.99",
  ["couponCode"] = "SUMMER20",

  // Customer context
  ["newcustomer"] = "false",
  ["customertype"] = "logged_in",
  ["value"] = "2340.00",
  ["subscriptionstatus"] = "active",
  ["customersegment"] = "vip",

  // Payment
  ["paymenttype"] = "credit_card",
  ["paymentServiceProvider"] = "cardpayment",
  ["ccbin"] = "411112",

  // Billing address
  ["billingaddress1"] = "123 Main St",
  ["billingcity"] = "Brooklyn",
  ["billingstate"] = "NY",
  ["billingzipcode"] = "11201",

  // Shipping
  ["shippingmethod"] = "express",
  ["shippingaddress1"] = "175 Varick St",
  ["shippingcity"] = "New York",
  ["shippingstate"] = "NY",
  ["shippingzipcode"] = "10014",
  ["shippingcountry"] = "US"
};

MParticle.Instance.Rokt.SelectPlacements(
  identifier: "RoktExperience",
  attributes: attributes
);

// 1. Retrieve from Web SDK+
const selection = await launcher.selectPlacements({ identifier: "checkout", attributes: { email: "user@example.com" } });
const sessionId = await selection.context.sessionId;
const sessionToken = '<session-token>';

// 2. Deep-link to native
const deepLink = `myapp://confirmation?sessionId=${encodeURIComponent(sessionId)}&sessionToken=${encodeURIComponent(sessionToken)}`;
window.location.href = deepLink;

// 3. Set in Cordova
mparticle.Rokt.setSessionId(sessionId);

// 4. Seed Web SDK+ from native session
window.mParticle = window.mParticle || { config: {} };
window.mParticle.config.launcherOptions = { sessionId: sessionId };
if (sessionToken) {
    window.mParticle.config.launcherOptions.sessionToken = sessionToken;
}

// 1. Define the identity request
val identifyRequest = IdentityApiRequest.withEmptyUser()
    .email("j.smith@example.com")
    .customerId("cust_10482")
    .build()

// 2. Define a task to set attributes upon successful identification
val identifyTask = BaseIdentityTask()
    .addSuccessListener { identityApiResult ->
        val user = identityApiResult.user
        user.setUserAttribute("example attribute key", "example attribute value")
    }

// 3. Pass both to MParticleOptions
val options = MParticleOptions.builder(this)
    .identify(identifyRequest)
    .identifyTask(identifyTask)
    .build()

var identifyRequest = new IdentityApiRequest();
identifyRequest.UserIdentities = new Dictionary<UserIdentity, string>()
{
  { UserIdentity.Email, "j.smith@example.com" },
  { UserIdentity.CustomerId, "cust_10482" }
};

// Set the identify request in options
options.IdentifyRequest = identifyRequest;

// Set attributes via the listener
options.IdentityStateListener = newUser =>
{
  if (newUser != null)
  {
      newUser.SetUserAttribute("example attribute key", "example attribute value");
  }
};

window.mParticle.ready(async function () {
  const selection = await window.mParticle.Rokt.selectPlacements({
    identifier: "prod.rokt.conf",
    attributes: {
      email: "j.smith@example.com",
      firstname: "Jenny",
      lastname: "Smith",
      mobile_number: "+13125551515",
      confirmationref: "ORDER-10482",
      currency: "USD",
      country: "US",
      language: "en",
      totalprice: 149.99,
      couponcode: "SUMMER20",
      newcustomer: false,
      customertype: "logged_in",
      value: 2340.00,
      subscriptionstatus: "active",
      customersegment: "vip",
      paymenttype: "credit_card",
      paymentServiceProvider: "cardpayment",
      ccbin: "411112",
      cartItems: [
        { cartitemid: "SKU-001", productsku: "SKU-001", productname: "Trail Runner v3", itemprice: 129.95, quantity: 1 }
      ]
    }
  });
});