Web developer
Start with the website quickstart. Then read Prevent flicker, Content Security Policy and Consent and storage before you go live. If your site is a single-page app, read Single-page applications.
Overview
Grona changes what shoppers see on your website and in your apps, measures the result, and lets your team run those changes as campaigns. This page shows the three ways developers connect to Grona and where to start with each one. Read it first, then pick a quickstart.
Three surfaces, three jobs
Section titled “Three surfaces, three jobs”| Surface | What it is | The job it does | Who installs it |
|---|---|---|---|
| Website script | Two script tags in the <head> of your site, served from cdn.grona.ai for your workspace |
Applies campaign changes to your pages in the browser, splits traffic between variations and measures page views and conversions | Web developers, or anyone who can edit the site template |
| Mobile SDKs | Native libraries for Android and iOS | Decides on the device which campaign a shopper sees in each placement, renders Grona components or hands your app a decision to render, and sends events after consent | Mobile developers |
| Public API | A REST API at https://api.grona.ai/v1/ with a secret key |
Creates, launches, pauses and deletes website campaigns from your own systems, returns editor links, and checks that the script is installed. It also returns grants for the mobile SDKs | Backend developers |
Most teams start with the website script or an SDK. The Public API is for teams that want to create campaigns from their own platform instead of the Grona dashboard. See Choose your integration for how the routes combine.
Quickstarts
Section titled “Quickstarts”Quickstart: websiteInstall the script, verify it and see your first variation live.
Quickstart: AndroidAdd the SDK, initialise it and show a Grona slot on the home screen.
Quickstart: iOSAdd the SDK with Swift Package Manager and show a Grona slot.
Quickstart: Public APICheck your script, create a campaign and open the visual editor with curl.
Where to next
Section titled “Where to next”Mobile developer
Read Rendering modes and Placements, then follow the Android or iOS quickstart. Before release, read Consent and data minimisation and Security model.
Backend developer
For website campaigns from your own platform, follow the Public API quickstart and read Authentication. For apps that show offers, read Backend integration overview and Grants and order verification.
Before you start
Section titled “Before you start”- Learn the vocabulary. Concepts and glossary defines every Grona term used on this site.
- Know your keys. Keys and environments lists every key and identifier and says which ones are safe to ship.
- Plan for review. Data, privacy and security and Domains and network calls answer the questions security and legal reviewers usually ask.