All set? 

Start your Twitter Ads campaign.

Ads editor syntax sheet

The syntax sheet provides all the label IDs for targeting criteria. You can refer to this sheet if you're building or editing campaigns in Ads editor. You can download the syntax sheet within Ads editor, or here

An excel spreadsheet will download to your computer, with tabs along the bottom that contain different categories of targeting.

Use the right arrow to scroll between them, and choose the IDs you'd like to use when setting up your new campaign in Ads Editor. 

Remember, using Ads Editor to build campaigns is optional, and you can do all the same targeting within the campaign creation form in your ads account, which we recommend for new advertisers. 


How to use the syntax sheet

First, download the syntax sheet. 

There are certain targeting options that require an ID from the syntax sheet in order to set them up via Ads Editor. If you're building or editing a campaign in Ads Editor and want to target any of the below, you'll have to find the correct ID in the syntax sheet:

  • User Interests (Column AR)
  • Locations (Column AJ)
  • Platforms (Column AM)
  • Devices (Column AO)
  • OS Versions (Column AN)
  • Mobile Carriers (Column AS)
  • Event Targeting (Column BW)
  • TV Genres (Column BS)
  • TV Channels (Column BT)
  • Behaviors (Column BF)
  • IAB Categories (Column AE)

Copy the targeting criteria IDs you would like to target from the syntax sheet, and paste them into the corresponding column in your Ads Editor file. Make sure to copy the entire ID and separate multiple IDs by semicolon. 

For instance, if you want to target “Movies and television/Comedy” from the User Interests tab of the syntax sheet, insert “i2005:Comedy” into the “User Interests” Ads Editor column (Column AR) for the row you want to add this targeting to. If you want to add “Movies and television/Drama” to the same campaign, simply add it to the Ads Editor cell, so the “User Interests” cell formatting reads: “i2005:Comedy;i2007:Drama”

In the picture on the right you'll see how to target two locations, the UK and U.S. You would put "i18:United Kingdom;i2:United States" into Ads Editor Column AJ in the row of the campaign you want to target. 

Syntax sheet FAQs

  • Help! I'm confused by Ads Editor
    Arrow down icon

    Ads Editor #Protips: 

    1. Ads Editor isn't required to create or edit campaigns. You can set the same exact targeting parameters in Ads Editor that you can in the campaign setup form. Try creating and editing your campaigns in your Twitter ads account at ads.twitter.com.
    2. Create your campaign how you'd like it set up in your ads account, then download the Ads Editor file to see how it should be formatted. Match that formatting moving forward for any edits you'd like to make via Ads Editor. 
    3. Check out our Ads Editor Help Center page with common FAQ's. 
    4. Watch this quick video tutorial on Ads Editor. 

     


    Did we help answer your question?

    The maximum length for this field is 5000 characters.
    Success
    Thanks for submitting feedback on this article!
    Error
    Problem sending form.
  • I'm seeing an error when I upload my Ads Editor file
    Arrow down icon

    When you Import your Ads Editor file and there is a (a) a missing field or (b) an incorrectly formatted field, it will show an error. 

    It will detail the exact errors in your Ads editor file below, as well as the corresponding Row number. Look at the issue, and fix it in the row that it mentions. 

    Common errors for Ads Editor include: 

    • Improper formatting. Make sure all targeting is separated by a semicolon (;)
    • Make sure there are no accidental spaces after your targeting lists. For example, "i981828007756206081;i972257579379302401*SPACE* will cause an error when importing
    • Start date in the past. If you're creating a copy of an old campaign, make sure you update the start and end dates
    • Ad group budget greater than Campain total budget. If you're updating an Ad group total budget (Column S) for a campaign that has already spent, make sure you also update the campaign total budget (Column H)
    • Incompatible bid types. Make sure the bid type you set up is available for the campaign objective you chose
    • @handle no longer available. If you're adding Follower targeting, all the @handles listed must be current active handles. Make sure to use a current list of @handles, to prevent users might have changed their @handle 

    Ads Editor #Protips: 

    1. Ads Editor isn't required to create or edit campaigns. You can set the same exact targeting parameters in Ads Editor that you can in the campaign setup form. Try creating and editing your campaigns in your Twitter ads account at ads.twitter.com.
    2. Create your campaign how you'd like it set up in your ads account, then download the Ads Editor file to see how it should be formatted. Match that formatting moving forward for any edits you'd like to make via Ads Editor. 
    3. Check out our Ads Editor Help Center page with common FAQ's. 
    4. Watch this quick video tutorial on Ads Editor. 

    Did we help answer your question?

    The maximum length for this field is 5000 characters.
    Success
    Thanks for submitting feedback on this article!
    Error
    Problem sending form.
  • My Behavior targeting isn't working
    Arrow down icon

    Behavior targeting is only available in the United States and the United Kingdom. First, make sure your campaign is only targeting the United States or the United Kingdom, you cannot target both in one campaign when using Behavior targeting. 

    Ensure your Ads Editor targeting contains the correct version of the behavior audience. For example, certain audiences may only be available for targeting in the U.S. and not the U.K., or vice versa. 

    If you're continually having trouble adding Behavior targeting using Ads Editor, we recommend that you edit this targeting type in the campaign creation form in your Ads account UI. 


    Did we help answer your question?

    The maximum length for this field is 5000 characters.
    Success
    Thanks for submitting feedback on this article!
    Error
    Problem sending form.
  • I don't see a targeting option I want to include in my campaign
    Arrow down icon

    All targeting options are currently listed in our syntax sheet, they continually update automatically as we add new options. Make sure you have the most current version of the syntax sheet downloaded. 

    If you still cannot find the option you'd like to target, unfortunately we do not have that targeting available at this time. 


    Did we help answer your question?

    The maximum length for this field is 5000 characters.
    Success
    Thanks for submitting feedback on this article!
    Error
    Problem sending form.

More questions on Ads Editor?

Check out our other pages: Intro to Ads Editor | Ads Editor ID list | Ads Editor troubleshooting


Did we help answer your question?

The maximum length for this field is 5000 characters.
Success
Thanks for submitting feedback on this article!
Error
Problem sending form.