Magento

Integration Notes

This extension supports the latest versions (1.7+) of Magento Community & Enterprise. Visit our Magento Marketplace page to download the extension.

Before you start

Here are some things to know before you begin this process.

  • You must have a Rejoiner account. If you are curious about Rejoiner, book a call with us. 
  • You will need to your Implementation Details when you set up an integration. 
A quick outline:

Connect to Magento

To integrate Magento with your Rejoiner account, follow these steps.

Install via Composer

  1. Magento 1 Rejoiner extension can be installed with the aid of the following command: composer require rejoiner/module-acr
  2. Then run: composer update
  3. Lastly, run the command below to update your Magento 1 database: php bin/magento setup:upgrade

Install by copying code

Please note that you should be logged in as a user with the permission to write to your Magento web server docroot. Typically, it can be the root (not recommended) or web server user.

Perform the following actions to install your module—make sure to enter the following commands keeping their order:

  1. First enter: cd /app/code
  2. Copy the downloaded file to your Magento server’s directory: /app/code/
  3. Run the following commands keeping their order: unzip rejoiner_.zip
  4. Find your /app/etc/config.php file and open it in a text editor.
  5. Add the below command under ‘modules’ ⇒ array ( 'Rejoiner_Acr’ ⇒ 1 )
  6. Save the changes and close the editor.
  7. Then run: php bin/magento setup:upgrade

Configuration instructions

  1. In your Magento admin, go to System > Configuration.
  2. In the left-hand nav click Sales > Checkout.
  3. You should see eCommerce Lifecycle Email by Rejoiner as a checkout configuration variable.
  4. Click and open the Rejoiner config settings.
  5. Sign in to your Rejoiner account. Go to Settings > Domain and look for your Implementation Details. Implementation Details
  6. You will need your Site ID, Domain, API Key. You do not need your Webhooks Secret.
  7. Head back to your Magento config. Enable the Rejoiner extension by setting drop down to Yes.
  8. Then, enter your Rejoiner Site ID and API Key.
  9. Finally, enter your site's Domain as per your Implementation Details.
  10. Click Save Config in the upper right hand corner of the Magento admin.

Next steps

Magento advanced features

The following features are available for Magento 1 integrations.

Dynamic Promo Codes

The dynamic promo code feature enables you to generate unique, 1-time use promo codes for use in your Rejoiner campaigns.

  1. From your Magento admin, build a new price rule by clicking Promotions > Shopping Cart Price Rule.
  2. Configure the new rule. Set the Coupon field to Specific Coupon and the Coupon Code field to Use Auto Generation.
  3. Set your desired Uses per Coupon and Uses per Customer

  4. From your Rejoiner Plugin settings inside of the Magento admin, set the Enable Cart Coupon Code and/or Enable Browse Coupon Code field to Yes, and select the price rule you just built from the drop down. 

  5. Cart coupons will be generated when the customer views their cart or initiates checkout. Browse coupons will be generated as soon as the user views any page on the site.
  6. Inject the unique promo code into your Rejoiner creative using the following template tags:
     For Cart coupons: {{ cart.promo }} For Browse Coupons: {{ session.metadata.promo }}
    	

    If you use a custom parameter name for the Cart coupon, it will be as metadata. For example: {{ cart.metadata.custom_parameter }}

Multiple Dynamic Codes

You can add additional coupon codes, and even use separate sales rules for them.

  1. Choose Add Code 

  2. Enter a Parameter Name for the additional code(s). 

  3. Make sure you select a sales rule for the additional code, and it can be different than the rule used by the first code. 

  4. The new code will then be injectable in your creative using the parameter you selected as metadata. For example: {{ cart.metadata.high_value_code }}

Google Analytics Query String Parameters

Enables merchants to append Google Analytics & custom query string parameters onto the cart regeneration URL. 1. Within the Rejoiner config settings in Magento, scroll down to Google Analytics Data 2. Configure your query string attributes. Campaign Source, Campaign Medium and Campaign Name are required attributes for Google Analytics tracking. 

You may also add custom query string parameters using the Customer Parameters table below:

Product Image Size

Follow the below steps if you want to change the size of the product image we inject into your emails.

In some cases, you may be passing very large images and those can get your emails to go to SPAM. In other cases, you may be passing very small images which may show very pixelated in your emails. Thus, please ask your designer and email developer what the optimal image dimensions are so that you pass us the exact image size you need.

To continnue, follow these instructions:

  1. Go to your Rejoiner Plugin settings inside of the Magento Admin.
  2. Configure the optimal image size you want to pass us by setting the width x height in the Thumbnail Default Size setting. 

     Example: 600x400 will pass us an image with the width of 600px and a height of 400px

  3. Lastly, click on Save Config to save your settings.

Accept Marketing Feature

This feature allows you to push all customers who opt into your marketing to be sent to a specific Rejoiner List. This will then allow you to send against that list in order to respect your customers' wishes.

Enabling this feature creates a simple checkbox for your customers to opt into your marketing. The checkbox then gets added into several parts of your store in order to be able to maximize this feature.

Note: You will need to create a List for these customers in your Rejoiner account before employing the steps below.

  1. First, you will need to enable this feature in your Rejoiner extension by selecting Yes in the Accepts Marketing Permissions Capture option. 

  2. Next, you will need to add the List ID of the Rejoiner List you want to use in the input of the Add Accepts Marketing List ID option like so:

  3. Next, you will se a couple of other options below the List ID input. We recommend the following set up: 

  4. Lastly, you will need to add the copy that will appear along the checkbox. This copy should be clear enough for your customers to know what they are opting into. 

     

  5. You will see some extra options that are related to the styling of this checkbox. Feel free to add extra CSS to modify this checkbox in the following option. 

  6. If you want to style the checkbox directly in your store's styles, you can specify a class for it in this option: 

  7. Once you're done making changes. Click on Save Config to save all changes.

Send Converted Customers to a List

Our integration with Magento 1 allows you to push all customers who complete a purchase to a specific Rejoiner List.

Note: You will need to create a List for these customers in your Rejoiner account before employing the steps below.

  1. Go to the List you'd like to push converted customers to and copy your List's ID 

  2. Head over to your Magento Admin > System > Configuration.
  3. Over to the left side you should see a Sales category with several options. Click on Checkout to continue.
  4. You should be able to see a section called eCommerce Lifecycle Email by Rejoiner, with the options below. 

  5. You will notice that one of the options says Pass new customers to Rejoiner. Use the dropdown on that option to select Yes. You will then see a blank input appear for the List ID you copied.
  6. Paste your List ID in the input. 

  7. Click on the Save Config button to save and apply your changes.

At this point, the email address of all customers who complete an order on your site will be pushed to your Rejoiner list.

Importing Current Subscribers to Rejoiner

This feature allows you to be able to filter current subscribers that did not subscribe via Rejoiner's Accepts Marketing feature and create a CSV to import into Rejoiner.

Note that all this feature adds a column to your subscribers table in Magento. This column then notes whether a customer was subscribed via Rejoiner's Accept Marketing feature or not.

To create a CSV of customers who did not subscribe via Rejoiner's Accepts Marketing feature, but who did opt into your newsletter at some point, we will need to filter these customers and then have Magento create a csv.

Steps to Follow: 

  1. Go into your Admin, then in the top nav look for Newsletter and then click on Newsletter Subscribers

  2. To filter current subscribers not subscribed via Rejoiner, go into the Added to Rejoiner column and select No in the column's dropdown option. 

  3. Next, make sure that your Select All column's option is set to Any

  4. Next, at the top right of your subscribers table, click the Search button so that Magento can find these customers in your subscribers table. 

  5. The table should now show you a list of all matching customers: 

  6. Now, you will want to to the Export to option. Select CSV as the format and click on Export.
  7. You should now have a CSV file in your browser's downloads.
  8. Upload the CSV to your desired Rejoiner list.
Note: Magento likely added extra information to the CSV you exported. We recommend you open this CSV file in Google Sheets or a similar software and eliminate any extra columns.

Have a question?

Contact us at integrations@rejoiner.com

Still need help? Contact Us Contact Us