Reference guide Magento integration 1 -...

1www.pure360.com

Magento integration 1.0Reference guide


Improving results together

2www.pure360.com


Version history

0.9

1.0

Version Date Author Modifications

20 September 2013

20 September 2013

Marcus Webb

Marcus Webb

Draft Version

Publication Version

3www.pure360.com


Contents

Version History....................................................................................................................................................................

Key Features of this Integration...........................................................................................................................................

Key Benefits of this Integration.......................................................................................................................................

Settings for the Magento Integration................................................................................................................................... API Config..........................................................................................................................................................

List....................................................................................................................................................................................... Newsletter....................................................................................................................................................... Email............................................................................................................................................................. Abandoned cart............................................................................................................................................. Cron manager................................................................................................................................................

Screenshots

Figure 1 - API Config Screen.................................................................................................................................................Figure 2- API Config - Validate Credentials...........................................................................................................................Figure 3 - List Module Disabled...........................................................................................................................................Figure 4 - List Module Enabled...........................................................................................................................................Figure 5 - Newsletter Module............................................................................................................................................Figure 6 - Email Module.....................................................................................................................................................Figure 7 - Abandoned Cart Module....................................................................................................................................Figure 8- Cron Manager.....................................................................................................................................................Figure 9 - Force Resync on Cron Manager Module.............................................................................................................

2

4

4 - 5

55 - 6

77 - 11

11 - 1212 - 1314 - 15

5677

101112141415

4www.pure360.com


What’s in Version 1.0?

Key Features of this Integration

• Full Synchronisation of Customer Data from Magento into PureResponse including the following fields:

• First Name • Last Name• Date Of Birth• Address data • Sign up date*• Last order date• Last order value• Last product• Total purchases• Total spend• Year to Date spend

• Create advanced segments within Magento and sync segments over to PureResponse** • Refine and segment customers using list filters in PureResponse• Support for Magento installation with multiple websites and stores • Configure sync rules at Global, Website or Store levels linked to different profiles within PureResponse• Send Transactional emails through PureResponse using a separate profile• Advanced set-up options for controlling frequency of syncs and log sync history• Real-time sync of new newsletter sign ups & customers into PureResponse• Automatically track amount of revenue generated and last product purchased by email campaign• Create automations within PureResponse based on synced list data• Efficient sync process to sync databases with millions of customers• Add Newsletter subscription option to any check out• Easy to set up with One-click install from the Magento Connect store • Developer-friendly configuration.• Built in Debug information assisting in rapid issue diagnosis and support• Sync databases with millions of customer records

Key Benefits of this Integration

• Maximise revenue from customers by segmenting based on purchase behaviour • Using targeted campaigns to move them along the Customer Lifecycle journey from interest to loyal customer

and advocate • Ability to increase customer loyalty by targeting infrequent purchasers and creating an incentive campaign• Grow and maintain loyalty by sending regular product emails to regular purchasers• Increase revenue by targeting big spenders with high ticket item product emails• Ability to increase engagement by sending a welcome campaign to new customers and subscribers• Drive brand advocacy by identifying VIP customers that are big spenders rewarding their loyalty based on

• Total lifetime spend• Last order value• Year to Date Spend

5www.pure360.com


• Real time communication with new sign-ups• Improve Deliverability and Brand reputation of Transactional emails by using PureResponse sending IPs• Measure and analyse email campaign success by tracking email revenue and products bought• Totally customisable Integration options for Magento environments with multiple websites or stores, enabling website or

store specific lifecycle campaigns• Increase revenue by sending Abandoned Cart emails to customers that exit with products still in their basket with three

specific triggers• Increase email subscribers by adding sign-up forms to key stages of the User journey Create successful campaigns by combining customer data imported from Magento with other PureResponse features such as dynamic content, split content testing and intelligent time sending

Settings for the Magento Integration

Now that you have your Magento Integration enabled, we will look in detail at each section of the Integration and review the options available to you. We cannot always tell you the exact values that are appropriate in each circumstance but you will be able to get a feel for what works best for your organisation and be able to tune the settings accordingly.

You may find that over time you wish to re-visit these settings and amend them to suit your business needs. If you need to, whilst doing this, refer to this guide as explanations are given. Remember also, that these settings are scope specific (i.e. they will work at the level at which they are configured, so if set at the GLOBAL scope level they will work for all Websites and Stores beneath the scope)

API Config

The API Config section is where the primary parameters of the Integration are set. It is unlikely once these are set that you would want to revise this once the initial configuration has taken place with the exception of the items indicated below:

Figure 1 - API Config Screen

6www.pure360.com


SettingsThe following options are available:

Unsubscribed or not.

When setting the Username and Password for each profile, click the Validate Credentials button on each profile enabled and assuming no errors occur, click the Save Config button.

Marketing ProfileHere you set the details of Username and Password provided to you for your Marketing profile.

Option

Option

Available settings

Available settings

Meaning or Usage

Meaning or Usage

Enable Module

Username

Password

Debug

Max Sync Items

Default Mode

api url

Advanced Config

Enable or Disable

Enable or Disable

Positive Integer Values

Positive Integer Values

A valid fully expressed URL

Enable or Disable

Enable or Disable the Pure360 Integration Module

The username provided to you for system access. Typically this ends in .sys and is named the same as your company or profile ( e.g. marketingresponse.sys )

The password provided with the above username, usually consisting of lowercase letters ( e.g. xqirjsve )

Enable or Disable the Debug mode for the Pure360 Integration. When enabled, log files can be examined in the Cron Manager section

The maximum number of rows of data from Magento to be synced with the PureResponse system. You may wish to revisit this when your system is running

Enabling this sets the Config for the entire Magento system. Disabling this allows you to set Config settings at lower levels such as Website and Store

You will be provided this URL as part of your setup. Typically this will be: http://paint.pure360.com

Enable or Disable the Advanced Configuration options, allowing editing of settings in the Cron Manager section

Figure 2- API Config - Validate Credentials

7www.pure360.com


List

Here is where you specify the List upload parameters. To enable this module, first change the settings for Enable Module to Enable. Click the Save Config button.

This brings up the following screen:

Figure 3 - List Module Disabled

Figure 4 - List Module Enabled

8www.pure360.com



List optionsThe settings here allow you to create and modify lists on the PureResponse system as well as initialise options such as Reporting of value of sale items in a campaign in the PureResponse system

Field MappingThis section allows you to selectively pull across which data is synchronised with the PureResponse system, enabling you to segment and filter data effectively within the PureResponse system. You do not need to synchronise all available data within Magento, but if you amend the data that you want to synchronise, you will cause Automations in the PureResponse system to cease functioning.

Note: You may also synchronise Customer Attributes if you are using them. These will be displayed in alphabetical order in the Customer Data Field Mapping section below.

Customer data field mappingAll fields are listed alphabetically, so this list may not be reflected in the exact same layout as the screenshot above shows, as your Customer Attribute fields may be interspersed between the preselected fields.

Option

Option

Available settings

Available settings

Meaning or Usage

Meaning or Usage

Enable Module

Tracking Token

Success Page Tracking

Created at

Customer Group

Customer Segment*

Date of Birth

First Name

Double Opt-in

List Status

Domain Name Filter

List Name

Enable or Disable

Checked or Unchecked







List Status

Enable or Disable the List Management Module

Free text area to create a named token for tracking sales in Magento

Enable whether Purchases within Magento are reported in the PureResponse system

The date the customer record was created in Magento

Which Magento Group the customer record sits in

The list of Segments the customer record sits in

Recorded Date of Birth of the customer

The First Name recorded in Magento against the customer record

Enable Double Opt-in for verifying if a user wishes to subscribe to the Newsletter

Shows the current state of the list within both Magento and PureResponse

Set this for filtering purposes to create test recipient lists( e.g. @mydomain.com )

The name for the list to sync with the PureResponse system

Option Available settings Meaning or Usage

9www.pure360.com


Gender

Last Name

Middle Name/Initial

Prefix

Suffix

Customer Attributes

Tax/VAT Number








The Gender recorded in Magento against the customer record

The Last Name recorded in Magento against the customer record

Any recorded Middle Name or Initial for the customer record in Magento

If the customer record has a prefix it will be displayed in this field

If the customer record has a suffix it will be displayed in this field

Synchronise selected Customer Attributes specific to your Magento installation with the PureResponse system (See note above)

Contains the customer VAT or Tax number record

Customer Address Field MappingThere are no custom objects here so this table is alphabetical

City

Company

Country

Fax

State/Province

Zip Code

Telephone

Street Address









The City recorded in Magento against the customer record

The company recorded in Magento against the customer record

The country recorded in Magento against the customer record

The Fax number in Magento recorded against the customer record

The State, Province or county recorded in Magento against the customer record

The Zip or Postal Code at which the Customer in the customer record resides

The provided telephone number in Magento (can be used to hold mobile data, and therefore conduct SMS campaigns to mobile phones)

The Street address for the customer record in Magento


10www.pure360.com


Customer Sales Field MappingThe data here relates to sales records against the customer.

List

Here you can enable or disable Newsletter functionality. Our Newsletter module is designed to replace the Newsletter module within Magento. The increased customisation within the module allows you to specify where on the site you can request that customers can add themselves to the mailing list. If enabled on the Guest Checkout the module will collect the email address and add this to the list along with the Date of Subscription, which Pure360 has added to the Newsletter Subscriber information. This now allows for historical tracking for the customer information, and will show any additions or amendments after the installation of the Integration. Whether this is collected for the first time or is an amendment of the Customer’s preferences, the information is synchronised with the PureResponse system in real-time.

Last Order Date

Last Product

Last Order Value

Total Purchases

Total Spend

Year to Date Spend







Contains the date of the Last item purchased on the Magento site

Contains details of the last Item purchased.

Contains the amount spent on the Last Item Purchased on the Magento site in the currency selected at this scope level

Sends the count of the total number of purchases held against the Customer Record

Sends the total amount of Money spent on the site in customer lifetime

Shows the total amount of Money spent on the site in the Year to Date


Figure 5 - Newsletter Module

11www.pure360.com



CheckoutUse the settings here to specify where you wish to see the Newsletter Subscription Checkbox and what the text following it will say.

Enable Module

Show on Guest Checkout

Show on Register Checkout

Show on Customer Checkout

Show if Already Subscribed

Checkbox Label Text

Checked by Default

Enable or Disable

Yes or No

Yes or No

Yes or No

Yes or No

Yes or No

Yes or No

Enable or Disable the Newsletter Module

If enabled, show the Newsletter Subscription checkbox here (with associated text)



If enabled, show the Newsletter Subscription checkbox irrespective of the Customer subscription status

Free text field allowing you to specify what to indicate to Customers that they can subscribe to the Newsletter here.

When the Newsletter Subscription checkbox is shown will be checked if the Customer has subscribed, or if no Subscription exists for the Customer, display on the basis of this setting (i.e. if Yes, display a tick in the box or if No, do not display a tick in the box)

Option

Option

Available settings

Available settings

Meaning or Usage

Meaning or Usage

Email

In this section you can enable or disable Transactional email functionality. If you disable this, Magento will revert to using its in-built transactional email handling, and you will not receive any reporting information back to the PureResponse system when emailing your Customers.

Figure 6 - Email Module

12www.pure360.com




Enable Module

Enable Module

Max Carts to Process

Enable or Disable

Enable or Disable

Enable or Disable the Transactional email Module

Enable or Disable the Abandoned Cart email Module

Numerical value indicating how many Abandoned Carts the system should attempt to process when running.

Option

Option

Available settings

Available settings

Meaning or Usage

Meaning or Usage

Abandoned Cart

Pure360 have introduced Abandoned Cart functionality to the Integration. This will enable you to re-visit potential lost income and attempt to convert this into revenue for the business. To cater for this, we have allowed for three triggers in the system which you can configure. Should you have other Abandoned Cart software already in place, you can hook into the triggers placed into the Magento System. This is covered in the Administration Guide.

