Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Before You Begin

...

AdBuilder provides your end users with customizable digital and print materials using InDesign-based templates. Upload custom InDesign templates and lock down specific parts of the design while leaving certain elements open to customization. End-users can easily swap out images and text and download the design for their own use, without the need for designer intervention. This article covers the setup of templates by an administrator; for information regarding using templates once they are available in a portal, see AdBuilder User Guide.

Note

AdBuilder is an add-on module. Please contact your account manager or sales@netx.net for purchase inquiries.

Anchor
Before
Before
Before you begin

AdBuilder requires:

  • A compatible InDesign document, see Creating an InDesign Template for AdBuilder for more information.
  • Ad builder requires a
  • A live InDesign server connected to your instance.
  • For more information on purchasing InDesign Server, please contact sales@netx.net. If
  •  If you are hosting your own NetX and IDS instances on-premise, see this guide: Integrate Adobe InDesign Server with NetX.
  • Ad builder requires a configured Brand Portal for your end user's interface. See Brand Portal Quick Start for how to configure a bare-bones Portal if you only need Brand Portal for use with Ad builder. For the full Brand Portal guide, look here

  • Ad builder requires that your InDesign file type align with All InDesign documents used with AdBuilder must be saved with the version of InDesign that matches the version of InDesign server you are currently running . At this time, this means your files must be saved using InDesign 2015.  on your NetX instance, e.g. if your server is using InDesign 2018, you would create and save your template while running InDesign CC 2018.
  • A configured portal. If the portal is only used to support AdBuilder, see the walkthrough below on how to configure a bare-bones portal configuration to run AdBuilder. 
  • InDesign files are vector-based, and must use an effective ppi PPI while exporting indd files your template files as pixel-based file formats. In order to standardize the size and resolution of all types of files downloaded via Adbuilder, your source templates must templates must be adjusted to 72ppi. This requirement will be abolished in the future as AdBuilder is developed with a greater variety of output options.

Activating Your Templates

First, take the template file you created and upload this to NetX. Please allow a couple of minutes for the file to fully upload to the system through the InDesign server. You may watch the upload bar from your selected folder so you can see when your file is completely uploaded.

Status
colourYellow
titlenote

...

Image Removed
 

...

You will see a list of InDesign template files which have been uploaded to NetX, each with a toggle switch in the Active column. Activate your template; this could take a couple of minutes. You will know your template is ready when the loading spinner has disappeared, the toggle has turned blue, and a pencil icon appears on the far righthand side, indicating your template is now ready to be configured. 

Image Removed

Configuring Templates

...

Status
colourYellow
titlenote

...

  •  

Activating templates

In order for your InDesign document to be used as a template, it must be uploaded to NetX and activated for use with AdBuilder.

  1. Upload your indesign documents to NetX.
  2. Use the Systems Image Added button along the lefthand navigational sidebar and navigate to the AdBuilder tab.
  3. Use the toggles under the Active column to activate or deactivate a template. If an active toggle is blue, the template is activated; if it is gray, the template is not activated.

Image Added

Configuring active templates

Once a template is activated, use the action menuImage Added and click Edit to configure the template:

Image Added

  1. Content block: This corresponds to a frame in your InDesign file; the name of each block will be the script label you applied to the frame during template creation. The image Image Added icon indicates that this block represents an image frame in the template. Use the drag Image Added icon to reorder your blocks. Reordering will change the order they appear to users when customizing their template, but will not affect the actual layout of the template in previews or downloads.
  2. Label: The block name, as it is shown while customizing your template in the portal. This does not need to be the same as your original script label name, though if no label is chosen here the script label will be used by default.
  3. Description: Any additional information you would like to provide your users customizing your finalized template.
  4. Source folder: The source folder for an image block determines the assets available for that particular block. Use the input line to type the name of the desired folder, then select it from the subsequent dropdown once the correct folder appears. Each image block can be configured with a unique folder. This field is required for all image blocks before the template can be saved and used in a portal. When generating a preview for your template, any image blocks will be filled by the asset with the smallest asset ID in the folder you use for that block.
  5. Text
  6. Collapse: This button will collapse the current block editing section so that only the block header is visible. Any collapsed blocks will still be
  7. marked by anImage Removed icon. There will be a Label and Description field, followed by Restriction, Text Type, and Default Value. 
    Restriction: There are three radio buttons here: Read Only, Hidden, and None. Read Only will use the Default Value of this block for its content, with your end users being able to see this value but not edit it. Similarly, Hidden will use the Default Value of this block, but your end users will not be able to edit or see this value until they have downloaded their finished template. None will show your end user any Default Value, but allow them to change and share this value.
    Text Type: These radio buttons will determine whether the text content will be styled as a Text Box, all on one line and with a limited character count, or a Text Area, which may span multiple lines and contain more text.
    Default Value: Placeholder text. If this block's restriction is set to Hidden or Read Only, the text here will be the text used for every template download using this template and configuration. 
    The Outputs checkboxes at the foot of the screen will allow you to determine the file formats which will be allowable for your end users to download this template. You must select at least one.  
    Image Removed
    Once you have finished configuring your template, use the Submit button to save, then Publish to publish your changes to your Brand Portal. Your template will then be available for use by end users. 
    Status
    colourYellow
    titlenote
     All image blocks must be configured with a folder source before your template will Publish. 
    Image Removed

