Claravine + Snapchat Ads Manager Integration

Julia Randall
Julia Randall
  • Updated

Claravine integrates with Snapchat Ads Manager to solve problems caused by sprawling advertising data, complicated by siloed teams and tools. Use our integration to deliver and measure your campaigns. Our platform, The Data Standards Cloud, automatically syncs campaign, ad group, and ad data from this engaging camera and messaging app, making it easy to:

  • Automate the import of data
  • Remove manual steps to correct and enhance Snapchat naming conventions
  • Accelerate data entry and custom tracking URL building
  • Audit and validate data against marketing data standards
  • Pass data downstream for more readable classifications
  • Enrich data for improved dimensionality and segmentation in analysis

Once the connector is set up, The Data Standards Cloud automatically syncs and imports specified data from Snapchat and maps this into the appropriate fields in your template(s). From there, you can take a few approaches depending on what your team is looking to accomplish.

You can pass this data directly to your analytics and BI tools so you can more immediately understand performance in these systems. And, you can enrich this data with additional business-specific metadata before sending it downstream. Additionally, naming can be validated, modified, and automatically populated back into Snapchat Ads Manager.

You can also create and validate data across various team workflows. For example, generate naming conventions in our platform. Then set-up campaigns in Snapchat Ads Manager and import this data to validate compliance and add business-specific data from the naming convention workflow. At the same time associate data together for use across workflows, or pass it to your downstream solutions. This type of approach helps you to improve naming compliance while simultaneously putting more accurate, detailed data in the hands of your media and creative teams, and adding important dimensionality to your final analysis in other systems.

