Scripts to Managing Internet Marketing Campaigns and Newsletters .

This documentation explains how to use IMA Scripts in order to :  

We assume that you have a good knowledge in HTML and JavaScript.

For any additional information or help, please contact New Object Support

1. Online Example

Let's try first an example, that shows the main usage of IMA Scripts: 

Later on, you can download and install IMA on your web server, and adapt the current IMA scripts according to your needs.

Click here to try the complete online example.

The following sections provides technical explatation on how to write those scripts. 

2. Adding a new visitor information into a IMA campaign opt-in list

In order to add a new visitor information into a IMA campaign opt-in list, please follow the steps described below:

2.a -Set the IMA entry point (DBdir)

DBDir variable should contain the IMA entry point .

For example, if your IMA entry URL is:

http://<your-host>/cgi-bin/ima.exe?ima=aaa&

then DBDir value will be aaa.

and the final code will be:

<INPUT type=hidden name=DBDir value = "aaa" >

2.b -Set the Campaign Target list (DbName)

DbName variable should contain the list id of your Campaign Targets list.

In the example below, the target list id is 105. You should replace this value by the list ID that was automatically generated by IMA when you first created the Campaign. Its value is displayed in the "List" section of your Campaign page as Target List. 

In our example you will use:

<INPUT type=hidden name=DbName value = 105 >

2.c - Create all the fields for the information you want to collect from the visitor

For example, in order to collect the user First Name, Last Name, and Email address, you should use the following field names:

<INPUT name=first_name>

<INPUT name=last_name>

<INPUT name=email>

IMA has more the 50 built-in collected information fields. Please refer to section: list of all "collected information" fields names below.

2.d - Set the CGI action to run IMA script .

The CGI action should be set to run an ima script:

<FORM action=/cgi-shl/ima.exe method=post encType=multipart/form-data>


3. Adding visitor information into a IMA Campaign opt-out list

In order to add a visitor information into the opt-out list, you simply need to change the DbName variable to contain the list id of your Campaign Remove list.

In the example below, the remove list is 106. Its value is displayed in the "list" section of your Campaign page as Remove List:

<INPUT type=hidden name=DbName value = 106 >

 

4. List of all "collected information" fields names

Here is the list of all the collected information fields name.

Each one of those fields can be used in your HTML page as follows:

<INPUT name=first_name>

You can use any style you want (text fied, multi lines field, check box,...) and there is no limitation on the size of the (text only) information you can store in each field.

email

first_name

 last_name
company title tel_work
tel_cell tel_home fax
url street city
postal_code state country
history leads next_contact_date
next_contact_time cat1 cat2
cat3 cat4 cat5
cat6 source remove
bad remarks keywords
html_format priority private
suffix recommended_by newsletter
updates free3 free4
free5 free6 free7
free8 free9 free10
free11 free12 free13
free14 free15 free16
free17 free18 free19
free20

 

5. Trigger Email Notification

In order to send email notification, you need to set up the following fields: 

 
email_from 
email_to 
email_cc
email_bcc
email_subject 
email_message