Skip to main content
Estimated setup time: 30-45 minutes
This guide is for Adobe Campaign Classic (ACC) using the Message Center module. For Adobe Campaign Standard (ACS), see Adobe Campaign Integration.

Connection Requirements

Aampe connects to ACC Message Center via the SOAP API (PushEvent method).

Required from Customer

RequirementDescription
Message Center URLExecution instance URL (e.g., https://mc.customer.campaign.adobe.com)
API User CredentialsUsername and password for Message Center access
Whitelisted IPsAampe IPs must be added to trusted IP addresses
Unsubscribe Endpoint URLYour unsubscribe endpoint that supports One-Click List-Unsubscribe
Contact your Aampe representative to receive the list of IP addresses that need to be whitelisted.

Locate Your Message Center URL

  1. Log in to Adobe Campaign Classic console
  2. Navigate to AdministrationPlatformExternal accounts
  3. Find the Message Center execution instance account
  4. Copy the Server URL

Unsubscribe Endpoint Requirements

Your unsubscribe endpoint must:
  • Accept POST requests (for One-Click List-Unsubscribe from Gmail/Yahoo)
  • Accept a user identifier parameter that Aampe will populate per message
  • Return HTTP 200 on successful unsubscribe
Provide Aampe with:
  • Base URL: e.g., https://yourcompany.com/unsubscribe
  • Parameter name: e.g., uid, token, or email
Aampe will construct the full URL per message: https://yourcompany.com/unsubscribe?uid={user_identifier}

Email Channel Setup

Step 1: Create Event Type

  1. Navigate to AdministrationPlatformEnumerations
  2. Find Event type (eventType) enumeration
  3. Click Add to create a new value:
    • Name: aampe_email
    • Label: Aampe Email

Step 2: Create Message Template

  1. Navigate to Message CenterTransactional message templates
  2. Right-click and select New
  3. Select Email delivery as the template type
  4. Configure template properties:
    • Label: Aampe Marketing Email
    • Internal name: aampe_email
    • Event type: Select aampe_email from dropdown

Step 3: Configure Sender Details

In the template’s From section, configure sender to use Aampe payload:
FieldValue
From email<%= rtEvent.ctx.fromEmail %>
From name<%= rtEvent.ctx.fromName %>

Step 4: Configure Email Content

Aampe sends complete HTML content in the API payload. Configure your template as a passthrough: Subject Line:
<%= rtEvent.ctx.subject %>
HTML Content (Source tab):
<%= rtEvent.ctx.body %>
Do not add any additional HTML structure. Aampe provides the complete email content including all styling and layout.

Step 5: Configure SMTP Headers for Unsubscribe

This step is required for email deliverability compliance (Gmail/Yahoo One-Click Unsubscribe).
  1. Open template properties (click Properties button)
  2. Go to SMTP tab
  3. In Additional SMTP headers, add:
List-Unsubscribe: <<%= rtEvent.ctx.unsubscribeUrl %>>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

Step 6: Publish Template

  1. Click Publish in the template toolbar
  2. Select target execution instance(s)
  3. Confirm publication
Your email template is now ready. Aampe will send events to trigger personalized emails.

Push Notification Channel Setup

Step 1: Create Event Type for Push

  1. Navigate to AdministrationPlatformEnumerations
  2. Find Event type (eventType) enumeration
  3. Click Add to create a new value:
    • Name: aampe_push
    • Label: Aampe Push

Step 2: Verify Mobile App Channel

Push notifications require the Mobile App Channel package to be installed on your ACC instance. Contact your Adobe administrator if not available.
Verify your mobile app is configured:
  1. Navigate to AdministrationChannelsMobile app
  2. Confirm your iOS/Android apps are registered

Step 3: Create Push Message Template

  1. Navigate to Message CenterTransactional message templates
  2. Right-click and select New
  3. Select Mobile delivery (Push notification) as the template type
  4. Configure template properties:
    • Label: Aampe Push Notification
    • Internal name: aampe_push
    • Event type: Select aampe_push from dropdown

Step 4: Configure Push Content

Configure push content fields to use Aampe payload:
FieldValue
Title<%= rtEvent.ctx.title %>
Body<%= rtEvent.ctx.body %>
Deep link / URL<%= rtEvent.ctx.link %>
Image URL (iOS/Android)<%= rtEvent.ctx.imageUrl %>
In iOS-specific settings:
  • Alert title: <%= rtEvent.ctx.title %>
  • Alert body: <%= rtEvent.ctx.body %>
  • Media URL: <%= rtEvent.ctx.imageUrl %>

Step 5: Publish Template

  1. Click Publish in the template toolbar
  2. Select target execution instance(s)
  3. Confirm publication
Your push notification template is now ready.

/\

Field Reference

Email Payload Fields

Aampe sends these fields in the ctx element:
FieldTypeDescription
fromEmailStringSender email address
fromNameStringSender display name
subjectStringEmail subject line
bodyStringComplete HTML email content
unsubscribeUrlStringFull unsubscribe URL with user identifier

Push Payload Fields

FieldTypeDescription
titleStringPush notification title
bodyStringPush notification body text
linkStringDeep link or URL to open
imageUrlStringRich media image URL

Validation Checklist

Before going live, verify with your Aampe representative:
  • API Connectivity - Aampe can successfully authenticate to your Message Center instance
  • Test Email - Send a test email and verify sender name/email, content rendering, subject line, unsubscribe header presence (check raw email headers), and link tracking
  • Test Push - Send a test push notification and verify title/body text, deep link opens the correct screen, and image loads (if using rich push)
  • Test Unsubscribe - Click the unsubscribe link and verify your endpoint receives the request and the user is successfully unsubscribed in your system

Official Documentation

For more details on Adobe Campaign Classic Message Center: