Creative Elements

A Creative Element is an individual unit that is combined with other Creative Elements to create a Collection Ad Creative.

Attributes

Attribute	Description	Required	Possible Values
ad_account_id	Ad Account ID	R
name	Creative Element name	R
type	Creative Type	R	BUTTON
interaction_type	Type of interaction to be used on the element	R	WEB_VIEW, DEEP_LINK
description	Description of the creative element	O
title	Title of the creative element	O
button_properties	Properties of the button like the image to be shown	R (for type=BUTTON)
web_view_properties	Properties of the web view to be used	R (if interaction_type=WEB_VIEW)
deep_link_properties	Properties of the deep link to be used	R (if interaction_type=DEEP_LINK)

Additional Attributes

button_properties object must contain the following attributes

Attribute	Description	Required	Possible Values
button_overlay_media_id	The image to be used for the button tile	R	See MediaMust be at least 120 X 120px. Max size: 2MB

web_view_properties object must contain the following attributes

Attribute	Description	Required	Possible Values
url	Web view URL	R
allow_snap_javascript_sdk	Allow Snapchat Javascript SDK to autofill form fields	O	true/false
block_preload	Block Snapchat from preloading the web page	O	true/false

deep_link_properties object must contain the following attributes

Attribute	Description	Required
deep_link_uri	Deep Link URL	R
app_name	App name	R
ios_app_id	iOS App ID	Optional but one of ios_app_id or android_app_url is required
android_app_url	Google Play Store ID	Optional but one of ios_app_id or android_app_url is required
icon_media_id	Icon Media ID	R
fallback_type	Type of fallback to be used when user doesn't have the app	O
web_view_fallback_url	Fallback web url to be used	O
product_page_id	Custom product page ID from iOS App Store. Only set when using a Custom Product Page	O

IMPORTANT! Shopify advertisers using the Snapchat Ads App for Shopify will have their "snap_campaign_id" URL parameter set to a default, unique identifier for web view and deep link ads. This is to ensure proper attribution in the Shopify Admin Dashboard. The "snap_campaign_id" URL parameter cannot be overwritten by the Snapchat URL Macros builder or with url_macro_parameters.

Collection Ads only work on iOS, Android support is coming soon

Create a Creative Element

curl -X POST  \
  -d '{"creative_elements": [{"name":"Product 1 button", "type":"BUTTON", "description": "Product 1", "interaction_type":"WEB_VIEW", "title":"Best title", "button_properties":{"button_overlay_media_id":"008a5ae9-bcc1-4c2e-a3f1-7e924d582019"},"web_view_properties":{"url":"https://snapchat.com"}}]}' \
  -H "Content-Type: application/json"  \
  -H "Authorization: Bearer meowmeowmeow" \
  https://adsapi.snapchat.com/v1/adaccounts/8adc3db7-8148-4fbf-999c-8d2266369d74/creative_elements

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5bee332000ff06b565385cab550001737e616473617069736300016275696c642d33373039663463642d312d3232302d3000010145",
  "creative_elements": [
    {
      "sub_request_status": "SUCCESS",
      "creative_element": {
        "id": "f63bb5f5-471c-404f-8f0d-e5c1a003e4d9",
        "updated_at": "2018-11-16T03:01:52.907Z",
        "created_at": "2018-11-16T03:01:52.907Z",
        "name": "Product 1 button",
        "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
        "type": "BUTTON",
        "interaction_type": "WEB_VIEW",
        "title": "Best title",
        "description": "Product 1",
        "button_properties": {
          "button_overlay_media_id": "008a5ae9-bcc1-4c2e-a3f1-7e924d582019"
        },
        "web_view_properties": {
          "url": "https://snapchat.com",
          "allow_snap_javascript_sdk": false,
          "use_immersive_mode": false,
          "deep_link_urls": [],
          "block_preload": false
        }
      }
    }
  ]
}

Create Multiple Creative Elements

