adMarketplace

Send conversion events to adMarketplace for search advertising attribution and performance measurement across partner search channels.

⚠️

This integration is currently in beta. Configuration and behaviour may change.

Prerequisites

Complete these steps with adMarketplace before configuring the integration in Signal.

Create or access your adMarketplace account

Ensure you have an active adMarketplace account with advertiser access. If you don’t have an account, visit adMarketplace to get started or contact their sales team.

Get your Account ID from your adMarketplace rep

Your Account ID is provided by your adMarketplace account representative. This is the unique identifier for your advertiser account used for conversion attribution. If you don’t have it, reach out to your adMarketplace contact.

Request an API key from adMarketplace support

API keys for server-side conversion uploads are provisioned by adMarketplace support. Contact your account manager or submit a request through the adMarketplace support portal to receive your API key.

Configuration

Field	Type	Required	Description
`account_id`	string	Yes	Your adMarketplace account ID. Provided by your adMarketplace account manager.
`api_key`	secret	Yes	API key for authenticating server-side conversion uploads. Provided by your adMarketplace account manager.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find adMarketplace or filter by Advertising.
Click Install, select a variant if available, and fill in the required fields.
Click Install Integration to create the integration with a ready-to-use default configuration.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/admarketplace/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "adMarketplace",
    "variant": "default",
    "config": {
      "account_id": "amp-12345",
      "api_key": "ak_amp_abc123..."
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal Event	adMarketplace Event	Description
`purchase`	`conversion`	Completed transaction with revenue
`sign_up`	`lead`	New user registration or lead capture
`page_view`	`pageview`	Standard page view tracking
Custom events	Custom conversion	Map any Signal event to an adMarketplace conversion type via blueprint configuration

Event mappings are fully configurable through blueprints. The table above shows common default mappings — you can customise these to match your campaign goals.

Delivery

Events are delivered server-side from your Datafly Signal infrastructure directly to the adMarketplace API. No client-side scripts are loaded for this integration.

Testing

Install the integration with your Account ID and API key.
Trigger a test event (e.g. a purchase) on your site with the Datafly.js collector active.
Check the Live Events view in Signal to confirm the event was captured.
Verify the event appears in your adMarketplace reporting dashboard.
Check the Delivery Log in Signal for confirmation of successful delivery (HTTP 200 response).

⚠️

As a beta integration, please report any unexpected behaviour to both the Datafly Signal team and your adMarketplace account manager.

Troubleshooting

Issue	Resolution
`401 Unauthorized`	Verify your API key is correct. Contact your adMarketplace rep to confirm the key is still active.
`403 Forbidden`	Your account may not have API access enabled. Contact adMarketplace support to verify permissions.
Events not appearing in adMarketplace	Confirm the integration is enabled in Signal and check the Delivery Log for errors. Contact your adMarketplace rep if events are delivered successfully but not appearing in reports.
`400 Bad Request`	Check that the Account ID is in the correct format as provided by adMarketplace.

Visit adMarketplace documentation for full API documentation and credential setup instructions.

Acuity Ads Amazon DSP Events