Outbrain Amplify

Outbrain Amplify is a comprehensive native advertising platform that helps marketers reach engaged audiences through content discovery and native advertising solutions, providing advanced campaign management, performance analytics, and audience targeting capabilities.

Power end-to-end data operations for your Outbrain Amplify API with Nexla. Our bi-directional Outbrain Amplify connector is purpose-built for Outbrain Amplify, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Outbrain Amplify or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Outbrain Amplify workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating an Outbrain Amplify credential, you need to identify your API server URL and obtain your Outbrain username and password. Outbrain Amplify uses token-based authentication, where your username and password are used to obtain an API token that is then used for all subsequent API requests.

To obtain your Outbrain Amplify credentials, follow these steps:

1. Sign in to your Outbrain Amplify account using your Outbrain account credentials.

2. Navigate to your Outbrain Amplify dashboard or account settings in the Outbrain interface.

3. Identify your API server URL. The default API server URL for Outbrain Amplify is https://api.outbrain.com/amplify/v0.1. This URL is used for all API requests to the Outbrain Amplify API.

4. Your Outbrain username is the username you use to sign in to your Outbrain Amplify account. This username is used to authenticate with the Outbrain Amplify API and obtain an API token.

5. Your Outbrain password is the password associated with your Outbrain Amplify account. This password is used along with your username to authenticate with the Outbrain Amplify API and obtain an API token.

6. Store all credentials securely, as you will need them to configure your Nexla credential. The username and password are sensitive information and should be kept confidential.

The username and password are used to authenticate with the Outbrain Amplify API login endpoint (/login) to obtain an API token. The API token is then sent in the Authorization header with the Bearer prefix for all subsequent API requests. The API token is automatically obtained and refreshed by Nexla as needed. If your credentials are compromised, you should immediately change your password in your Outbrain account settings. For detailed information about Outbrain Amplify authentication, API access, and available endpoints, refer to the Outbrain Amplify API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
API Server URL	Yes	No	Enter the API server URL for Outbrain Amplify API.
Outbrain Username	Yes	No	Enter your Outbrain username. This is used to fetch an API token.
Outbrain Password	Yes	Yes	Enter your Outbrain password. This is used to fetch an API token.

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Outbrain Amplify

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. Enter your Outbrain Amplify API server URL in the API Server URL field. The default API server URL is https://api.outbrain.com/amplify/v0.1. This URL is used for all API requests to the Outbrain Amplify API, including the login endpoint for token authentication.

4. Enter your Outbrain username in the Outbrain Username field. This is the username you use to sign in to your Outbrain Amplify account. The username is used along with your password to authenticate with the Outbrain Amplify API login endpoint and obtain an API token.

5. Enter your Outbrain password in the Outbrain Password field. This is the password associated with your Outbrain Amplify account. The password is used along with your username to authenticate with the Outbrain Amplify API login endpoint and obtain an API token. The password is sensitive information and must be kept confidential.

   Your Outbrain Amplify credentials can be found in your Outbrain Amplify account. The username and password are used to authenticate with the Outbrain Amplify API login endpoint (/login) to obtain an API token. The API token is then automatically sent in the Authorization: Bearer {token} header for all subsequent API requests to the Outbrain Amplify API.

   The API token is automatically obtained and refreshed by Nexla as needed. If your credentials are compromised, you should immediately change your password in your Outbrain account settings. The username and password provide access to your Outbrain Amplify account data and should be treated as sensitive information. Keep your credentials secure and do not share them publicly.

   For detailed information about Outbrain Amplify authentication, API access, and available endpoints, see the Outbrain Amplify API documentation.

6. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Outbrain Amplify connector tile, then select the credential that will be used to connect to your Outbrain Amplify account, and click Next; or, create a new Outbrain Amplify credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Outbrain Amplify endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Fetch Marketers

This endpoint template retrieves all marketers associated with the current user from your Outbrain Amplify account. Use this template when you need to retrieve information about marketers, including marketer IDs, names, and configurations.

• This endpoint automatically retrieves all marketers associated with the current user. No additional configuration is required beyond selecting this endpoint template.

This endpoint retrieves all marketers associated with the current user from your Outbrain Amplify account, including marketer IDs, names, and other marketer metadata. Use this endpoint to discover which marketers are available in your Outbrain Amplify account before using them with other Outbrain Amplify endpoints.

For detailed information about marketer management, API response structures, and available marketer data, see the Outbrain Amplify API documentation.

Fetch Campaigns for a Marketer

This endpoint template retrieves all campaigns for a specific marketer from your Outbrain Amplify account. Use this template when you need to retrieve information about campaigns, including campaign IDs, names, and configurations for a specific marketer.

