Configure Snapchat Ads as a Source in your Pipeline

Perform the following steps to configure your Snapchat Ads Source:

1. Click Pipelines in the Navigation Bar.

2. Click + Create Pipeline in the Pipelines List View.

3. On the Select Source Type page, select Snapchat Ads.

4. On the Select Destination Type page, select the type of Destination you want to use.

5. On the Select Pipeline Type page, click Edge, and then click Continue.

   

   This page appears only if the selected Destination type is supported in Edge and your Team has an existing Snapchat Ads Pipeline with the same Destination type. Otherwise, you can proceed to create an Edge Pipeline.

6. In the Configure Source screen, specify the following:

   

   • Source Name: A unique name for your Source, not exceeding 255 characters. For example, Snapchat Ads Source.

   • In the Connect to your Snapchat Ads account section, click Authenticate Your Snapchat Ads Account, log in to your Snapchat Ads account, and grant Hevo access to your account.

   • In the Sync Settings section, specify the following:

     

     • Historical Sync Duration: From the drop-down, select the duration for which you want to ingest existing data from the Source. This cannot be changed after the Pipeline is created. Default value: 12 months.

   • In the Select Account section, specify the following:

     • Sync Mode: Specify whether to sync all Ad Accounts accessible to the authenticated account, or only specific ones:

       • Sync All Accounts: Hevo syncs data for all ad accounts accessible to your authorized Snapchat Ads account, including any accounts added later.

       • Sync Specific Accounts: Hevo ingests data only for the accounts you select from the Accounts drop-down in the Select Ad Accounts section.

         

   • (Optional) In the Custom Reports section, click + Add Report to define a custom report. Each report syncs to its own Destination table. For each report, specify the following:

     

     • Report Name: A unique name for the Destination table where Hevo loads the data for this report.

     • Breakdown: The level of detail shown in each row of the report.

     • Granularity: The frequency at which data is recorded in the report.

     • Action Report Time: The time used to determine when actions and conversions are counted in the report.

     • Dimension (optional): The attribute used to further break down the report data. This field is incompatible with the Hour granularity and with any SKAd Metrics field value.

     • Breakout (optional): The source through which the conversion occurred.

     • Base Metrics (optional): The performance metrics you want to include in the report.

     • Include Swipe and View Metrics: Enable this option to include separate metrics for swipe-ups and views for the selected base metric. You must configure both the Swipe Attribution Window and View Attribution Window in the Advanced Options section.

     • SKAd Metrics (optional): The conversion metrics from SKAdNetwork that you want to include in the report. This field is incompatible with any Dimension value or Hour granularity.

     Note:

     • Click Save after configuring each report. Reports that are not saved before you click Test & Continue are not included in the Pipeline.

     • If you add a new custom report or edit an existing one after the Pipeline is created, resync the corresponding object to apply the changes and load the data using the updated configuration.

   • (Optional) In the Advanced Options section, do the following:

     

     • Show Advanced Options: Enable this option to configure the following:

       • Swipe Attribution Window (optional): The number of days between a person interacting with your ad by swiping up and taking an action, such as making a purchase or signing up. Default value: 28 Days.

       • View Attribution Window (optional): The duration between a person viewing your ad and taking an action, such as making a purchase or signing up. The available options depend on the Swipe Attribution Window you select.

7. Click Test & Continue to test the connection to your Snapchat Ads Source. Once the test is successful, you can proceed to set up your Destination.

Data Replication

Hevo replicates data for all the objects selected on the Configure Objects page during Pipeline creation. By default, all supported objects and their available fields are selected. However, you can modify this selection while creating or editing the Pipeline.

Hevo ingests the following types of data from your Source objects:

• Historical Data: The first run of the Pipeline ingests historical data for the selected objects, based on the Historical Sync Duration specified when creating the Pipeline, and loads it into the Destination.

• Incremental Data: Once the historical load is complete, new and updated records for objects are ingested as per the sync frequency.

For report objects, Hevo ingests only the incremental data in subsequent Pipeline runs. For all other objects, Hevo ingests the entire data during each Pipeline run.

Note: Report data may change as more conversion data becomes available. To keep your data up to date, Hevo re-fetches the data once a day for each ad account. As a result, previously synced records for reports may be updated in the Destination.

You can create a Pipeline with this Source only using the Merge load mode. The Append mode is not supported for this Source.

Snapchat currently enforces a rate limit on the number of calls that can be made to its API in a given time period. If this limit is exceeded, a rate limit exception occurs. To understand how Hevo handles such scenarios, read Handling Rate Limit Exceptions.

Schema and Primary Keys

Hevo uses the following schema to upload the records to the Destination. For a detailed view of the objects, fields, and relationships, click the ERD.

Click to view ERD

Data Model

The following is the list of tables (objects) that are created at the Destination when you run the Pipeline: