/
Associate Form and 'Save As New'

Associate Form and 'Save As New'

Platform URL

https://[enterprise].cvtr.io/v2/forms

API Endpoints

Fetch all associated forms

GET https://{enterprise}.cvtr.io/api/v4/campaigns

Update association

PUT https://{enterprise}.cvtr.io/api/v4/forms/{formid}

Remove association

POST https://{enterprise}.cvtr.io/api/v4/can-disassociate-form

DELETE https://{enterprise}.cvtr.io/api/v4/form-campaigns/{campaignid}

PUT https://{enterprise}.cvtr.io/api/v4/forms/{formid}

Save As New

Fetch campaigns

GET https://{enterprise}.cvtr.io/api/v4/campaigns

Include translated forms

GET https://{enterprise}.cvtr.io/api/v4/forms/{formid}

Save as new

POST https://{enterprise}.cvtr.io/api/v4/forms

Epic

https://convertr.atlassian.net/browse/GFR-50

Document status

DRAFT

Document owner

@Danny Hannah @Adam Carter

Technical writers

@Barnaby Murtagh (Unlicensed) @Arunima Kurup Prasad

Related Content

Forms

Feature Overview

Form Association allows users to select form they wish to assign to campaigns in order to process leads that are submitted via said form.

Name

Required

Notes

Campaign

Search input to select a Campaign to associate a form with.

Associate A Form To A Campaign

Once your form has been created, either from scratch or via CSV, you will need to associate it to a campaign.

  1. Within the Forms tab on the left navigation, select the link next to your form under the Associated Campaigns column:

    1. If you are associating a new form, this column will display "0 Campaigns"

      demo.png
    2. If associating a form which has existing campaign assiciations, the form will say "X Campaigns", based on the number of campaigns that that form is currently associated with.

      1. You can Associate by clicking the "X Campaigns" hyperlink

      2. Or by clicking ‘Edit’ in the ‘Actions’ column, and clicking the ‘Associate’ button

  2. Within the Campaigns field, select the campaign(s) dropdown.

  3. Select the Campaign you want to Associate the Form with.

  4. Click “Add”. The selected campaign is then displayed in a table. This will make the form available to the campaign(s). You can add multiple campaigns to a form at once. 

  5. Click ‘Save’ to persist the changes. The form will now be associated to the chosen campaigns.

How To Disassociate A Form From A Campaign

Note: You can archive a form whilst it still has associated campaigns. If you want to delete the Form then you will have to disassociate all connections i.e. Landing pages, Campaigns, Assets etc. and then it will be available to archive.

  1. Within the Forms tab on the left navigation, select the link within the Associated Campaigns column

  2. Click Remove beside each campaign

  3. Click 'Save' to remove the associated campaigns.

Save As New

The ‘Save As New’ button option is available in 2 places in Global Forms.

  1. Under ‘Actions’ column on the Active Forms listing page

  2. Or in the ‘Build’ panel when clicking the ‘Edit’ button of a form

The ‘Save As New’ option allows users to save an existing form with a new name, slug and different campaign associations.

This option is available only for ‘Master’ forms and not for ‘Translated' forms.

  1. Click on the ‘Save As New’ button available beside the form or in the ‘Edit Form’ interface. It opens up the ‘Save As New' modal shown below.

  2. On step 1 (Setup), provide a name for the new form. If the original form has associated translated forms, they can be included using the ‘Include Translated Forms’ toggle. If enabled, new (saved as new) version of the translated forms will also be created. If disabled, translated forms will be ignored.

  3. On Step 2 (Associate), the campaigns that need to be associated with the new form can be selected from the dropdown as shown below. User can associate multiple campaigns to the form.

  4. Similar to ‘Associate A Form To A Campaign’ section, associated campaigns will be displayed in a table as shown below.

    1. Clicking on the ‘Advertiser Name’ hyperlink will redirect the user to the Advertiser’s campaign listing.

    2. Clicking on the ‘Campaign Name’ hyperlink will redirect the user to the Campaign’s overview page.

  5. Associated Campaigns may be removed using the ‘Remove’ button. When all changes are made, user can save the changes by clicking on the ‘Save’ button.

  6. A new form is now created using ‘Save As New’ option, and associated translated forms are available on the Active Forms listing page.

    1. ‘Save As New’, ‘Edit’ and ‘Preview’ options are available beside the ‘Master’ form created.

    2. ‘Edit’ and ‘Preview’ options are available beside the ‘Translated’ forms created.

Summary

Functionality

User Story

Functionality

User Story

1

Associate Form to Campaign

User can ‘Add’ a form to a campaign so that leads can be submitted via the form and the submissions will be associated to the campaign.

2

Disassociate Form from Campaign

Users can ‘Remove’ a Form from a Campaign

3

Save As New

Users can use the ‘Save As New’ button to save an existing form with a new name, slug and campaign associations.

 User Permissions

Admins, agency users and creative manager users have access to Forms.

Agency users have edit permissions only if it is enabled at enterprise level.

https://docs.google.com/spreadsheets/d/1i4qTTKkC3rF3EyEOh2585ktDDGge0L0IMVDNCwriFR0/edit#gid=415459484

Related content

Add and Edit Form
Add and Edit Form
More like this
Active Forms > Listing
Active Forms > Listing
More like this
Archived Forms > Listing
Archived Forms > Listing
More like this
Forms
More like this
Campaign Listing
Campaign Listing
More like this
Create Campaign
Create Campaign
More like this