• Enter the marketer ID in the Marketer ID field. This should be the unique identifier of the marketer whose campaigns you wish to fetch. The marketer ID determines which marketer's campaigns will be retrieved. You can find the marketer ID by using the "Fetch Marketers" endpoint.

This endpoint retrieves all campaigns for a specific marketer from your Outbrain Amplify account. The endpoint uses offset-based pagination with limit and offset parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the offset. The endpoint returns up to 10 campaigns per page by default.

For detailed information about campaign management, API response structures, pagination, and available campaign data, see the Outbrain Amplify API documentation.

Fetch Campaigns with Performance Stats

This endpoint template retrieves all campaigns and campaign performance statistics for a specific marketer from your Outbrain Amplify account. Use this template when you need to retrieve campaign data along with performance metrics, including impressions, clicks, conversions, and other performance statistics.

• Enter the marketer ID in the Marketer ID field. This should be the unique identifier of the marketer whose campaign stats you wish to fetch. The marketer ID determines which marketer's campaign performance statistics will be retrieved.
• Enter the start date in the Start Date (YYYY-MM-dd) field. This should be the start day for performance stats (e.g., 2024-01-01). You can use Nexla date-time macros like {now}, {now - 1}, etc. The start date determines the beginning of the date range for which performance statistics will be retrieved.
• Enter the end date in the End Date (YYYY-MM-dd) field. This should be the end day for performance stats (e.g., 2024-01-31). You can use Nexla date-time macros like {now}, {now - 1}, etc. The end date determines the end of the date range for which performance statistics will be retrieved.

This endpoint retrieves all campaigns and campaign performance statistics for a specific marketer from your Outbrain Amplify account. The endpoint uses offset-based pagination with limit and offset parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the offset. The endpoint returns up to 10 campaigns per page by default.

The performance statistics include metrics such as impressions, clicks, conversions, spend, and other campaign performance data. For detailed information about performance reporting, API response structures, pagination, and available performance metrics, see the Outbrain Amplify API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Outbrain Amplify data sources can also be manually configured to ingest data from any valid Outbrain Amplify API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Outbrain Amplify API typically uses the GET method for retrieving data. For the Response Data Path, use $.marketers[*] to extract all marketers, or $.campaigns[*] to extract all campaigns, depending on your endpoint. The API uses offset-based pagination with limit and offset parameters for most endpoints.

Once all of the relevant settings have been configured, click the Next button to proceed with the rest of the data flow configuration, or click Save to save the data source configuration for later use.

Use as a destination

Click the + icon on the Nexset that will be sent to the Outbrain Amplify destination, and select the Send to Destination option from the menu. Select the Outbrain Amplify connector from the list of available destination connectors, then select the credential that will be used to connect to your Outbrain Amplify account, and click Next; or, create a new Outbrain Amplify credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Outbrain Amplify endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

Create Conversion Events in Table

This endpoint template creates conversion events for a marketer from records in a Nexset. Use this template when you need to create conversion events in Outbrain Amplify for tracking conversions, attributing conversions to campaigns, or other conversion tracking purposes. Please check the API documentation link for all required properties in the Nexset record.

• Enter the marketer ID in the Marketer ID field. This should be the unique identifier of the marketer for which you want to create conversion events. The marketer ID determines which marketer will receive the conversion events. You can find the marketer ID by using the "Fetch Marketers" endpoint.

This endpoint sends data as JSON in the request body to create conversion events for a marketer in your Outbrain Amplify account. Each record from your Nexset will be sent as a separate API request to create a new conversion event in Outbrain Amplify. The request body should contain the conversion event data in the format required by the Outbrain Amplify API.

The conversion event structure must match the Outbrain Amplify API's expected format. Please check the API documentation link for all required properties in the Nexset record. For detailed information about conversion event creation, request body formats, available event properties, and required record structures, see the Outbrain Amplify API documentation.

Manual configuration

Outbrain Amplify destinations can also be manually configured to send data to any valid Outbrain Amplify API endpoint, including endpoints not covered by the pre-built templates or when you need custom API configurations. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

Outbrain Amplify API typically uses the POST method for creating resources, and expects JSON format for all requests. The request body format is typically {message.json} to send the entire Nexset data as JSON, with field names matching the Outbrain Amplify API's expected structure. Using manual configuration, you can also configure Nexla to automatically send the response received from the Outbrain Amplify API after each call to a new Nexla webhook data source.

Save & activate

Once all endpoint settings have been configured, click the Next button to proceed with the rest of the data flow configuration, or click Save to save the destination configuration for later use. To send the data to the configured Outbrain Amplify endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the Outbrain Amplify endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.