20 Nov 2018 
Support Center » Knowledgebase » How to use tokens
 How to use tokens
Article Tokens is an extremely powerful feature that brings unique content to your ads.

You can access this feature through token manager - use corresponding button on the toolbar in the list of ads. Token manager will allow you to:
  • enter/edit/delete tokens and token variations
  • import tokens from XML format used by EAPD/troopal
  • export tokens to XML format used by EAPD/troopal
  • paste/import tokens and token variations from text file

Examples and special use cases of tokens
  1. Simple example - set up tokens to rotate the following variations of ad title:
    • Awesome 3 bed/2 bath house for sale
    • Nice 3 bed/2 bath house for sale
    • Awesome 3 bed/2 bath home for sale
    • Nice 3 bed/2 bath home for sale

      In this example we use 2 variations of 2 words - Awesome, Nice and home, house. In order to tell CLAD to rotate those variations we need to set up 2 tokens, let's name them POSITIVE and BUILDING. For each token we need to set up 2 variations: Awesome, Nice forPOSITIVE and home, house for BUILDING. After that, we put in the title of our ad:

      {POSITIVE} 3 bed/2 bath {BUILDING} for sale

      and CLAD Genius will automatically rotate variants randomly from the provided lists.
  2. Recursive tokens.

    It is possible define tokens inside token variations, for instance, define token TITLE with 2 variations:
    • {POSITIVE} 3 bed/2 bath {BUILDING} for sale
    • {BUILDING} with 3 bedrooms and 2 bathrooms. {POSITIVE} views.

      I this case, if you use in the title of your ad token {TITLE}, CLAD Genius will rotate the following variations:
    • Awesome 3 bed/2 bath house for sale
    • Nice 3 bed/2 bath house for sale
    • Awesome 3 bed/2 bath home for sale
    • Nice 3 bed/2 bath home for sale
    • house with 3 bedrooms and 2 bathrooms. Nice views.
    • house with 3 bedrooms and 2 bathrooms. Awesome views.
    • home with 3 bedrooms and 2 bathrooms. Nice views.
    • home with 3 bedrooms and 2 bathrooms. Awesome views.
  3. Inline tokens
    In token variation we can specify a construct like {Awesome|Nice}, which is equivalent to having 2 separate variations - Awesome and Nice.
  4. Region - specific tokens.

    If, for instance, you need to have phrases in your ads that are region-specific, you can use the following construct: {$cityname itemname} in your ads. Here, itemname is a placeholder for any item you need to rotate in the specific region, for instance, bars. Let's assume that you are posting to 2 regions: Manhattan and Brooklyn and would like to rotate specific bars for each region, for instance Beer Bar and Vodka Bar for Manhattan and Tequila bar and Martini bar for Brooklyn. In this case you will need to define 2 tokens:
    1. Manhattan bars
    2. Brooklyn bars
      Notice the spaces in the names of the tokes - you NEED to have them to separate the name of the region from the name of item. Next, for each token you will define variations: Beer Bar and Vodka Bar for Manhattan bars token, Tequila bar and Martini bar for Brooklyn bars token.
      After this is done, just write {$cityname bars} in your ads.
      Also take a look at this tutorial: City-specific tokens example
  5. Image tokens
    Tokens can also be used to rotate images in your ads. To do that, simply specify the path to your image (may be in form of local path (c:\images\image,jpg) or URL - http://photobucket.com/982374/897.jpg, etc) in token variations and then when you add images to your ad, use Add url link and put {IMAGE_TOKEN_NAME} in the URL box, where IMAGE_TOKEN_NAME - any name that you chose for your token.


    CLAD Genius also has a feature to synchronize images from image token sets. This is particularly useful for real estate agents who would like to images from differrent sets to match each other during random selection process. For instance, if we have 2 image sets - first is the front of the building and the second is the back of the building, with 3 items in each set, then we will have to use a special sequence field in the token variations edit window to specify how the images correspond to each other. For instace:
    • First set of images, token FRONT:
      • c:\images\front_of_building_1.jpg, sequence 10
      • c:\images\front_of_building_2.jpg, sequence 20
      • c:\images\front_of_building_3.jpg, sequence 30
    • Second set of images, token BACK:
      • c:\images\back_of_building_1.jpg, sequence 10
      • c:\images\back_of_building_2.jpg, sequence 20
      • c:\images\back_of_building_3.jpg, sequence 30

        After that, we just need to check the box "Synchronize random images from image tokens by sequence in the ad edit window". There are no particular rules as to what numbers you have to use for sequence values. The only requirement is that they must match across different image sets in order for this feature to work correctly
        Last step to make your image token synhronized is to put # at the end of the token name in the image URL, like this: {FRONT#} or {BACK#}
        Also take a look at this tutorial: Synchronized image tokens example

Tokens may be used anywhere in the ad body, title, location or publisher properties
.
If multiple tokens of the same name are used in the adbody, title, etc., they will resolve to the DIFFERENT random value within 1 ad. For instance, if we have a token HOUSE with variations Home, Apartment,then this construct {HOUSE}, {HOUSE} will resolve to
  • Home, Apartment --or--
  • Apartment, Home --or--
  • Apartment, Apartment --or--
  • Home, Home
If you would like to lock token values within 1 ad, use # postfix in the name of the token. In this case this construct {HOUSE#}, {HOUSE#} will resolve to
  • Home, Home --or--
  • Apartment, Apartment

Tokens support recursion, that is, tokens inside token variations.

IMPORTANT
: all token names are case sensitive, so if you define token Awesome, but use {awesome} in your ad, that will not work.


Article Details
Article ID: 139
Created On: 11 Dec 2010 5:47 PM

 This article was helpful  This article was not helpful

 Back
 Log in [Lost Password] 
E-mail:
Password:
Remember Me:
 
 Search
 Article Options
Home | Submit a Ticket | Knowledgebase | Troubleshooter
Language:

Help Desk Software by Kayako SupportSuite v3.70.02