curl -X POST  \
  -d '{"creative_elements": [{"name":"Product 1 button", "type":"BUTTON", "description": "Product 1", "interaction_type":"WEB_VIEW", "title":"Best title", "button_properties":{"button_overlay_media_id":"008a5ae9-bcc1-4c2e-a3f1-7e924d582019"},"web_view_properties":{"url":"https://snapchat.com"}}, {"name":"Product 2 button", "type":"BUTTON", "description": "Product 2", "interaction_type":"WEB_VIEW", "title":"Best title", "button_properties":{"button_overlay_media_id":"008a5ae9-bcc1-4c2e-a3f1-7e924d582012"},"web_view_properties":{"url":"https://snapchat2.com"}}, {"name":"Product 3 button", "type":"BUTTON", "description": "Product 3", "interaction_type":"WEB_VIEW", "title":"Best title", "button_properties":{"button_overlay_media_id":"008a5ae9-bcc1-4c2e-a3f1-7e924d582013"},"web_view_properties":{"url":"https://snapchat3.com"}}]}' \
  -H "Content-Type: application/json"  \
  -H "Authorization: Bearer meowmeowmeow" \
  https://adsapi.snapchat.com/v1/adaccounts/8adc3db7-8148-4fbf-999c-8d2266369d74/creative_elements

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5bee33f200ff057a031dfee6af0001737e616473617069736300016275696c642d33373039663463642d312d3232302d300001011a",
  "creative_elements": [
    {
      "sub_request_status": "SUCCESS",
      "creative_element": {
        "id": "70debf44-cb4b-4b5f-8828-bd2b68b9f0ca",
        "updated_at": "2018-11-16T03:05:23.241Z",
        "created_at": "2018-11-16T03:05:23.241Z",
        "name": "Product 1 button",
        "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
        "type": "BUTTON",
        "interaction_type": "WEB_VIEW",
        "title": "Best title",
        "description": "Product 1",
        "button_properties": {
          "button_overlay_media_id": "008a5ae9-bcc1-4c2e-a3f1-7e924d582019"
        },
        "web_view_properties": {
          "url": "https://snapchat.com",
          "allow_snap_javascript_sdk": false,
          "use_immersive_mode": false,
          "deep_link_urls": [],
          "block_preload": false
        }
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "creative_element": {
        "id": "a2d1c8a0-0466-4924-b769-7a7e6ed5be3d",
        "updated_at": "2018-11-16T03:05:23.241Z",
        "created_at": "2018-11-16T03:05:23.241Z",
        "name": "Product 2 button",
        "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
        "type": "BUTTON",
        "interaction_type": "WEB_VIEW",
        "title": "Best title",
        "description": "Product 2",
        "button_properties": {
          "button_overlay_media_id": "008a5ae9-bcc1-4c2e-a3f1-7e924d582012"
        },
        "web_view_properties": {
          "url": "https://snapchat.com",
          "allow_snap_javascript_sdk": false,
          "use_immersive_mode": false,
          "deep_link_urls": [],
          "block_preload": false
        }
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "creative_element": {
        "id": "4091233e-3351-405d-8684-a97e70c3b5da",
        "updated_at": "2018-11-16T03:05:23.242Z",
        "created_at": "2018-11-16T03:05:23.242Z",
        "name": "Product 3 button",
        "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
        "type": "BUTTON",
        "interaction_type": "WEB_VIEW",
        "title": "Best title",
        "description": "Product 3",
        "button_properties": {
          "button_overlay_media_id": "008a5ae9-bcc1-4c2e-a3f1-7e924d582013"
        },
        "web_view_properties": {
          "url": "https://snapchat.com",
          "allow_snap_javascript_sdk": false,
          "use_immersive_mode": false,
          "deep_link_urls": [],
          "block_preload": false
        }
      }
    }
  ]
}

Create an Interaction Zone

Attributes

Attribute	Description	Required	Possible Values
ad_account_id	Ad Account ID	R
name	Creative Element name	R
headline	Headline for the interaction zone	R	Same as all allowed call_to_action values for Web View Creative
creative_elements	Array of Creative Element IDs	R	Must have at least 4 creative elements.

curl -X POST  \
  -d '{"interaction_zones": [{"name": "First Interaction Zone", "creative_element_ids": ["d28427e5-0604-406c-8f23-167b211a3317","dc80a56f-800c-499b-846b-78e74bd39a9d","75a98c65-1e62-4507-97fe-50cbc523523a","faefe7cd-567d-4647-bb1d-b918fb0ac98a", "f63bb5f5-471c-404f-8f0d-e5c1a003e4d9"], "headline":"MORE"}]}' \
  -H "Content-Type: application/json"  \
  -H "Authorization: Bearer meowmeowmeow" \
  https://adsapi.snapchat.com/v1/adaccounts/8adc3db7-8148-4fbf-999c-8d2266369d74/interaction_zones

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5bee38df00ff00ff5858a22dbc9f0001737e616473617069736300016275696c642d33373039663463642d312d3232302d3000010154",
  "interaction_zones": [
    {
      "sub_request_status": "SUCCESS",
      "interaction_zone": {
        "id": "a218dc8b-7a79-4da6-9a1c-e5a581c7bd46",
        "updated_at": "2018-11-16T03:26:23.130Z",
        "created_at": "2018-11-16T03:26:23.130Z",
        "name": "First Interaction Zone",
        "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
        "headline": "MORE",
        "creative_element_ids": [
          "70debf44-cb4b-4b5f-8828-bd2b68b9f0cf",
          "a2d1c8a0-0466-4924-b769-7a7e6ed5be3b",
          "4091233e-3351-405d-8684-a97e70c3b5dc",
          "f63bb5f5-471c-404f-8f0d-e5c1a003e4d9"
        ]
      }
    }
  ]
}