MiniAd Documentation
A practical guide to placing ads on your site, launching campaigns, billing, and reporting.
Where does
YOUR_SLOT_ID come from? Sign in and open Publisher Sites, create a site and placement, wait for both approvals, then copy the complete generated code from that placement's Embed column. Do not replace or guess YOUR_SLOT_ID manually.Platform profit and publisher share policy
- Seventy percent of eligible paid delivery spend accrues to the publisher. Thirty percent is platform revenue for technology, review, traffic protection, payments, and operations.
- Refunded, invalid or repeated clicks, violating campaigns, and traffic in validation are not payable. Earnings become requestable after a 30-day validation period.
- Once available earnings reach NT$1,000, request payment in Publisher Sites. An administrator records the payment reference after payment; this release uses manual payment and does not store bank account details.
Before you start
One MiniAd account can be both an advertiser and a publisher. Publishers provide sites and placements; advertisers create campaigns and select approved placements. Sites, placements, and paid campaigns are manually reviewed. New accounts receive a one-time NT$1,000 advertising reward that can only fund campaigns.
Before advertising, prepare your destination URL, exact creative sizes, and budget. Before publishing, make sure you control the registered site and can add a script to its page source or CMS HTML block.
1. Place MiniAd ads on your website
- Open Publisher Sites after signing in. Enter a site name and domain, such as
example.com. Do not includehttps://or an individual page path. - Wait for the site review. You cannot create deliverable placements while the site is pending. If it is rejected, correct the stated issue and submit it again.
- Create a placement. Choose an approved site, set an internal name, a unique placement code, and fixed width and height. Typical sizes include 300×250, 728×90, and 320×100. Match the dimensions to the space reserved in your page.
- Wait for placement approval and floors. After approval, MiniAd shows CPM/CPC floors and an embed code. Pending placements do not receive ads.
- Paste the embed code into the intended page location. Use an article body, sidebar, or custom HTML component in your CMS.
2. Embed code, containers, and responsive sizing
Always use the code next to the approved placement in Publisher Sites. The structure below is illustrative; use the platform-generated YOUR_SLOT_ID, container id, and dimensions:
<div id="mini-ad-homepage_top" style="max-width: 728px"></div>
<script
src="https://miniad.otus.tw/serve/YOUR_SLOT_ID.js"
data-mini-ad-target="#mini-ad-homepage_top"
data-mini-ad-width="100%"
async>
</script>- Placement: the div is the ad container and the script belongs immediately after it. Use one placement script per location; do not copy the same one into several places.
- Resizing: set the container
max-widthto the placement's original width.data-mini-ad-width="100%"scales the image proportionally in narrow columns without stretching or cropping it. - Mobile: ads shrink to fit a narrower column. For a better mobile layout, create a separate 320×100 placement and a matching location.
- Limits: MiniAd supports script embeds only, not iframes, HTML ads, or video. The embed does not set third-party cookies.
- When no paid ad is eligible: MiniAd can show a free house fallback. Paid inventory is not guaranteed on every request.
3. Create and deliver a campaign
- Check your balances. Billing top-up credit comes from ECPay. Advertising rewards come from registration or referrals. They are separate, and campaigns use rewards first.
- Open Campaigns. Select one or more approved placements, set a campaign name, CPM or CPC, bid, total budget, optional dates, and a destination URL.
- Prepare creatives for every placement size. Each selected placement needs one exactly matching image. For 728×90 and 300×250, upload two corresponding files; MiniAd never crops or distorts them.
- Submit for review. The full budget is reserved and the campaign becomes pending. It can enter the auction only after approval, during its scheduled dates, with sufficient budget and matching creatives.
- Manage delivery. Approved campaigns can be paused and resumed. To change creatives, URL, budget, or placements, cancel and create a replacement. Unspent whole-TWD budget is returned to its original funding source after rejection, cancellation, or expiry.
4. Creative and destination checklist
- Accepted formats are JPG, PNG, WebP, and GIF. Each file is limited to 5 MB and no edge can exceed 4096 px.
- You can upload up to 10 files. File names are flexible, but image pixel dimensions must exactly match every selected placement.
- The destination must be a valid HTTP or HTTPS URL and lead directly to the promoted content or product. Malicious redirects are not allowed.
- Before submission, open the destination on desktop and mobile and verify that the creative, copy, and landing content match.
5. Billing, auction, and wallet
- CPM: charges your CPM bid per 1,000 impressions. Single impressions use millicents internally to avoid rounding errors.
- CPC: charges your CPC bid only for a valid click. Repeated clicks from the same impression still open the destination but are not charged again.
- Auction: MiniAd uses first-price auctions. CPM ranks by bid; CPC uses bid and smoothed CTR to estimate eCPM. Ninety percent of traffic chooses the top eCPM; ten percent explores eligible paid campaigns.
- Wallet: ECPay increases top-up credit only. Registration and referral programs increase advertising rewards only; rewards cannot be withdrawn, transferred, or exchanged for cash. The ledger records every top-up, budget reservation, and refund.
- Referrals: share your link in Rewards. When the referred account completes its first ECPay top-up, both accounts receive NT$100 in advertising rewards.
6. Read performance reports
- Advertisers can filter impressions, valid clicks, CTR, spend, remaining budget, average CPM/CPC, and daily trends by date, campaign, and placement.
- Publishers can filter site and placement impressions, clicks, and CTR. Publisher revenue share and withdrawals are not included in this release.
- Select Export CSV to download the current filters as UTF-8 CSV. Reports are limited to 365 days.
- Clicks are deduplicated with a 24-hour signed impression URL and nonce. MiniAd does not store IP addresses or browser fingerprints, so this protects a single delivered impression rather than identifying people across sites.
7. Reviews, rules, and troubleshooting
- Why is my campaign not delivering? Confirm that site, placement, and campaign are all approved; dates are active; delivery is not paused or exhausted; bids meet placement floors; and every placement has a matching creative.
- Why is my embed blank? Use the code generated after approval, keep its div id and selector identical, make sure the browser permits JavaScript, and verify the page belongs to the registered site.
- Prohibited content: unlawful, fraudulent, deceptive, malicious, infringing, hateful, harassing, explicit adult, or unauthorized data-collection content is not allowed. Do not fabricate impressions or clicks.
- Reviews and appeals: MiniAd may approve, reject with a reason, or stop violating delivery. Contact the platform administrator to replace a submitted campaign, appeal a review, or report a problem.