1. Support
  2. Ad Creator App (Pro)
  3. Getting started with Ad Creator

About the 'carousel' template

This page helps you fill the template you will use to create 'carousel' ads via Ad Creator.

✅You can use our Asset Finder to find and export the ID of all assets you have access to on Facebook Business Manager.

✅You can upload your template to Ad Creator either as a .csv or .xlsx file

✅Non-required columns can be removed from the template. These are not needed to validate your template.

🔴On your template, a red header: the column is required, data must be added to that column for each ad you create.

🔵Blue header: the column might be required in some situations. See the tab below for more details.

Carousel

Header

Required?

Data format

Description

name

yes

string

Ad Name on Facebook Ads Manager

adset_id

yes

Facebook ID

Facebook Ad Set ID: the ad will be created in that Ad Set

page_id

yes

Facebook ID

Facebook Page ID: to choose which page will be linked to your ad

website_url

Yes, if instant_exp_id is empty

instant_exp_id has the priority over website_url

Valid URL http(s)://someurl.com

Website URL - The destination link toward the landing page people arrive at when clicking on your ad

Facebook will not use this destination link if you attach an existing Instant Experience to your ad

⚠️all URL used in Ad Creator templates must either start by https:// or http://

instant_exp_id

Yes, if website_url is empty

instant_exp_id has the priority over website_url

Facebook ID

Add an instant experience ID here to link an existing instant experience to your carousel instead of linking a website URL.

If you link an instant experience to your ad, Facebook will not use the website URL of your ad.

display_link

no

URL (no validation)

  • The way your destination link will be displayed on your ad. Must match your website_url.

    For instance if you use webstite_url = https://www.thenextad.com/ you can choose between these display_url:

    • thenextad.com
    • www.thenextad.com
    • https://www.thenextad.com 

instagram_id

no

Facebook ID

Instagram Account ID: to choose which Instagram account be linked to your ad

primary_text

no

string

Primary Text

multi_share_end_card

no

FALSE or TRUE)(default is TRUE)

By default, we use that option. Type FALSE if you do not wish to use that option. Type TRUE or leave the cell empty if you want to use it.

To use the end card in the Carousel ad format.

multi_share_optimized

no

FALSE or TRUE)(default is TRUE)

By default, we use that option. Type FALSE if you do not wish to use that option. Type TRUE or leave the cell empty if you want to use it.

On Facebook Feed, Instagram Feed and Instagram Stories the carousel cards that perform best will be shown first. For all other placements cards will appear in the order you arrange them.

pixel_id

no

Facebook ID

Use a Facebook Pixel to track the conversions on your website

start_date

no

"YYYY-MM-DD hh:mm"

to schedule a start date to your ad. Our app Asset Scheduler will activate the ad on that date + time if you use this column

end_date

no

"YYYY-MM-DD hh:mm"

to schedule an end date to your ad. Our app Asset Scheduler will pause the ad on that date + time if you use this column

Cards fields (2 cards must be provided, up to 10 cards)
This example shows how to setup the first card (card number 1).

card.1.headline

no

string

Card Headline -  the main title visible bellow your card

card.1.description

no

string

Card 1 Description

card.#.link

Yes, if instant_exp_id is empty

instant_exp_id has the priority over website_url

Valid URL http(s)://someurl.com

Website URL - The destination link toward the landing page people arrive at when clicking on your card

Facebook will not use this destination link if you attach an Instant Experience to your ad

⚠️all URL used in Ad Creator templates must either start by https:// or http://

card.#.picture

yes

Valid URL

The URL toward the image displayed on your carousel card. If you use a video for this card, the image you choose here becomes a thumbnail for your video.

You can get the URL of a media in The Next Ad's Media Library by clicking on the small "eye" button on that media

⚠️all URL used in Ad Creator templates must either start by https:// or http://

card.#.video_url

no

Valid URL

The URL toward the video you want to use for this card

You can get the URL of a media in The Next Ad's Media Library by clicking on the small "eye" button on that media

⚠️all URL used in Ad Creator templates must either start by https:// or http://

card.#.cta

no

string

Call To Action (CTA) Button

Leave the cell empty if you do not want a CTA button

You must type one of the options listed in call_to_action_types here: https://developers.facebook.com/docs/marketing-api/reference/ad-asset-feed-spec/