Skip to main content

Snapchat Ads API Connector

Updated this week
Snapchat logo and symbol, meaning, history, PNG

๐Ÿ” Summary

This configuration supports comprehensive tracking of Snapchat ad delivery, conversion events, and associated metadata. The system is composed of two scheduled jobs: one for daily delivery/conversion data imports, and one for daily metadata refreshes. It supports metric aggregation, dimension tagging, and performance calculations such as Swipe Rate, VTR, and VCR.

For more information on this integration, please follow the link here.


โš™๏ธ Jobs Configuration

๐Ÿ› ๏ธ Job 1: Snap Ads - Data Import

Field

Value

Feed

snap

Status

2 (Enabled)

Label

Snap Ads - Data Import

Lookback

3 days

First Run Hour

5 AM

Poll Frequency

24 hours

Lookback Window

0

๐ŸŽฏ Targets

Priority

Table

Description

Update Mode

1

snap_data_ad

Snap Ads - Delivery Data

append

2

snap_data_ad_conversions

Snap Ads - Conversion Data

append


๐Ÿ› ๏ธ Job 2: Snap Ads - Meta Refresh

Field

Value

Feed

snap

Status

2 (Enabled)

Label

Snap Ads - Meta Refresh

Lookback

1 day

First Run Hour

5 AM

Poll Frequency

24 hours

Lookback Window

0

๐ŸŽฏ Targets

Priority

Table

Description

Update Mode

1

snap_meta_adaccount

Snap - Meta Account

refresh

2

snap_meta_campaign

Snap - Meta Campaign

refresh

3

snap_meta_adsquad

Snap - Meta AdSquad

refresh

4

snap_meta_ad

Snap - Meta Ad

refresh


๐Ÿ” Connection Settings

Key

Description

Type

Required

snap_account_ids

Comma-delimited Snap Account IDs

text

โœ… Yes

username

Snap Ads API username (ID/token)

text

โœ… Yes

secret

API secret token

text

โœ… Yes

  • Connection Description: Snap Ads


๐Ÿงญ Dimensions

Name

Maps to Field

Account [Snap]

snap_meta_adaccount.name

Campaign [Snap]

snap_meta_campaign.name

Ad Squad [Snap]

snap_meta_adsquad.name

Ad [Snap]

snap_meta_ad.name


๐Ÿ“Š Base Metrics

Name

Formula (simplified)

Format

Spend [Snap]

SUM(snap_data_ad.spend / 1,000,000)

ยฃ, 2dp

Swipes [Snap]

SUM(snap_data_ad.swipes)

integer

Impressions [Snap]

SUM(snap_data_ad.impressions)

integer

Video Views [Snap]

SUM(snap_data_ad.video_views)

integer

Video Views Quartile - 25%

SUM(snap_data_ad.quartile_1)

integer

Video Views Quartile - 50%

SUM(snap_data_ad.quartile_2)

integer

Video Views Quartile - 75%

SUM(snap_data_ad.quartile_3)

integer

Video Completes [Snap]

SUM(snap_data_ad.view_completion)

integer

Conversion Page Views [Snap]

SUM(snap_data_ad_conversions.conversion_page_views)

integer


๐Ÿงฎ Composite Metrics

Name

Formula

Format

Swipe Up Rate [Snap]

{Swipes [Snap]} / {Impressions [Snap]} * 100

%, 2dp

VTR [Snap]

{Video Completes [Snap]} / {Impressions [Snap]} * 1000

%, 2dp

VCR [Snap]

{Video Completes [Snap]} / {Video Views [Snap]} * 100

%, 2dp

Cost Per Swipe [Snap]

{Spend [Snap]} / {Swipes [Snap]}

ยฃ, 2dp


๐Ÿ”— Data Joins

Both snap_data_ad and snap_data_ad_conversions are joined to the metadata tables via:

Join Field

Joins With Table

ad_id

snap_meta_ad.id

bright_custom_ad_squad_id

snap_meta_adsquad.id

bright_custom_campaign_id

snap_meta_campaign.id

bright_custom_ad_account_id

snap_meta_adaccount.id


๐Ÿงพ API Use Case Summary

The Snapchat Ads integration uses the Snap Marketing API to:

  • Import daily performance data for ads and conversions.

  • Auto-refresh all metadata (campaigns, ad accounts, squads, ads) to ensure up-to-date taxonomy.

  • Support granular reporting via swipes, impressions, video quartiles, and conversions.

  • Enable performance calculations like swipe rate, view-through rate (VTR), view completion rate (VCR), and cost per swipe.

  • Join ad-level data with meta tables to power dashboards or feed business logic in downstream systems.

Did this answer your question?