Figure 7 - Abandoned Cart Module

13www.pure360.com


The Three TriggersAll three triggers work with the same settings, which are detailed below. The options selected will determine how and when the events take place, and which actions to take on that basis.

ActionsEvents OnlyThis will record the fact that a trigger has occurred within Magento. To make use of this within other Cart Abandonment modules or software, you will want to set the Trigger Action to this value and then modify the relevant config.xml file

All three triggers work with the same settings, which are detailed below. The options selected will determine how and when the events take place, and which actions to take on that basis.

Reminder EmailThis is the trigger that will cause the system to send an Abandoned Cart email to the Customer or Guest. You select the email that you wish to send in the drop-down option just below the Action selected.

Note: A Guest in this instance is someone who has entered details on Stage 1 of the Checkout process and as a result has provided an email address. If a Guest has not entered details on Stage 1 the Abandoned Cart will not be processed.

Clear CartThis enables you to clear the cart record. Once this is done, no further Abandoned Cart actions will be taken. It is therefore recommended that if the Abandoned Cart module is enabled that this is set as an action for either Trigger 2 or Trigger 3. Setting this for Trigger 1 is redundant, as it is better to disable the module if you do not require Abandoned Cart management.

Triggers 1, 2 and 3

Enable Module

Trigger Action

Trigger After

Message Template (Customer)

Message Template (Guest)

Enable or Disable

Events OnlyReminder EmailClear Cart

DaysHoursMinutes

Enable or Disable the relevant Trigger in question

This allows you to select what action to trigger when the above specified time period has elapsed.

This un-named drop-down allows you to choose the time frame to match the numeric value in the box above

This should be an integer numeric value

This drop-down allows you to select from template emails within Magento which email you are going to send to the customer.

This drop-down allows you to select from template emails within Magento which email you are going to send to the guest.


14www.pure360.com


Cron Manager

The Cron Manager section allows you to specify the frequency of the jobs that synchronise with the PureResponse system and also to view any related log files if the Debug Mode is enabled. We recommend setting Debug mode on in the early stages of using the Integration, as this will help with any issues you may report to our Integration Team or Customer Support Team.

Figure 8- Cron Manager

Job TableOn this screen you are able to modify the standard Cron entries or Force a resynchronisation of any jobs that are listed by clicking on the Force button. A maximum of 20 list jobs can be shown here. If you have more than 20 defined, you will be able to change the number displayed by clicking on the drop-down box here. The table below explains what the entries are that are shown in the Job Table.

Id

Code

Status

Details

Message

Scope

Unmodifiable

Unmodifiable

Unmodifiable

Unmodifiable

Unmodifiable

Unmodifiable

Internal reference to the cron job

A Reference name for the Job

The current status of the Job

The name of the list to be synchronised with the PureResponse system

Any additional diagnostic message that is relevant to the current or last execution of the job

Status field indicating the scope of the job to be run (either global, website or stores)

Table Entry Available settings Meaning or Usage

15www.pure360.com


Scheduled

Finished

Crontab

Executed

Unmodifiable

Unmodifiable

Crontab settings

Unmodifiable

Time the job is next scheduled to execute as reported by the PureResponse system

The last time the job finished executing, whether successful or unsuccessful

Here you can change the frequency with which these jobs run

The time the job last started executing

For a more detailed explanation of Cron than can reasonably be entered into here, please see this link: http://en.wikipedia.org/wiki/Cron

Clicking the Force button results in a message as shown below.

Clicking Force on the PURE360_CART_TRIGGER job will result in the Abandoned Carts defined in the Abandoned Cart section to be processed as per the settings defined there.

Pure360 LogsThis section is only shown if Debug Mode is set to Enable. You may either Download or Clear the logs here. You may be asked for the Downloaded Log files to assist with Diagnosis.

Figure 9 - Force Resync on Cron Manager Module

Date post:	06-Feb-2018
Category:	Documents
Upload:	vuongnga
View:	237 times
Download:	0 times

Reference guide Magento integration 1 -...

Documents