Getting startedIntegration Preview

Quick Start

Get your first ad decision in the sandbox environment in a few steps and learn how to read the result.

Preview

The steps below illustrate the integration flow. Actual endpoints, key formats and package names are provided in your account-specific documentation after approval.

1. Get your sandbox keys

Once your account is approved, the dashboard issues separate keys for two environments: sandbox and live. Always start in sandbox; sandbox decisions never generate real impressions or revenue.

2. Define your first placement

Create a placement from the dashboard or via the API. For example, define a placement named rewarded for a rewarded video on the post-match screen, and a policy named brand-safe.

3. Send a decision request

curl https://api.reinoads.com/v1/decisions \
  -H "Authorization: Bearer sk_sandbox_..." \
  -H "Content-Type: application/json" \
  -d '{
    "placement": "rewarded",
    "policy": "brand-safe",
    "audience": { "segments": ["premium", "engaged_30d"] },
    "consent": { "kvkk": true, "personalized_ads": true }
  }'

4. Read the result

{
  "id": "dec_01HZX4K2Q8",
  "outcome": "served",
  "placement": "rewarded",
  "format": "rewarded_video",
  "source": { "type": "controlled", "id": "src_direct_sponsor" },
  "creative": {
    "id": "cr_8812",
    "media_url": "https://cdn.example.com/creatives/cr_8812.mp4",
    "click_url": "https://example.com/landing"
  },
  "reward": { "type": "coins", "amount": 50 },
  "tracking": {
    "impression": "https://api.reinoads.com/v1/events/imp/dec_01HZX4K2Q8",
    "click": "https://api.reinoads.com/v1/events/clk/dec_01HZX4K2Q8"
  },
  "environment": "sandbox"
}

Next step

If outcome is anything other than served, collapse the slot or show a house ad. Every outcome is described in the Ad Decision section.