SDK Initialization

Each platform initializes the SDK with:

API key
Environment or base URL
Optional merchant or application identifier
Optional analytics hooks
Optional checkout handlers
Optional navigation delegate

Shared Initialization Model

All platforms accept a common set of configuration options:


apiKey: string
baseUrl?: string
environment?: "production" | "staging"
appId?: string
merchantId?: string
locale?: string
currency?: string
onEvent?: (event) => void
onNavigateToProduct?: (product) => void
onInstantCheckout?: (payload) => void

Platform-Specific Initialization

React / TypeScript

Wrap your application tree with ProductAdsProvider:


import { ProductAdsProvider } from "@nohi/product-ads-sdk";
 
export function AppProviders({ children }: { children: React.ReactNode }) {
  return (
    <ProductAdsProvider
      apiKey={process.env.PRODUCT_ADS_API_KEY!}
      environment="production"
      appId="web-storefront"
      locale="en-US"
      currency="USD"
      onEvent={(event) => {
        console.log("product-ads event", event);
      }}
    >
      {children}
    </ProductAdsProvider>
  );
}

React Native

Wrap your application tree with ProductAdsProvider and use react-native-config for secrets:


import React from "react";
import { ProductAdsProvider } from "@nohi/product-ads-react-native";
import Config from "react-native-config";
 
export function AppProviders({ children }: { children: React.ReactNode }) {
  return (
    <ProductAdsProvider
      apiKey={Config.PRODUCT_ADS_API_KEY}
      environment="production"
      appId="mobile-app"
      locale="en-US"
      currency="USD"
      onEvent={(event) => {
        console.log(event);
      }}
    >
      {children}
    </ProductAdsProvider>
  );
}

Swift

Call ProductAdsSDK.configure at app launch:


import ProductAdsSDK
 
let sdk = ProductAdsSDK.configure(
    apiKey: ProcessInfo.processInfo.environment["PRODUCT_ADS_API_KEY"] ?? "",
    environment: .production,
    appId: "ios-app",
    locale: "en-US",
    currency: "USD"
)

Kotlin

Build a ProductAdsConfig and initialize in your Application class:


import com.nohi.productads.ProductAds
import com.nohi.productads.ProductAdsConfig
 
val config = ProductAdsConfig(
    apiKey = BuildConfig.PRODUCT_ADS_API_KEY,
    environment = "production",
    appId = "android-app",
    locale = "en-US",
    currency = "USD"
)
 
ProductAds.initialize(context = applicationContext, config = config)