Add documentation for Magellan AI (Actions) Destination

[leboshi]

Proposed changes

• Add documentation for new action destination to connect Segment with Magellan AI's measurement and attribution platform (more info).

Merge timing

Pending approval of the actual action destination PR

Notes

Documentation contains a comment at the end about important notes for three action mappings:

• The Magellan AI API spec requires a user agent for the Install and Third-party event mobile app actions, but the Segment iOS library does not provide this in the event context. Alternatives are suggested.
• There isn't a clear 1:1 between the Segment Signed Up B2B SaaS event and our Lead action, which is more of an e-commerce action but doesn't directly correlate with any of the Segment spec e-commerce events, so mapping suggestions are provided.

Thank you, and let us know what next steps you need from us!

[tcgilbert]

in addition to the requested change you will need to change the folder name from actions-magellan-ai to magellan-ai as this is the slug of your integration

[leboshi]

Great! Moved the slug, and committed the ID metadata. Thanks!

[forstisabella]

a few changes from me and we'll be ready to ship this! 🚀

[leboshi]

Thank you for the thorough pass! Y'all are incredible. Also updated the actual job title, to appease The People Upstairs when I asked about the capitalization.

[forstisabella]

sweet!! Thanks so much for giving this PR so much thought. We're good to go, but I'll hold this until the corresponding PR in the action-destination repo is complete!

[leboshi]

Hey @forstisabella! The destination PR has been approved and deployed. However, I just noticed that both the reviewer and I missed that our slug is still actions-magellan-ai instead of magellan-ai in the metadata for the destination, per @tcgilbert's request above. Soooooo there may already be a fix PR going up, as well, but the destination does indeed exist now! 🙈

[leboshi]

OK, the contribution guide says

Do not change the name or slug of your Integration after the Integration has been deployed.

So I guess we're actions-magellan-ai now! Reverted the previous directory rename to match the slug.

[forstisabella]

hi @leboshi - sweet, thanks for the update! I'll merge this docs PR and check after tomorrow's deploy that the link resolves as it should. If it doesn't, I can open a PR for a redirect. thanks for all of your work on these docs!

[github-actions]

Thank you for your contribution! Your pull request is merged, but may take a day or two to appear on the site.