Campaigns
Create and manage promotion campaigns.
Applies to Appylar v1.0
A campaign promotes one of your apps. Creating one is deliberately simple: the only choice that matters is which app to promote — everything else has a sensible default. You manage campaigns entirely from the portal; no admin involvement is needed.
#Where your ad shows
A campaign either promotes across your own apps only, or across your apps and the wider Appylar network. This is the reach_type field.
| Choice | reach_type | Serves in | Cost |
|---|---|---|---|
| Your apps and the network | network | Your own apps and other studios' apps | Your own apps free; network reach is funded from your plan |
| Just my own apps | portfolio | Only your own apps | Free |
- Just my own apps cross-promotes between titles you already own — e.g. sending players of one game to another. Always free.
- Your apps and the network does everything the above does and reaches people in other developers' apps. Your own apps are still served for free; only reach beyond them draws on your plan.
Network reach also needs your organization to participate in the exchange (Network Exchange in Settings, off by default) and available funds. Until then, a network campaign simply behaves like a portfolio one — it keeps promoting across your own apps and starts reaching the network once you're set up. Nothing breaks in the meantime.
#Advanced options
These are optional and hidden behind Advanced in the form — most campaigns never need them.
#Campaign name
Just a label for your own reference. If you leave it blank it defaults to the app's name (e.g. Promote Space Dash).
#Frequency limit
frequency_cap_per_day — show your ad to the same person at most this many times per day (1–1000). Leave it empty for no limit. A sensible limit avoids fatigue and spreads impressions across more people.
#Countries
target_geo restricts serving to specific countries — a list of ISO-3166-1 alpha-2 codes (US, GB, DE, …). Leave it empty to reach everywhere. The viewer's country is determined at the edge from their connection, so no SDK changes are needed.
US, GB, DE
#Status: draft, active, paused
A campaign moves through three states:
| Status | Meaning |
|---|---|
| draft | Just created; not serving |
| active | Eligible to serve (needs an approved creative) |
| paused | Temporarily stopped; not serving |
- Activate a draft or paused campaign to make it eligible to serve.
- Pause an active campaign to stop it at any time.
- Delete is only allowed when a campaign is not active — pause it first.
Activating a campaign is necessary but not sufficient. It only serves once its creative is approved and — for network reach — your organization has funds and participates in the exchange.
#Create a campaign via the API
curl -X POST https://api.appylar.com/v1/campaigns \
-H "Authorization: Bearer <token>" -H "Accept: application/json" \
-d "name=Promote Space Dash&promoted_app_id=1&reach_type=network&frequency_cap_per_day=3" \
--data-urlencode "target_geo[0]=US" \
--data-urlencode "target_geo[1]=GB"
Only name, promoted_app_id and reach_type are needed; frequency_cap_per_day and target_geo are optional. See the REST API for the full request and response.