...

If you only wish to use a Brand Portal for use with Ad Builder, these instructions will show you the minimum requirements for a functioning Portal that will allow your users to complete and download Templates. For a more in-depth look at the Brand Portal creation process, look here.  

...

Status
colourYellow
titlenote

...

Properties

...

Default Value

...

  1. reorderable.
  2. Content block: The Image Addedicon indicates that the block corresponds to a text frame. Text blocks, like image blocks, use the frame's script label as its name. Use the drag Image Added icon to reorder your blocks.
  3. Restriction: Determines whether your end users will be able to customize the current text block, using the radio buttons available. If a block is Read only, users viewing the template in the portal will be able to see the value for that block while customizing the template, but will not be able to edit the block in any way. Hidden blocks not only prohibit user edits, but also hide its default text. A selection of None allows users to apply new text values to the block while customizing the template, though any default text will still appear in the block and will be used if no alternate value is applied.
  4. Text type: Determines the text input style for the block. Box types will be single-line simple inputs; Text area are larger text blocks which allow for longer text entries and paragraph breaks.
  5. Default text: This text will appear in the current text block's input field by default. If a user does not enter a new value for the block when customizing the template, the default text will be used. If there is no default text, and a user does not enter a value, the script label will be applied instead. 
  6. Outputs: Determines which output file formats are available to users when they download their customized templates. Choose any number of file types between INDDJPGPDF, or PNG
  7. Save Publish: Save any template configuration settings including block order with the Save button. Publish makes your current configuration available in the portal; note that templates may only be published once all image blocks have assigned source folders. Update your template configuration by first saving any changes, then re-publishing the template. 
Note
iconfalse

Choosing a source folder for an image block that is either empty or bereft of image assets may cause unexpected behavior. Alternately, folders with more than thirty assets will only display the first thirty assets, according to their asset ID number.

Portal quick start

  1. Use the Systems Image Added button along the lefthand navigational sidebar and select Portals.
  2. Click the upper-left plus button to create a new portal.
  3. Give your new portal a Name. This name will be used for the portal's URL, but may be changed later. 
  4. Use the upper-left preview button to view your new portal.
  5. Access any published templates by clicking the Templates link in the portal header.

Image Added

Note
iconfalse

Make sure any users who need access to any AdBuilder templates have sufficient permission to view the assets in NetX, or they will not be able to use the template in the portal interface.  

Advanced

You can further limit your portal to AdBuilder-specific content in the following ways:

Restricting folder visibility

If you would like to limit users' access to non-AdBuilder assets, but still allow them to preview the original assets and any attribute data, you should:

  1. Organize any AdBuilder template files into a single folder structure. Make sure any users who need access to your template files have sufficient permission to view the original assets in NetX.
  2. Change the Folder field under your portal's Visibility section to the top level of your template folder tree.
  3. Change the Search folder field under your portal's Visibility section  to the top level of your template folder tree.
  4. Click Save.

The Assets tab along your portal's header will now be limited to AdBuilder-specific template assets, and any searches performed by your users will return only those assets contained in your assigned search folder. Note that if there are template files in your folder structure that have not been configured and published for AdBuilder, they will still be viewable while navigating the portal's folder structure.

Image Added

To limit your portal exclusively to the AdBuilder feature, remove the Assets tab from the portal's header. This will prevent your users from previewing any AdBuilder template files or their attributes. Note that any AdBuilder users must still have sufficient permission to view the original assets in NetX.

  1. Navigate to your portal setup's Menus tab. 
  2. Use the trash Image Added button to remove the Assets field from the lefthand Portal navigation list. It will still be available from the righthand Available links list if you would like to add it back later.
  3. Click Save.

The Assets tab along your portal header will no longer be available to any portal user.

Image Added

Troubleshooting

  • If your frames are not appearing as blocks in AdBuilder, make sure that unique script labels are applied to frames prior uploading the InDesign document to NetX. For more information regarding script labels and applying them to a frame in InDesign, see this guide.   
  • If your template's thumbnail appears as a placeholder thumbnail rather than a preview of your template while viewing gallery and asset detail contexts, check that your initial file has been saved using the proper InDesign version for your InDesign server.
  • If you have configured your template in NetX, but it is not appearing under the Templates tab in your portal, make sure you saved and published your template.

Properties

Property

Value

DescriptionRestart Required?
adbuilder.enabled

...

false

...

Related Topics

Creating an InDesign Template for AdBuilder

True / False

If this property is true, AdBuilder will be enabled and you will see its tab when accessing the Systems menu. If this property is false, this tab will not be available. 

Note that this feature still requires a live InDesign server connected to your instance. For more information on purchasing InDesign Server, please contact sales@netx.net. If you are hosting your own NetX and IDS instances on-premise, see this guide: Integrate Adobe InDesign Server with NetX.

Portal Administrator Guide

AdBuilder User Guide 

Yes