Channel-Wise Automated Ads Fields & Formatting Guidelines

Updated 

Overview


This document provides a comprehensive list of fields required for Automated Ads setup across multiple channels, including Meta, Google, LinkedIn, TikTok, Snapchat, and more. The formatting details ensure that advertisers follow the correct structure to avoid errors and streamline the ad creation process.

Field

Required Format

Example Values

Margin Entry Type

Number

1

Total Budget

Number

10000

Start Date

MM/DD/YYYY HH:MM:SS AM/PM or MM/DD/YYYY

01/01/2025 08:00:00 AM or 01/01/2025

End Date

MM/DD/YYYY HH:MM:SS AM/PM or MM/DD/YYYY

12/31/2025 11:59:59 PM or 12/31/2025

Lifetime Budget

Number

50000

Daily Budget

Number

200

Enter Day Parting Details for all Ad Sets

Days and their time ranges should be semicolon-separated. Time ranges should be comma-separated.
Half-hour-long time slots starting on the hour or half-hour should be used.

MONDAY:[8:00-10:00], TUESDAY:[2:30-5:00], WEDNESDAY:[11:00-13:00], THURSDAY:[17:00-20:00], FRIDAY:[9:00-12:00, 13:00-14:00], SATURDAY:[14:00-16:00],SUNDAY:[10:00-12:00]

Web Analytics

ID

6706125ffb54eb18093629e2

URL Shortener

Value

Media

Image/Video

Publicly accessible URL or URLs from Sprinklr DAM

Text

Text

lorem ipsum dolor sitamet

Headline

Text

lorem ipsum dolor sit amet

Description

Text

lorem ipsum dolor sitamet

URL

URL

ID

Unique Values

1

Status

Values of Status
Capitalized

Archived, Paused, Active, Deleted

Field

Required Format

Example Values

Custom Audiences

ID:Value

120206967603450434:My Audience
2.0,120209607173610434:Sample Custom Audience(1% to 6%),120210064756300434:sb1234,120211417663660434:custom_audience_sample.csv

Language

Comma Separated

Arabic,Afrikaans,Albanian

End Date

MM/DD/YYYY HH:MM:SS
AM

12/02/24 3:54

Timezone

Value

 (GMT-06:00) Central Time - Mexico City, Mexico (México)

(GMT+10:00) Truk, Micronesia

(GMT+11:00) Kosrae, Micronesia

(GMT+11:00) Ponape, Micronesia

