Magellan AI is a platform that provides detailed advertising insights and competitive intelligence for podcasts. It leverages a proprietary machine-learning algorithm to analyze podcast advertising data, offering insights into ad spend, advertisers, and ad creatives. The platform helps marketers and brands understand the podcast advertising landscape, track competitors, and make data-driven decisions to optimize their podcast ad strategies. By monitoring over 30,000 podcasts, Magellan AI delivers comprehensive analytics and trend reports to its users.
Product Type: Advertising
Integration Type: Starter Kit
Event Source Type: Web
Event Scope: Full-Funnel Events
- Server-Side Integration via MetaRouter: Implement Magellan AI's SDK and events processes through MetaRouter for seamless data integration.
- Ad Performance Optimization: Use server-side data via MetaRouter to track and optimize ad campaign performance, which also supports media planning, market research, budget allocation, trend analysis, and strategic decision-making.
- Campaign Reporting: Generate detailed reports in Magellan AI on ad campaign effectiveness using server-side data collected through MetaRouter.
- The IP address and user agent are sent to Magellan AI via connection headers (
X-Forwarded-For and User-Agent) rather than as mapped event parameters.
- This server-side implementation focuses on advertiser-side data. If you are a publisher and need to pass listener metrics such as plays, skips, etc., please contact your MetaRouter support team for assistance.
- Contact your Magellan AI support team to obtain your Pixel Token.
- From the integration library, add a Magellan AI integration. Then, fill out the Connection Parameters:
| Connection Parameter | Description |
|---|
TOKEN | Your advertiser's pixel token. |
- MetaRouter provides all of the event mappings that Magellan AI integrations typically require. You may add custom events, parameters, or mappings in accordance with Magellan AI's API documentation.
- In the Pipelines tab, add your Magellan AI integration.
- Select the correct integration revision.
- Click Add Integration to finalize deployment.
Global mappings will be applied to all events. If your parameter names do not match the Expected Inputs provided, you will need to overwrite the Inputs provided with your own.
| Output Key | Description | Expected Input |
|---|
referrer | String: The URL of the referrer page. | context.page.referrer |
token Required | String: Pixel token. | $$TOKEN$$ |
| Output Key | Description | Expected Input |
|---|
userId Required | String: User ID or hashed email. | Expression – returns hashed traits.email when present, otherwise userId |
event Required | String: Event type (identify). | Enrichment – 'identify' |
| Output Key | Description | Expected Input |
|---|
url Required | String: URL of the page viewed. | context.page.url |
event Required | String: Event type (page view). | Enrichment – 'view' |
| Output Key | Description | Expected Input |
|---|
productId | String: Product ID. | properties.product_id |
productName | String: Product name. | properties.name |
productType | String: Product category. | properties.category |
productVendor | String: Product brand. | properties.brand |
value Required | Number: Product price. | properties.price |
currency Required | String: Currency used. | properties.currency (uppercased, default USD) |
variantName | String: Product variant. | properties.variant |
event Required | String: Event type (product view). | Enrichment – 'product' |
| Output Key | Description | Expected Input |
|---|
productId | String: Product ID. | properties.product_id |
productName | String: Product name. | properties.name |
productType | String: Product category. | properties.category |
productVendor | String: Product brand. | properties.brand |
value Required | Number: Total product value. | Expression – price × quantity |
quantity Required | Number: Product quantity. | properties.quantity |
currency Required | String: Currency used. | properties.currency (uppercased, default USD) |
variantName | String: Product variant. | properties.variant |
event Required | String: Event type (add to cart). | Enrichment – 'add_to_cart' |
| Output Key | Description | Expected Input |
|---|
value Required | Number: Total checkout value. | Expression – sums price × quantity across properties.products |
quantity | Number: Total product quantity. | Expression – sums quantity across properties.products |
currency Required | String: Currency used. | properties.currency (uppercased, default USD) |
discountCode | String: Discount code applied. | properties.coupon |
id Required | String: Checkout session ID. | properties.order_id |
lineItems | Array: Builds a list of products in the checkout, each with product ID, name, type, vendor, variant, and quantity. | Expression – maps properties.products to line items |
event Required | String: Event type (checkout). | Enrichment – 'checkout' |
| Output Key | Description | Expected Input |
|---|
code Required | String: Coupon code. | properties.coupon_id |
event Required | String: Event type (coupon code). | Enrichment – 'code' |
type Required | String: Event type (coupon). | Enrichment – 'coupon' |
| Output Key | Description | Expected Input |
|---|
value Required | Number: Total order value. | Expression – sums price × quantity across properties.products |
quantity | Number: Total product quantity. | Expression – sums quantity across properties.products |
currency Required | String: Currency used. | properties.currency (uppercased, default USD) |
discountCode | String: Discount code applied. | properties.coupon |
id Required | String: Order ID. | properties.order_id |
lineItems | Array: Builds a list of products in the order, each with product ID, name, type, vendor, variant, and quantity. | Expression – maps properties.products to line items |
event Required | String: Event type (purchase). | Enrichment – 'purchase' |
These identifiers must be mapped to Magellan AI in order for successful user matching to occur. Without these IDs, any events sent to Magellan AI may not be accurately reflected in reporting. For your convenience, required and recommended IDs are mapped as Global parameters to ensure they are added to every event.
| Attribute | Example | Sync Injector Required? |
|---|
ip Required | 192.168.1.1 | No |
user_agent Required | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36 | No |
userId * Required | user123 | No |
email_sha256 * | 9b74c9897bac770ffc029102a200c5de8aabc7c6d3f6e4c3c885aab8c9267d41 | No |
*MetaRouter checks for an email in input.traits.email. If an email is found, it is lowercased, trimmed, and hashed with SHA-256. If no email is found, it returns the input.userId.
Coordinate with your Magellan AI representative to confirm that events are being received and processed correctly on their backend.
