Skip to main content

Getting Started

Quick start guide for MageAds API integration.

Prerequisites​

Before you begin:

  • Active MageAds account
  • API key (provided by MageAds team)
  • Placement codes for your ad locations
  • Technical team for integration

Configuration​

1. API Endpoint​

Main endpoint for all ad types:

POST https://delivery.mageads.com/products?pc={PLACEMENT_CODE}

2. Required Headers​

Authorization: Bearer <apikey>
Content-Type: application/json
Accept: application/json

3. Timeout Settings​

Set timeout to 400-500ms:

curl_setopt($ch, CURLOPT_TIMEOUT_MS, 500);

Integration Checklist​

  • Receive API key from MageAds
  • Receive placement codes
  • Install user tracking script
  • Implement product ad requests
  • Add display/video ad containers
  • Implement tracking pixels
  • Test in development
  • Deploy to production

Next Steps​