Getting Started

Quick Start

Get the Prism AR SDK installed and serving your first ad in under 30 minutes. This guide walks you through account setup, SDK integration, and your first test impression.

Prerequisites

✓ A Prism AR developer account — sign up here
✓ Xcode 15+ (for visionOS) or Android Studio Hedgehog+ (for Android XR)
✓ An existing spatial app project

Step 1 — Create your app in the dashboard

Log into the Prism AR dashboard and navigate to Inventory Management. Create a Publisher, then add your App. You'll need the following details:

Field	Description
App Name	The display name of your app
Bundle ID	Your app's unique identifier (e.g. com.example.myapp)
OS	iOS (visionOS) or Android XR
Download URL	App Store or Play Store link
Min CPM Floor	Minimum CPM you'll accept for impressions

Step 2 — Install the SDK

Choose your platform and follow the installation guide:

visionOS

Install via Swift Package Manager →

Android XR

Install via Gradle dependency →

Step 3 — Initialize the SDK

Initialize Prism AR with your App ID at launch. You can find your App ID in the dashboard under Inventory Management.

Swift (visionOS)

import PrismAR

@main
struct MyApp: App {
    init() {
        PrismAR.initialize(appId: "YOUR_APP_ID")
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Kotlin (Android XR)

import ai.prismar.sdk.PrismAR

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        PrismAR.initialize(this, appId = "YOUR_APP_ID")
    }
}

Step 4 — Add a placement

In the dashboard, add a Placement to your app. Then use your Placement ID to request an ad:

Swift (visionOS)

import PrismAR
import SwiftUI

struct ContentView: View {
    var body: some View {
        ZStack {
            // Your app content
            MyAppContent()

            // Prism AR overlay placement
            PrismAdView(placementId: "YOUR_PLACEMENT_ID")
                .frame(width: 400, height: 300)
        }
    }
}

Kotlin (Android XR)

import ai.prismar.sdk.PrismAdView

@Composable
fun MyScreen() {
    Box {
        // Your app content
        MyAppContent()

        // Prism AR overlay placement
        PrismAdView(
            placementId = "YOUR_PLACEMENT_ID",
            modifier = Modifier.size(400.dp, 300.dp)
        )
    }
}

Step 5 — Test your integration

Enable test mode to verify your integration without serving live ads. Set the environment flag before initializing:

Swift

PrismAR.initialize(appId: "YOUR_APP_ID", environment: .test)

You're live 🎉

Once you see a test ad render, switch to .production and submit your app. Impressions will begin flowing through the Prism AR exchange within minutes of going live.

Next Steps

SDK Installation

Full platform-specific installation guides

Overlay Ads

Configure display and video ad formats

Dimensional Ads

Anchor 3D placements to real surfaces

Analytics

Approach, gaze, and attention metrics

Need help?

Our developer team is here for integration questions and technical issues.

developers@prismar.ai →