Quick Start

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>
  );
}

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>
  );
}

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

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)

import { ConversationalAdWidget } from "@nohi/product-ads-sdk";
 
export function HomepagePlacement() {
  return (
    <ConversationalAdWidget
      placementId="home-hero-sponsored"
      context={{
        pageType: "home",
        sessionId: "session_123",
        customerSegment: "new-user",
      }}
      mode="redirect"
    />
  );
}

import { ConversationalAdWidget } from "@nohi/product-ads-react-native";
 
export function SponsoredPlacement() {
  return (
    <ConversationalAdWidget
      placementId="feed-inline-sponsored"
      context={{
        pageType: "feed",
        screenName: "Discover",
      }}
      mode="redirect"
    />
  );
}

import SwiftUI
import ProductAdsSDK
 
struct SponsoredAdView: View {
    var body: some View {
        ConversationalAdView(
            placementId: "home-inline-sponsored",
            context: [
                "pageType": "home",
                "entryPoint": "hero"
            ],
            mode: .redirect
        )
    }
}

import androidx.compose.runtime.Composable
import com.nohi.productads.ui.ConversationalAdWidget
 
@Composable
fun SponsoredPlacement() {
    ConversationalAdWidget(
        placementId = "search-sponsored-top",
        context = mapOf(
            "pageType" to "search",
            "query" to "running shoes"
        ),
        mode = "redirect"
    )
}

import { ConversationalAdWidget } from "@nohi/product-ads-sdk";
 
export function ProductUpsellPlacement() {
  return (
    <ConversationalAdWidget
      placementId="pdp-upsell-sponsored"
      context={{
        pageType: "product",
        productId: "prod_123",
      }}
      mode="instant-checkout"
      checkoutOptions={{
        presentation: "sheet",
      }}
    />
  );
}

import { ConversationalAdWidget } from "@nohi/product-ads-react-native";
 
export function CartUpsell() {
  return (
    <ConversationalAdWidget
      placementId="cart-upsell-sponsored"
      context={{ pageType: "cart" }}
      mode="instant-checkout"
    />
  );
}

import SwiftUI
import ProductAdsSDK
 
struct InstantCheckoutAdView: View {
    var body: some View {
        ConversationalAdView(
            placementId: "pdp-floating-sponsored",
            context: [
                "pageType": "product",
                "productId": "prod_123"
            ],
            mode: .instantCheckout
        )
    }
}

import androidx.compose.runtime.Composable
import com.nohi.productads.ui.ConversationalAdWidget
 
@Composable
fun CheckoutPlacement() {
    ConversationalAdWidget(
        placementId = "cart-sponsored-offer",
        context = mapOf("pageType" to "cart"),
        mode = "instant-checkout"
    )
}