FAQ
Answers to common questions.
Applies to Appylar v1.0
Straight answers to the questions developers actually ask when integrating Appylar. If your question is a problem you're hitting, check Troubleshooting too.
#Getting started
What is Appylar? A cross-promotion network for mobile apps. You show other developers' ads in your app, and your app gets promoted in theirs. See Getting Started.
Is it really free? Portfolio cross-promotion — promoting your own apps inside your own apps — is free. Showing network ads in your app is free. Only network reach is paid, funded by your plan's monthly allowance: one impression per served network impression.
Which platforms are supported? Three things are easy to conflate, so to be precise:
- SDKs you integrate: native Android and iOS SDKs plus a Flutter SDK — all at v1.0.0 and live today. React Native and Unity are on the roadmap, not available yet.
- Stores you can list: Google Play and the Apple App Store. An app can list both (add more as you publish); Appylar routes each ad click to the store matching the viewer's device. More stores (Amazon, Huawei, …) can be added over time.
- How your app is built (native, Flutter, …) isn't something you register — the one app key works the same regardless.
How fast can I be live? About five minutes to integrate and create a campaign. The one wait is moderation — a creative must be approved before it serves.
#SDK
Where do I get my app key?
Register an app in the portal (Apps → New app). You get an app_live_… key you pass to initialize.
What ad formats are supported? Banner and interstitial. There's no rewarded or native format in v1.
Does the SDK show a consent dialog?
No. You collect consent with your own CMP and pass the result to setConsent(...). See Android / iOS.
What OS versions are required? Android 7.0 (API 24) and up; iOS 15.0 and up.
What does NO_FILL mean?
There's no eligible ad to show right now. It's expected and not an error — just don't display an ad.
Can I test without real ads?
Yes. Initialize with testMode = true (Android) / testMode: true (iOS) to use the sandbox and get deterministic test ads.
Does the SDK track installs automatically?
Yes. Install tracking is automatic after initialize, and queued events survive process death.
Do I need to add any permissions or Info.plist keys?
On Android the SDK merges INTERNET and ACCESS_NETWORK_STATE for you. On iOS no Info.plist changes are required in v1.
#Campaigns & creatives
What's the difference between Portfolio and Network? Portfolio serves only inside your own apps and is free. Network serves across the wider network and draws on your plan's monthly impression allowance. See Campaigns.
What image formats and sizes can I upload? JPEG, PNG, WebP or GIF, up to 5 MB. Appylar generates the banner (320×50) and interstitial (320×480) variants from your source image. See Creatives.
How long does moderation take? Moderation is manual during the design-partner phase, so it isn't instant. A pending creative never serves live.
Can I change a creative after uploading? Yes — upload a new image. It replaces the old one and goes back through moderation.
Why isn't my campaign serving? It needs an approved creative, an active status, and — for network reach — available allowance or top-up. See Troubleshooting.
#Billing
How does network reach get paid for? Through your plan. Each plan includes a monthly impression allowance (one network impression = one unit) that renews each cycle and doesn't roll over. Serving draws from your allowance first, then from any one-off top-ups. Portfolio serving and showing others' ads are free. See Billing.
What happens when I run out? When your allowance and top-up balance are both empty, network serving pauses automatically until your allowance renews or you top up. Portfolio campaigns keep serving, and nothing is deleted.
How do I subscribe or top up? On the Billing page, choose a plan to subscribe, or pick a top-up pack for a one-off burst. You complete payment on a secure hosted checkout.
#Account
Can I invite team members? Not in v1 — there are no teams or roles yet. One account maps to one organization.
Is there an API? Yes. Everything the portal does is available through the REST API.