1stTrip – Travel Mat™ Ad Manager How-Tos

1) Start — What Ads is

Purpose Text-only listings shown inside planner flows in → TM, matching the traveler’s distance settings.

$5 CPC cap (you may set lower per-campaign caps).
Final-sale preview — approve “as-shown” before funding (all sales final).
No support — use this How-To; legal notices only via the legal channel.

Choose your track: Solo Business Owner or Reseller.

2) Account — Quick Route

Solo: one brand, up to three addresses → see Solo.
Reseller: many client brands, seats and bulk → see Reseller.
Access: Passkeys/WebAuthn (optional TOTP). No email logins.
Checkout-first: create account after selecting budget/pack.

3) Solo — One brand, up to 3 addresses

Who

Solo Business Owner — one brand with a few locations.

Limit

Up to 3 listings at 3 different addresses under one account.

Upgrade

Need more addresses? Upgrade to Reseller.

Wallet

Single prepaid wallet; low-fund banner/alert.

Roles

Owner (full control) + optional Viewer (reports only).

Starter

Typical first top-up: $10 (USD).

Auto text: The 150-char ad line is auto-generated from your inputs; you can edit before funding.

Inputs → Output (example)

Input field	Example value
Business	Example Cafe
Street	12 Bread St
City	Berlin
Postal	10115
Country	DE
Keywords (1–3)	coffee, pastry
Open hours	Mon–Fri 07:00–18:00; Sat 08:00–16:00
Mode / Radius	walk / 10 minutes

Generated ad (you can edit):

Example Cafe — Fresh espresso & pastry before 11:00
Category: Food & Drink · Near Central Station
Open: Mon–Fri 07:00–18:00; Sat 08:00–16:00

4) Reseller — Many clients, seats & bulk tools

Who

Reseller — one org managing many client brands.

Seats

Buy/upgrade/downgrade seats; invite staff/clients (tokens expire in ~72h).

Wallets

Per-client wallets; optional org wallet; client/org low-fund alerts.

Roles

Owner — seats, billing, create clients, org reports. Owner can create Managers.

Manager — create/edit campaigns for assigned clients, run reports, bulk uploads. Managers can create Staff members.

Viewer (Staff) — read-only reports (client or org scope).

Bulk

10-row Quick Form per client; multi-client batch via client_ref.

5) Campaign — Business, Keywords, Text

Business

Legal name + full street address (for proximity checks).

Keywords

1–3 short terms (e.g., “ramen”, “parking”, “walking tour”).

Text (150)

Ad Manager writes this from your inputs; you can edit before funding. No emojis, all-caps, or phone numbers.

Preview

Approve the “as-shown” card (final-sale gate) then fund wallet.

Controls

Pause/Resume anytime. Schedule: in Live mode you can show ads only during selected hours.

6) Targeting — Address, Minutes, Mode (Planner vs Live)

Advertiser location: centered on your venue address/postal.
Traveler location: 1stTrip → TM uses the traveler’s selected point (hotel, street name/number, or device location) to calculate distance/time to your venue.
Time radius & mode: set radius_minutes and mode (walk | drive); delivery respects the traveler’s corridor.
Categories: up to 2 (Food & Drink, Parking, Tours, Retail).

Planner vs Live — what actually happens

Mode	When it can show	Uses hours?	Typical use
Planner	Any date/time during planning; current opening hours do not hide the ad.	Optional (for info display only).	Trip planning; attractions, tours, parking, passes.
Live	Only when your venue is open now per your `open_hours` (local time) or a custom ad schedule.	Yes — ad hides when closed; shows next open window or scheduled window.	Restaurants, cafés, services, “open now” offers.

Examples

Planner: “City tour daily at 10:00 & 14:00. Book ahead.” — visible any time.
Live: “Lunch set 11:30–15:00.” — hidden outside 11:30–15:00 local time.

Platform currency is USD ($) for pricing and reports. Checkout may show a local conversion for clarity.

7) Pricing — Base × Weekly × Event (USD)

Base — market baseline by city & category.
Weekly — demand factor (weekday/weekend, seasonality).
Event — spikes near venues (still obeys radius).
CPC cap — never above $5; set lower per-campaign caps if you wish.

