Skip to main content

Destination

Nexla's bi-directional connectors allow data to flow both to and from any location, making it simple to create a FlexFlow, DB-CDC, Spark ETL, or Replication data flow that sends data to a Snapchat Ads location.
snapads_api.png

Snapchat Ads

Create a Snapchat Ads Destination​

  1. Click the + icon on the Nexset that will be sent to the Snapchat Ads destination, and select the Send to Destination option from the menu.

  2. Select the Snapchat Ads connector from the list of available destination connectors. Then, select the credential that will be used to connect to your Snapchat Ads account, and click Next; or, create a new Snapchat Ads credential for use in this flow.

  3. In Nexla, Snapchat Ads destinations can be created using pre-built endpoint templates, which expedite destination setup for common Snapchat Ads endpoints. Each template is designed specifically for the corresponding Snapchat Ads endpoint, making destination configuration easy and efficient.
    • To configure this destination using a template, follow the instructions in Configure Using a Template.

    Snapchat Ads destinations can also be configured manually, allowing you to send data to Snapchat Ads endpoints not included in the pre-built templates or apply further customizations to exactly suit your needs.
    • To configure this destination manually, follow the instructions in Configure Manually.

Configure Using a Template​

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Snapchat Ads endpoints. Each template is designed specifically for the corresponding Snapchat Ads endpoint, making destination setup easy and efficient.

  • To configure this destination using a template, 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 Campaigns

    This endpoint template allows you to create campaigns in your Snapchat Ads account using records from a Nexset. Use this template when you need to automatically create campaigns based on data from your Nexla flows.

    • Enter the Ad Account ID in the Ad Account ID field. This should be the unique identifier of the ad account in which you want to create campaigns. The Ad Account ID determines which ad account will receive the new campaigns. You can find the Ad Account ID by using the "Get all Ad Accounts" data source endpoint.
    • This endpoint sends data as JSON in the request body to create new campaigns in your Snapchat Ads account. Each record from your Nexset will be sent as a separate API request to create a new campaign. The request body should contain the campaign data in the format required by the Snapchat Marketing API, including campaign name, objective, budget, and other campaign properties.

    This endpoint sends data as JSON in the request body to create new campaigns in your Snapchat Ads account. Each record from your Nexset will be sent as a separate API request to create a new campaign. The request body should contain the campaign data in the format required by the Snapchat Marketing API, including campaign name, objective, budget, schedule, and other campaign properties.

    The Ad Account ID can be found by using the "Get all Ad Accounts" data source endpoint. The campaign structure must match the Snapchat Marketing API's expected format. Please check the API documentation link for all required properties in the Nexset record.

    For detailed information about campaign creation, request body formats, and available campaign properties, see the Snapchat Marketing API documentation.

Configure Manually​

Snapchat Ads destinations can be manually configured to send data to any valid Snapchat Ads API endpoint. Manual configuration provides maximum flexibility for accessing endpoints not covered by pre-built templates or when you need custom API configurations.

Using manual configuration, you can also configure Nexla to automatically send the response received from the Snapchat Ads API after each call to a new Nexla webhook data source.

API Method​

  1. To manually configure this destination, select the Advanced tab at the top of the configuration screen.

  2. Select the API method that will be used for calls to the Snapchat Ads API from the Method pulldown menu. Snapchat Ads API typically uses POST method for creating resources.

Data Format​

  1. Select the format in which the Nexset data will be sent to the Snapchat Ads API from the Content Format pulldown menu. Snapchat Ads API expects JSON format for all requests.

API Endpoint URL​

  1. Enter the URL of the Snapchat Ads API endpoint to which data will be sent in the URL field. This should be the complete URL to your Snapchat Ads endpoint (e.g., https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns). Include any required path parameters in the URL.

Ensure the API endpoint URL is correct and accessible with your current credentials. The Snapchat Ads API endpoint URL should include the API base URL (https://adsapi.snapchat.com/v1/) and point to the endpoint where you want to create resources. The endpoint URL should include the appropriate path parameters (e.g., ad account ID). You can test the endpoint using the Test button after configuring the URL.

Request Body​

  1. Configure the request body that will be sent to the Snapchat Ads API. The request body should contain the resource data formatted as JSON, with field names matching the Snapchat Marketing API's expected structure. The request body format is typically {message.json} to send the entire Nexset data as JSON, or you can construct a custom JSON structure with specific field mappings.

The request body must be valid JSON and must match the Snapchat Marketing API's expected format for the specific resource you're creating (campaigns, ads, etc.). Snapchat Marketing API uses specific structures for different resources. For detailed information about request body formats, available endpoints, and resource structures, see the Snapchat Marketing API documentation.

Save the Destination​

  1. Once all of the relevant steps in the above sections have been completed, 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.