(GMT+02:00) Chisinau, Moldova (Republica

Beneficiary

Value

Aditya Tripathi 123

Income

ID:Value

 

Page

ID

 

Web Analytics

ID

6706125ffb54eb18093629e2

Placements

Semicolon Separated

Facebook In-Stream Videos;Facebook Stories;Facebook Business Explore;Facebook Feed;Instagram
Stories;Ads on Instagram Reels;Facebook Search Results;Messenger
Stories;Facebook Marketplace;Ads on Facebook Reels;Instagram Explore
Home;Instagram search results;Audience Network In-Stream Videos;Facebook
Reels;Instagram Reels;Instagram Profile Feed;Facebook Video Feeds;Instagram
Explore;Instagram Feed

Location

(Latitude1, Longitude1)(Exact_Latitude1, Exact_Longitude1) + Radius;

(Latitude2, Longitude2)(Exact_Latitude2, Exact_Longitude2) + Radius

(40.6985,-73.5927(40.69849171183292,-73.59272034158174)+10mi;(40.8264, -73.1972)(40.82643159532316,-73.19721252908174) +10mi

Location - Sub City

Value Semicolon Separated

Oak HillsPlace;Egmond op den Hoef;Broek op Langendijk

Location - Excluded Sub City

Value Semicolon Separated

Oak HillsPlace;Egmond op den Hoef;Broek op Langendijk

Location - Neighbourhood

Value Semicolon Separated

Place LaRue;PlaceLongueuil;Hubbell Place;Ormsby Place

Location - Excluded Neighbourhood

Value Semicolon Separated

Place LaRue;PlaceLongueuil;Hubbell Place;Ormsby Place

Location - Electoral District

Country:StateDistrict:Year

US:MD01:2020,US:WA01:2020,US:NE01:2020

Location - Excluded Electoral District

Country:StateDistrict:Year

US:MD01:2020,US:WA01:2020,US:NE01:2020

Location - Country

Value

Algeria,Angola,Benin,Afghanistan,Azerbaijan

Location - Excluded Country

Value

Algeria,Angola,Benin,Afghanistan,Azerbaijan

Location - Region

RegionName(CountryCode);

OpoleVoivodeship(PL);Oppland(NO)

Location - Excluded Region

RegionName(CountryCode);

OpoleVoivodeship(PL);Oppland(NO)

Location - Zips

CountryCode:RegionCode

CR:10202,TW:202,ID:789

Location - Excluded Zips

CountryCode:RegionCode

CR:10202,TW:202,ID:789

Location - Place

Region, C:CountryCode + Radius;

LATAM, C:MX +25mi;LATAM, C:HN +25mi;Delhi NCR, C:IN +25mi

Location - City

City, C:CountryCode + Radius;

Delhi, C:US +25mi;Delhi, C:US +25mi;Delhi, C:IN +25mi;Delhi, C:US +25mi

Location - Excluded City

City, C:CountryCode + Radius;

Delhi, C:US +25mi;Delhi, C:US +25mi;Delhi, C:IN +25mi;Delhi, C:US +25mi

Field

Required Format

Example Values

Custom Audiences

ID Semicolon Separated

212134232332:Custom Audience 1; 43434344344:Custom Audience 2;

Interests

ID:Value;

1915591417:northwest;1915613326:northern;1915653865:nope;1915636698:noob

Additional Interests

ID:Value;

1915591417:northwest;1915613326:northern;1915653865:nope;1915636698:noob

Trending Hashtags

Check

Language

Semicolon Separated

Hindi;Finnish;Russian;Portuguese

Age Range

Semicolon Separated

Location

ID:Value;

6252001:United States;3865483:Argentina;1861060:Japan

Connection Type

Semicolon Separated

2G;4G;5G

Device Model

ID:Value;+D29

298:Discovery;177009:Pixel 2 Xl;177001:Pixel 3a Xl;177012:Pixel 4a
5g;177002:Pixel 4 Xl

Carriers

ID:Value;

7220000:AR: Claro;4400003:JP: Rakuten Mobile;3100001:US: Sprint
(unavailable);3100002:US: T-Mobile;3100003:US: Verizon

Select Identity

i:Value

i:7153038929503092738

Call to Action

ID

c:7443764759628958738

Select Placement

Comma Separated

TikTok,Pangle,Global App Bundle

Field

Required Format

Example Values

Language

code:Language

en:English

Detailed Targeting

[[1]]ID1:Company1;ID2:Company2

[[1]]3:Forbes World’s Most Innovative Companies;500:Fortune 1000 (US
only);300:Fortune 100 Fast Growing Companies (Worldwide);1:Fortune Global 500
(Worldwide)

Geography

urn:li:geo:ID##Country

urn:li:geo:103644278##United States;urn:li:geo:105721136##Franklin
County, Ohio, United States;urn:li:geo:90000034##Denver Metropolitan Area

Field

Required Format

Example Values

Custom Audiences

ID:Value,

5r75y:Followers Count Greater Than 100000_TWITTER_ID_INCLUDED 2024-11-07
052718,447lp:Twitter custom audience
1,4qgog:FirehoseTweetText_1645068731546_TWITTER_ID_EXCLUDED

Include look-alikes of your custom
audience

ID:Value,

4qgog:FirehoseTweetText_1645068731546_TWITTER_ID_EXCLUDED,447lp:Twitter
custom audience 1

Flexible Tailored Audiences

ID:Value,

447lp:Twitter custom audience 1,50qhq:All
Profiles_TWITTER_ID_INCLUDED,50qhr:All Profiles_PHONE_NUMBER_INCLUDED

Location

Format not available please contact support

el Bruc / El Bruc, ES;el Brull / El Brull, ES

Language

code:Language

sq:Albanian,ar:Arabic,bg:Bulgarian,ca:Catalan

Keywords

Value

Negative keywords -value

Interests

ID:Value,

6001:Advertising,6002:Biotech and biomedical,6016:Business news and
general info,21010:General info,21003:Make-up and cosmetics,21007:Face care

Similar to Followers of User

ID:Value;

296980484:PopTV;4429003533:PopCrave;1836014804198182912:popfrenchcult;627269654:InqPOP

Engagement Type

Value

IMPRESSION

Campaign Engagement

Value

k4cgl,g6m8l,jjd2h,jjli6

User Engagement

ID

296651969

Movies and TV Shows

ID:Value

1265574047330394112:The Lord of the Rings The Fellowship of the Ring

Event

ID:Value

41c:76th Annual DGA Awards

Conversation

ID:Value

4d3:Actor - Chandler Riggs,43a:Actor - Arnold Schwarzenegger

Brand Vertical

Value

Alcohol,Dating,Gaming

Field

Required Format

Example Values

Geo Location

code:Location comma separated

pk:Pakistan;us:United States

Location Category

code:Location comma separated

Language

code:Language;

zh:Chinese;en:English;fi:Finnish;fr:French

Advanced Demographics

Code:Value;

SLC_2:Arts & Culture Mavens;SLC_1:Adventure
Seekers;NLN_9077:Household Supplies - Laundry Detergent Buyers;NLN_9006:Home
Improvement Buyers - HomeGoods

Snap Audience Match

Format not available please contact support

Blank

Predefined Audiences

Format not available please contact support

Blank

User Device

Format not available please contact support

ACE France/:ACE France;Acer/:Acer;Asus/ZenFone Max Pro M1 (ZB602KL) (WW)
/ Max Pro M1 (ZB601KL) (IN)/:ZenFone Max Pro M1 (ZB602KL) (WW) / Max Pro M1
(ZB601KL) (IN);Blu/B160V/:B160V;CHAINWAY/:CHAINWAY

Device Carrier

Value

WIFI

Edit Placements

Format not available please contact
support

Public Profile

ID

9769188d-4695-43dc-95a3-af1faea4137d

Select Lens

ID

dc56e1b7-9fbb-4f82-9de8-33b100f0e36a

Field

Required Format

Example Values

Location

code;value,

76056;Alvorada do Sul,76089;Altamira

Language

code;language,

da;Danish,en;English,zh;Chinese

Age

Comma Separated

25-34,45-49

Keywords

Format not available please contact support

[{"match_type":"BROAD","value":"a","id":"2887019841727"},{"match_type":"BROAD","value":"aesthetic","id":"2887019841725"}]

Custom Audiences

code;value,

2542622318333;Test123,2542622341209;Test Audience
Shared,2542622345104;Sample Audience for Sharing

Interests

code;value,

897362400511;Kids' Games,908529201089;Family Games,935154951619;Music
Games,937369559341;Mobile App Games

User Device

code;value,

android_tablet;Android Tablet,web;Web,web_mobile;Mobile Web

Placements

value

Search

Board

b:ID

b:526076868911609679

Section

Format not available please contact
support

Field

Required Format

Example Values

Custom Audiences

Format not available please contact
support

Interests

Format not available please contact
support

Keywords

Format not available please contact
support

Communities

Value:value;

01poptravel:01poptravel;0xpolygon:0xpolygon;100gecsplayboicarti:100gecsplayboicarti

Location

code:country;

AF:Afghanistan;AS:American Samoa;AX:Aland Islands

Carriers

ID:Value;

AUSSIE_BROADBAND:Aussie Broadband;BREDBAND2_AB:Bredband2
AB;HI3G_ACCESS_AB_DK:Hi3G Access AB (Denmark)

Android

Value:value;

10:10;2:2;3:3

IOS

Value:value;

iPad Mini 5:iPad Mini 5;iPad Pro 11-inch 2:iPad Pro 11-inch 2;iPad Pro
11-inch 3:iPad Pro 11-inch 3

Funding Instrument

ID

814206

Field

Required Format

Example Values

Interests

value;

Nissan;New Apartments (For Sale);Nintendo Consoles;Nursery

Language

value;

Bengali;Chinese (Hong Kong SAR);Chinese (traditional);Assamese

Parental Status

value;

Not a Parent;Parent;Unknown

Min Household Income

value

Top 10%

Location

value;

Norway;Netherlands;New Zealand

Custom Audiences

value;

jhvhcvhcjhcjhcj;lokalike 1;asdfasdf;customer list test;AdWords optimized
list;check 2

Business Name

Format not available please contact
support

Please contact support for any missing formats