Interested in reading more? Check out our blog and talk with your CSM.

  • Connect Claravine and Snapchat Ads Manager

    To connect Claravine's platform with Snapchat Ads Manager, you will perform the initial steps in Snapchat Ads Manager and then complete the setup in Claravine's platform. 

    To connect Snapchat Ads Manager with Claravine, the customer must have a Snap Client ID and Snap Client Secret Key, which can be obtained after registering Claravine as an OAuth app with their business account.

    Step 1. Snapchat Ads Manager

    In Snapchat Ads Manager:

    1. Ensure that the user setting up the OAuth configuration has access to all ad accounts: confirm that they are set up with an Organizational Admin Role in Snapchat.
    2. Follow Snapchat’s documentation for instructions on how to Activate Access to the Snapchat Marketing API.
    3. During this process, to properly set the connector, use this value for the Snap Redirect URIhttps://oauth.claravine.com/api/v1/oauth/callback/snapchat 

      snap1.png
    4. Once Claravine has been added as an OAuth app, you will see the Snap Client ID and Snap Client Secret Key. Copy this key; you will paste it into Claravine.

      snap2.png

    Step 2. The Data Standards Cloud

    In Claravine's Platform:

    1. In the left navigation panel, select Settings → Integrations → Accounts.
      The Accounts page displays.
    2. Click the plus sign (+) in the top right to create a new account.
      The Create Connected Account menu displays.
    3. Enter the following information for the account:
      • Name
      • Description (optional): We recommend entering a description to make it easier to determine the use of the Account when creating targets.
    4. Select the Snapchat tile as the account type.
    5. Paste the Snap Client ID and Snap Client Secret Key obtained in Step 3 of the Snapchat Ads Manager instructions above.
    6. Click Save and Connect Account.

    What's next: Follow the instructions to create a Snapchat Ads Manager inbound integration Template.

  • Snapchat Ads Manager Fields Available for Integration

    The integration allows specific fields in Snapchat to automatically import data into or from a connected template. Below is a list of supported fields and attributes you can map data from/to in Snapchat.

    Campaign

    Refer to the Campaigns API Field Reference for the full collection of Campaign fields available through the Snapchat API.

    API Field Name Field Label Required Inbound Outbound Inbound Filters
    id Campaign ID Y  
    createdAt Campaign Created At    
    adAccountId Campaign Ad Account ID      
    startTime Campaign Start Time    
    status Campaign Status (refer to Integration Filters    
    name Campaign Name    
    deliveryStatus Campaign Delivery Status      
    objective Campaign Objective      
    buyModel Campaign Buy Model      

    Ad

    Refer to the Ad API Field Reference for the full collection of Ad fields available through the Snapchat API.

    API Field Name Field Label Required Inbound Outbound Inbound Filters
    id Ad ID Y  
    reviewStatus Ad Review Status    
    createdAt Ad Created At    
    creativeId Ad Creative ID      
    status Ad Status (refer to Integration Filters)      
    adSquadId Ad Squad ID      
    name Ad Name    
    deliveryStatus Ad Delivery Status      
    type Ad Type      
    renderType Ad Render Type      

    Ad Accounts

    Refer to the Ad Accounts API Field Reference for the full collection of Ad Accounts fields available through the Snapchat API.

    API Field Name Field Label Required Inbound Outbound Inbound Filters
    id Ad Accounts ID Y  
    createdAt Ad Accounts Created At    
    status Ad Accounts Status (refer to Integration Filters    
    currency Ad Accounts Currency      
    name Ad Accounts Name  
    advertiserOrganizationId Advertiser Organization ID      
    agencyRepresentingClient Agency Representing Client      
    billingCenterId Ad Accounts Billing Center ID      
    billingType Ad Accounts Billing Type      
    timezone Ad Accounts Time Zone      
    organizationId Ad Accounts Organization ID      
    type Ad Accounts Type      
    clientPayingInvoices Ad Accounts Client Paying Invoices      
    fundingSourceIds Ad Accounts Funding Source IDs      
    regulations_restrictedDeliverySignals Regulations Restricted Delivery Signals      

    Ad Squads

    Refer to the Ad Squads API Field Reference for the full collection of Ad Squads fields available through the Snapchat API.

    API Field Name Field Label Required Inbound Outbound Inbound Filters
    id Ad Squad ID Y  
    name Ad Squad Name    
    createdAt Ad Squad Created At      
    campaignId Ad Squad Campaign ID      
    skadnetworkProperties_status SKAd Network Properties Status      
    lifetimeBudgetMicro Ad Squad Lifetime Budget Micro      
    startTime Ad Squad Start Time    
    endTime Ad Squad End Time    
    creationState Ad Squad Creation State      
    status Ad Squad Status    
    dailyBudgetMicro Ad Squad Daily Budget Micro      
    deliveryConstraint Ad Squad Delivery Constraint      
    autoBid Ad Squad Auto Bid      
    deliveryStatus Ad Squad Delivery Status        
    targetBid Ad Squad Target Bid      
    bidStrategy Ad Squad Bid Strategy      
    targeting_demographics Ad Squad Targeting Demographics      
    targeting_geos Ad Squad Targeting Geos      
    billingEvent Ad Squad Billing Event      
    targeting_regulatedContent Ad Squad Targeting Regulated Content        
    targetingReachStatus Ad Squad Targeting Reach Status      
    optimizationGoal Ad Squad Optimization Goal      
    pacingType Ad Squad Pacing TypechildAdTy      
    childAdType Ad Squad Child Ad Type      
    forcedViewSetting Ad Squad Forced View Setting      
    placement Ad Squad Placement      
    type Ad Squad Type        

    Creatives

    Refer to the Creatives API Field Reference for the full collection of Creatives fields available through the Snapchat API.

    API Field Name Field Label Required Inbound Outbound Inbound Filters
    id Creative ID Y  
    name Creative Name    
    headline Creative Headline      
    reviewStatus Creative Review Status      
    reviewStatusDetails Creative Review Status Details      
    shareable Creative Shareable      
    createdAt Creative Created At      
    adAccountId Creative Ad Account ID      
    adProduct Creative Ad Product      
    webViewProperties_blockPreload Web View Properties Block Preload      
    webViewProperties_allowSnapJavascriptSdk Web View Properties Allow Snap Javascript SDK      
    webViewProperties_deepLinkUrls Web View Properties Deep Link URLS      
    webViewProperties_url Web View Properties URL      
    webViewProperties_useImmersiveMode Web View Properties Use Immersive Mode      
    brandName Creative Brand Name      
    topSnapCropPosition Creative Top Snap Crop Position      
    topSnapMediaId Creative Top Snap Media ID      
    callToAction Creative Call to Action      
    forcedViewEligibility Creative Forced View Eligibility      
    packagingStatus Creative Packaging Status      
    type Creative Type        
    renderType Creative Render Type      

    Media

    Refer to the Media API Field Reference for the full collection of Media fields available through the Snapchat API.

    API Field Name Field Label Required Inbound Outbound Inbound Filters
    id Media ID Y  
    name Media Name    
    mediaStatus Media Status      
    isDemoMedia Media is Demo Media      
    createdAt Media Created At      
    adAccountId Media Ad Account ID      
    downloadLink Media Download Link      
    durationInSeconds Media Duration in Seconds      
    fileName Media File Name      
    fileSizeInBytes Media File Size in Bytes      
    hash Media Hash      
    type Media Type        
    visibility Media Visibility      

    Organization

    Refer to the Organization API Field Reference for the full collection of Organization fields available through the Snapchat API.

    API Field Name Field Label Required Inbound Outbound
    ID Organization ID Y
    Name Organization Name  
    country Organization Country    
    state Organization State    

Comments

0 comments

Article is closed for comments.