Search

Claravine + Snapchat Ads Manager Integration


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 URI: https://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   ✔  

  • Add the Integration to a Template

    1. For step-by-step instructions on adding the inbound integration to a template, selecting your data type, and mapping fields, see Inbound Integration Configuration.
    2. For step-by-step instructions on adding the outbound integration to a template, see Outbound Integration Configuration.

Updated

Comments

0 comments

Article is closed for comments.