Documentation

Getting started with MailAdx

From empty network to first open-time ad impression.

1. Create your account

Sign up as a Publisher, Advertiser or Agency. You land in the dashboard straight away in sandbox mode: you can set everything up while you verify your email and our team reviews the account. Going live — topping up a wallet, activating campaigns, serving ads on your newsletter — unlocks once the account is approved.

2. Publishers: put an ad slot in your newsletter

  1. Complete your profile under Account — website, newsletter size, subscriber count, sending frequency, average open rate and ESP. Advertisers browsing the publisher directory see these.
  2. Create an ad unit under Inventory → Ad Units: a placement key (for example header), allowed formats and sizes, and an optional floor CPM.
  3. Copy the ad tag from Delivery → Ad Tags and paste it into an HTML block in your ESP template. Replace every {{EMAIL_SHA256}} placeholder with your ESP's value for the subscriber — the SHA-256 of the lower-cased email address. Some ESPs compute it at send time (Klaviyo, beehiiv, Brevo); others read it from a custom field you keep filled (Mailchimp, Kit). See the integration guide for your ESP.
  4. Send yourself a test and open it in an inbox that loads images. Then check Delivery → Tag Health: it lists every ad request your newsletter sent and how each one ended — an ad shown, no campaign available, or a tag problem with the fix.

There is no publish step: changes reach the ad server automatically within seconds. Direct-sold sponsors you sell yourself go in under Demand → Orders; their impressions are charged a flat serving fee from your wallet (Billing).

3. Advertisers: launch a campaign

  1. Add credits under Portals → Wallet (minimum $100, USD, 18% GST added at checkout).
  2. Create an order under Demand → Orders, then a line item with its price, flight dates, targeting (geography, device, OS, language, ad units, audience segments), frequency cap and pacing.
  3. Upload the creative under Demand → Creatives. Every creative is reviewed before it can serve.
  4. Watch delivery under Delivery → Reports once the creative is approved and the line item is active.

4. Check the numbers

An impression is counted when a subscriber opens the email and the ad image is delivered — never for unopened sends. Reports show impressions, clicks and CTR; Apple Mail privacy pre-fetches are labelled AppleMPP. Details: Impression and Click Tracking and Reporting.