What Is Magellan AI?

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.

What are the benefits of integrating MetaRouter with Magellan AI?

Enhanced Data Accuracy: Server-side integration via MetaRouter ensures that all events and parameters are delivered accurately and in real-time, minimizing data discrepancies and improving the reliability of insights provided by Magellan AI.
Comprehensive Tracking: By funneling all relevant data points through MetaRouter, users can achieve a more holistic view of their podcast advertising metrics, enhancing the granularity and depth of competitive intelligence and ad performance analysis.
Streamlined Data Management: MetaRouter's capability to centralize and streamline data delivery reduces the complexity of managing multiple data sources, allowing for a more efficient and scalable integration process with Magellan AI.

Capabilities and Considerations

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.

Limitations

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.

Getting Started - From Your Magellan AI Account

Grab a Token: Contact your Magellan AI support team ([email protected]) to obtain your Pixel Token.

Getting Started - From Your MetaRouter Account

Adding a Magellan AI integration.

From the integration library, add a Magellan AI integration. Then, fill out the Connection Parameters:

Connection Parameter	Description
`TOKEN`	Your advertiser’s pixel token.

Event Mappings

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.

Global

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.	Enrichment - `TOKEN`

Event Specific

Identify

Output Key	Description	Expected Input
`userId` Required	String: User ID or hashed email	N/A - Expression
`event` Required	String: Event type (identify)	Enrichment - `identify`

Page

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`

Product Viewed

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`
`variantName`	String: Product variant	`properties.variant`
`event` Required	String: Event type (product view)	Enrichment - `product`

Product Added

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	N/A - Expression
`quantity` Required	Number: Product quantity	`properties.quantity`
`currency` Required	String: Currency used	`properties.currency`
`variantName`	String: Product variant	`properties.variant`
`event` Required	String: Event type (add to cart)	Enrichment - `add_to_cart`

Checkout Started

Output Key	Description	Expected Input
`value` Required	Number: Total checkout value	N/A - Expression
`quantity`	Number: Total product quantity	N/A - Expression
`currency` Required	String: Currency used	`properties.currency`
`discountCode`	String: Discount code applied	`properties.coupon`
`id` Required	String: Checkout session ID	`properties.order_id`
`lineItems`	Array: List of products in checkout	N/A - Expression
`event` Required	String: Event type (checkout)	Enrichment - `checkout`

Coupon Entered

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`

Order Completed

Output Key	Description	Expected Input
`value` Required	Number: Total order value	N/A - Expression
`quantity`	Number: Total product quantity	N/A - Expression
`currency` Required	String: Currency used	`properties.currency`
`discountCode`	String: Discount code applied	`properties.coupon`
`id` Required	String: Order ID	`properties.order_id`
`lineItems`	Array: List of products in the order	N/A - Expression
`event` Required	String: Event type (purchase)	Enrichment - `purchase`

Required & Recommended Identifiers

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
user ID* Required	user123	No
SHA-256 hashed email*	9b74c9897bac770ffc029102a200c5de8aabc7c6d3f6e4c3c885aab8c9267d41	No

*MetaRouter checks for an email in either input.traits.email or input.context.traits.email. If an email is found, it converts it to lowercase, trims any spaces, and hashes it using SHA-256. If no email is found, it returns the input.userId.

Additional Magellan AI Documentation

Pixel SDK

Conversion Events