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
| Requirement | Description |
|---|---|
| Message Center URL | Execution instance URL (e.g., https://mc.customer.campaign.adobe.com) |
| API User Credentials | Username and password for Message Center access |
| Whitelisted IPs | Aampe IPs must be added to trusted IP addresses |
| Unsubscribe Endpoint URL | Your 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
- Log in to Adobe Campaign Classic console
- Navigate to Administration → Platform → External accounts
- Find the Message Center execution instance account
- 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
- Base URL: e.g.,
https://yourcompany.com/unsubscribe - Parameter name: e.g.,
uid,token, oremail
https://yourcompany.com/unsubscribe?uid={user_identifier}
Email Channel Setup
Step 1: Create Event Type
- Navigate to Administration → Platform → Enumerations
- Find Event type (eventType) enumeration
- Click Add to create a new value:
- Name:
aampe_email - Label:
Aampe Email
- Name:
Step 2: Create Message Template
- Navigate to Message Center → Transactional message templates
- Right-click and select New
- Select Email delivery as the template type
- Configure template properties:
- Label:
Aampe Marketing Email - Internal name:
aampe_email - Event type: Select
aampe_emailfrom dropdown
- Label:
Step 3: Configure Sender Details
In the template’s From section, configure sender to use Aampe payload:| Field | Value |
|---|---|
| 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:Step 5: Configure SMTP Headers for Unsubscribe
This step is required for email deliverability compliance (Gmail/Yahoo One-Click Unsubscribe).- Open template properties (click Properties button)
- Go to SMTP tab
- In Additional SMTP headers, add:
Step 6: Publish Template
- Click Publish in the template toolbar
- Select target execution instance(s)
- 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
- Navigate to Administration → Platform → Enumerations
- Find Event type (eventType) enumeration
- Click Add to create a new value:
- Name:
aampe_push - Label:
Aampe Push
- Name:
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.
- Navigate to Administration → Channels → Mobile app
- Confirm your iOS/Android apps are registered
Step 3: Create Push Message Template
- Navigate to Message Center → Transactional message templates
- Right-click and select New
- Select Mobile delivery (Push notification) as the template type
- Configure template properties:
- Label:
Aampe Push Notification - Internal name:
aampe_push - Event type: Select
aampe_pushfrom dropdown
- Label:
Step 4: Configure Push Content
Configure push content fields to use Aampe payload:| Field | Value |
|---|---|
| Title | <%= rtEvent.ctx.title %> |
| Body | <%= rtEvent.ctx.body %> |
| Deep link / URL | <%= rtEvent.ctx.link %> |
| Image URL (iOS/Android) | <%= rtEvent.ctx.imageUrl %> |
- iOS
- Android
In iOS-specific settings:
- Alert title:
<%= rtEvent.ctx.title %> - Alert body:
<%= rtEvent.ctx.body %> - Media URL:
<%= rtEvent.ctx.imageUrl %>
Step 5: Publish Template
- Click Publish in the template toolbar
- Select target execution instance(s)
- Confirm publication
Your push notification template is now ready.
/\
Field ReferenceEmail Payload Fields
Aampe sends these fields in thectx element:
| Field | Type | Description |
|---|---|---|
fromEmail | String | Sender email address |
fromName | String | Sender display name |
subject | String | Email subject line |
body | String | Complete HTML email content |
unsubscribeUrl | String | Full unsubscribe URL with user identifier |
Push Payload Fields
| Field | Type | Description |
|---|---|---|
title | String | Push notification title |
body | String | Push notification body text |
link | String | Deep link or URL to open |
imageUrl | String | Rich 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