Integration docs
  • Integrating
    • Getting started
    • JSON feed
    • JS tag
    • CSV import
    • REST API
    • Webhooks
  • Security
    • SSO authentication
  • Onboarding
    • Getting started
    • ATS Sync
      • ICIMS
      • Teamtailor
      • Recruiterflow
      • SAP SuccessFactors
      • Ashby
      • Pinpoint
      • Lever
      • Salesforce
      • Jobylon
      • Workday
      • Greenhouse
      • SmartRecruiters
      • Bullhorn
      • Bullhorn Recruitment Cloud (Bullhorn for Salesforce, BH4SF)
      • ReachMee (TalenTech)
      • Recman
    • Social ads
    • Social pages
      • Facebook & Instagram
      • LinkedIn
      • Snapchat
    • Social talent pools
      • Setup process
  • Templates & Content - Creative Assets
    • Getting Started
      • Image Templates
        • Aspect ratios & sizes
      • Text Templates
      • Exporting assets to Adway
      • Forbidden Content
    • Advanced
      • Dynamic text replacements
      • Variations
Powered by GitBook
On this page
  • Overview
  • Dynamic Replacements - Cheat sheet
  • Conditional values
  1. Templates & Content - Creative Assets
  2. Advanced

Dynamic text replacements

PreviousAdvancedNextVariations

Last updated 10 months ago

Overview

Working with templates to power your social media marketing is great for efficiency, scale, and for making sure that your company's brand guidelines always are followed - you can relax in the knowledge that your ads are always good looking and professional. However, always working with 100% pre-generated content can sometimes be a bit stale. You might also miss out on communicating key information that's role-specific. That's why Adway Attract allow you to use dynamic text replacements.

In both Image Templates and Copy Templates it is possible to use information from the job requisition and make it a part of your ad content. The logic, and replacements values, are the same for copy Image and Copy templates.

Dynamic Replacements - Cheat sheet

Below is a cheat sheet of commonly used replacement values that can be used in both text- and image generation. Depending on your internal processes and the limitations of your ATS, all values might not always be available. For example, if it's optional for the recruiter to assign a Role/Position to a job requisition you don't have a guarantee that it'll always be available. Make sure to verify which text replacements that are available to you.

Text replacements
Descriptions

{{title}}

The job requisition title from the ATS. It is sometimes long and descriptive, and is therefore best suited for use on images, and not in text.

{{role}}

The role/position of the job requisition. More usable within text sections than a full title.

{{locations.0.city}}

The city of the first specified location on a job requisition.

{{employer.name}}

The name of the job requisition's employer. This replacement is typically used by Recruitment & Staffing firms.

{{shortDescription}}

Typically a very short pitch for the job that the recruiter adds to the job requisition in the ATS. Suitable as a replacement to your Copy Template.

Image replacements
Descriptions

{{images.backgroundSmall}

An image uploaded by the recruiter to the ATS. Suitable as a replacement to your image library.*

{{employer.logoURL}}

Image URL with a link to an employer logotype. This replacement is typically used by Recruitment & Staffing firms.

*NB! Images with aspect ratios that don't fit into your template will be cropped automatically. Images larger than 10MB will be discarded. Always make sure to have an image library as a fallback.

Conditional values

Conditional values are great when you want to display a text only when a specific value is present on a job requisition. Generally, to display a conditional text at least three lines is required.

  • First we specify the condition (the value that should exist or be true)

  • Then we place the value we want to show

  • At last we put an end to the conditional part of our text.

Below is an example to display a specific text to show that a job is flagged as flexible remote. (Double slashes // and the text after it is just comments and should not be included in text replacements)

{{#remoteStatus.flexible}}     // If remoteStatus.flexible has value true
Flexible Remote                // Then show this text
{{/remoteStatus.flexible}}     // End conditional input here

It is also possible to do the same when a value is missing or is equal to the value false. Note that the only difference is on the first line where a # symbol has been replaced with a ^ symbol.

{{remoteStatus.flexible}}      // If remoteStatus.flexible has value false
Flexible Remote                // Then show this text
{{/remoteStatus.flexible}}     // End conditional input here

It is recommended to use conditional values if you have dynamic text replacements and cannot trust that they'll be available 100% of the time. This could be because it's not a field/setting that's mandatory for the recruiter to fill in on the job requisition in the ATS. One such example is if you're using {{shortDescription}} to fetch the ad text directly from your ATS. If that value - for whatever reason - isn't available, you risk publishing your ad without any text at all. By using conditional values you can make sure that your ads are using dynamic texts whenever it is available, and that they use your Copy Templates as a fallback.

Ad copy alternative using a text replacement.
Ad copy alternative populated with the vacancy's title.
Example of a Story template with dynamic text replacements and a populated ad.