Documentation

Introduction

The role of this application is to generate CSV templates based on the input provided by the user. This App will generate 4 CSV files (refs.csv, groups.csv, keywords.csv and ads.csv), those files will be stored in a ZIP archive, that archive will downloaded automatically after clicking the submit button.

Form

  1. Campaign

    Campaign is a required field, if you didn't provide it an error will returned. The Campaign will be used as the name of the ZIP archive.

  2. Refs

    Refs this field too is required, you must provide a list of refs(one per line). Empty lines will be ignored.

  3. Groups

    Ad Group this filed too is required, you must provide a non empty string. You can use modifiers on this field.

    Examples of templates & modifiers: Let suppose ref equal Erskine Park

    Ad Group Result
    WH > NSW > {{ ref }} WH > NSW > Erskine Park
    WH > NSW > {{ ref | replace({' ':'+'}) }} WH > NSW > Erskine+Park
    WH > NSW > {{ ref | replace({' ':'-'}) }} WH > NSW > Erskine-Park
    WH > NSW > {{ ref | replace({'Erskine Park':'St Clair'}) }} WH > NSW > St Clair
    WH > NSW > {{ ref | replace({'Erskine Park':'St Clair'}) | replace({'Clair':'Marys East'}) }} WH > NSW > St Marys East

  4. Keywords

    Keywords are optional. If all fields are empty, the keyword will be ignored. You can use templates & modifiers on those fields, see examples of templates & modifiers.

  5. Ads

    Ads (same as keywords).

Modifiers
Modifier Role Examples
capitalize capitalizes a value {{ 'my first car'|capitalize }} My first car
lower Converts a value to lowercase {{ 'WELCOME'|lower }} welcome
title Returns a title-cased version of the value. Words will start with uppercase letters, all remaining characters are lowercase {{ 'my first car'|title }} My First Car
trim Strips whitespace (or other characters) from the beginning and end of a string {{ ' I like Twig. '|trim }} I like Twig.
upper Converts a value to uppercase {{ 'welcome'|upper }} WELCOME