Perks · Internal Admin

Launch Perk

Publish a test perk to a brand's points of sale.

Country (narrows the brand list)

Brand

Perk Type (what they get)

Title (on the card · max 60)

Perk Value (max 24)

Description (max 140)

＋ Target Audience (optional)

Genders

Age from

Age to

Dietary

Food / drink perk (consumable)

Background photo (required · mobile hero 16:9)

Drop a plain background photo (or click to choose) — cropped to the mobile hero, exactly 1200×675 (16:9). No text or logos; the system renders the perk copy so every card matches the Perks style.

The image is a plain background photo — no text or logos baked in. Delivered at this brand

Tap a point of sale to turn the perk on or off there. Green = the perk runs at that point of sale, red = it doesn't. All on = a chain-wide perk. Points of sale are managed in Add Brand.

Associated Tags

Add a tag

A tag is a habit people choose, not a label for the offer — it decides who gets shown this perk. Use a word someone would say about themselves (coffee, bakery, toys), never an internal name. A brand-new tag matches nobody until a tester picks it under You → Your habits in the app.

Starts

Ends

Inventory

Quantity

Preview

Background photo

Brand

Perk name

Live Perks

What the app is pulling right now from /manifest-index.

Loading…

Create a brand

Publish a brand the feed doesn't have yet — a shop near a tester, for example. It goes live immediately, and a tester standing at one of its points of sale gets an alert exactly like any other brand's.

Brand name

Country / market (optional)

What kind of shop?

Brand details

Logo, points of sale and perks belong to one brand. Pick a brand to work on it.

Brand

Image sizes this console uses

Background photo1200 × 675 · JPEG, 16:9

Square brand logo256 × 256 · PNG, 1:1

Horizontal logo / wordmark768 × 256 · PNG, 3:1 · perk page

Any file you upload is resized to these automatically — square logos are centre-cropped, wordmarks are fitted (never cropped), photos are centre-cropped. Logos stay PNG (so transparency survives) and photos are JPEG at high quality; nothing is downsampled to save space, so give it the best file you have and it will keep its detail.

Square brand logo 256 × 256 PNG (1:1) · shown on perk cards and in the app icon slot

No logo

Horizontal logo / wordmark 768 × 256 PNG (3:1) · stands in for the brand name on the perk page

No wordmark

Use transparent PNGs. The square mark is what a perk card shows, next to the brand name; the wordmark stands in for that name on the perk page itself. They appear in different places, so a brand never reads twice in one view.

Points of Sale (0)

＋ Add a point of sale / city to this brand

Preset city (city, country · A–Z)

Points of sale must sit in the brand's market. Pick a preset above, or type a name and grab lat/lon by right-clicking a spot in Google Maps. A ~150 m geofence is minted around it.

Metrics

What the network is carrying, and the anonymised activity recorded against it. Counts only — claims/redemptions are token references and telemetry is an event id in a time bucket, so nothing here can identify a person. Demo-data build-out for redemption & telemetry comes next.

Installs

How many phones opened the app and how far they got through setup. This is the only panel here that reports on the app rather than on a perk. An install is a phone, not a person: a reinstall counts again, and the key behind these counts changes every day — so nothing here can follow a phone from one day to the next, and no count can be sliced by brand, venue or perk.

Active installs, last 14 days (UTC days)

Day	Installs	Opens	Setup started	Setup finished

Builds in the wild

Build	Installs

Transactions

What the recorded outcomes actually are. A redemption reported by the phone is not a verified sale — only a merchant-confirmed outcome counts as one.

Confirmation source

Source	Outcomes

Presentation channel

Channel	Outcomes

Presentation → redemption delay (hour-bucket resolution — a five-minute and a thirty-minute delay look the same, by design)

Elapsed	Outcomes

By Perk Type

The analytical record: what a tester actually gets. This is how we learn which types work best for a brand (claims → redemptions).

Perk Type	Perks	Claims	Redeemed	Conv.

By brand

Content coverage (perks, points of sale, logo) plus activity per brand.

Brand	Market	Points of Sale	Logo	Perks	Claims	Redeemed

Top Perks

Ranked by redemptions, then claims. Empty until devices (or the tester simulation) work this server.

Perk	Brand	Type	Value	Claims	Redeemed

Simulate a redemption demo data

Records an outcome without a device so you can demonstrate the loop (perk → presentation → redemption → metrics). Every row created here is flagged simulated and is never presented as a measured result — the brief requires synthetic demonstrations to be labelled. Use it for the demo, then Clear simulated before you capture anything you intend to treat as evidence.

Perk

Presentation channel

Outcome

Presentation → redemption gap (hours)

Sale value (minor units, optional)

Currency

Internal Admin users

People who can sign in to this Internal Admin and publish perks. Add one per demo operator — each signs in with their own name and password.

Account

Set a new password below — no need to enter the old one. It keeps you signed in on this browser.

Get the App

Where the team installs the Perks demo build. TestFlight installs and updates itself — no device IDs, no cables. Share the link below, or send someone this page.

Tester instructions

Install TestFlight from the App Store (Apple's test-install app).
Open the install link above on the iPhone — it opens TestFlight.
Accept the invite, then tap Install.
Open Perks and allow location ("While Using" is enough for matching).
For the demo: Settings → Demo mode lets you stand at a store and simulate a redemption indoors. Anything recorded that way is flagged as demo data.

Tester feedback rarely mentions the build number, so the label above is what to quote. TestFlight builds expire after 90 days — re-upload before a demo that matters.

Edit this page

Paste the link from App Store Connect → TestFlight → (external testing) public link, or an ad-hoc itms-services:// link. The full tester guide is Docs/TESTERS.md in the repo — the note below is the short version testers read next to the install button, and CHANGELOG.md is what changed in the build.

Install link

Build label

Note to testers (optional)