Pricing math (USD):
Effective CPC = Base × Weekly × Event  (capped ≤ your CPC cap, global cap $5)
Example: Base $0.80 × Weekly 1.25 × Event 1.6 = $1.60 CPC (≤ your $2.00 cap)

8) Integrity — Caps, Turnstile, Quarantine

Caps — daily & hourly caps prevent runaway spend.
Turnstile — anti-bot checks on high-risk clicks.
Quarantine — anomalies are paused and reviewed.
Nightly auto-credits — invalid/filtered clicks are credited back.

9) Reports — Metrics & CSV

Metrics: Impressions, Clicks, CPM, CPC, spend, auto-credits.
Scopes: campaign; account (Solo). For Reseller: client and org roll-up.
CSV: choose date range + group-by in dashboard (download in USD).

Visual CSV (account/campaign exports)

Column	Description	Example
date	UTC date	2025-10-01
campaign_id	Your campaign reference	cmp_12345
impressions	Shown count	1240
clicks	Click count	62
cpm	Cost per 1,000 impressions (USD)	2.40
cpc	Cost per click (USD)	1.60
auto_credits	Nightly invalid-click credits (USD)	0.80

10) Bulk & Seats — Setup for Resellers

Seats — invite staff/clients (Owner, Manager, Viewer).
Budgets — per-client wallets; optional org wallet; daily caps and org ceiling.
Bulk Quick Form — 10 rows per upload; multi-client batch via client_ref.

Bulk schema (16 columns)

#	Field	Notes	Example
1	business_name	Legal/trading name	Sample Bakery
2	street	Street + number	12 Bread St
3	city	City/locality	Berlin
4	postal	Postal/ZIP	10115
5	country	ISO-2 country	DE
6	keywords	Comma-separated (≤3)	bakery,bread
7	text	Max 150 chars; no emojis/phone	Fresh bread daily
8	category	Allowed category	Food
9	radius_minutes	Integer minutes (e.g., 5/10/15)	10
10	mode	`walk` \| `drive`	walk
11	planner_closed_hours	true\|false	true
12	open_hours	Free text	Mo–Fr 07:00–18:00; Sa 08:00–16:00
13	start_date	YYYY-MM-DD	2025-10-15
14	end_date	YYYY-MM-DD	2025-12-31
15	daily_budget_cents	Integer (USD cents)	500
16	client_ref (batch)	Routes rows to client seat	cafe-alpha

Headers (copy/paste)

business_name,street,city,postal,country,keywords,text,category,radius_minutes,mode,planner_closed_hours,open_hours,start_date,end_date,daily_budget_cents

Row example

Sample Bakery,12 Bread St,Berlin,10115,DE,"bakery,bread","Fresh bread daily",Food,10,walk,true,"Mo-Fr 07:00-18:00; Sa 08:00-16:00",2025-10-15,2025-12-31,500

Multi-client batch (prepend client_ref)

client_ref,business_name,street,city,postal,country,keywords,text,category,radius_minutes,mode,planner_closed_hours,open_hours,start_date,end_date,daily_budget_cents
cafe-alpha,Sample Bakery,12 Bread St,Berlin,10115,DE,"bakery,bread","Fresh bread daily",Food,10,walk,true,"Mo-Fr 07:00-18:00; Sa 08:00-16:00",2025-10-15,2025-12-31,500

Upload → Dry-Run → Fix (errors.txt) → Apply → Preview-as-shown → Fund wallet.

11) Billing — Top-ups & Final-Sale

Checkout-first to create account.
Top-ups — add funds anytime; unused balances roll forward.
Low-fund warnings — banners at account/client/org scopes.
Final-sale policy — charges are final; verified billing errors are credited as ad credits.
Chargebacks — delivery pauses until a valid payment method is added.

12) Policies — Content Standards

Text-only — no images, no emojis, no phone numbers.
Adult retail shops — allowed where lawful; include “18+”.
Accuracy — hours/prices must be real; do not claim exact user distance.
Prohibited — illegal goods/services, hate speech, impersonation.

Enforcement

Hard keywords: block known illegal/hate terms (exact/phrase).
Category rules: allow Adult Retail (18+); block sexual services, weapons, etc.
Pattern rules: strip/block phone numbers, excessive punctuation, misleading “FREE”.
Quarantine: suspicious ads pause for review; invalid clicks auto-credit nightly.

Keyword blocking alone can over-block. We combine category context and patterns to avoid false positives.