Integrate your Magento store with Blueshift

If you run an e-commerce store using Magento, you can use our extension to integrate our platform with it. We will then get data from your store and you can use our platform to run campaigns for your users. Our extension for Magento makes it easy to integrate your store with our platform. 

Here's how to deploy our extension for Magento into your store:

  1. Sign in to the Magento marketplace.
  2. Search for the Blueshift connect extension. If you are signed in, click here to go to the extension page
  3. On the extension page, select your store's version and click Add to Cart.
  4. Click on the cart icon and then click Proceed to Checkout.  
    proceed_to_checkout.png
  5. Click Place Order on the Checkout page.
  6. Click Install on the confirmation page. You are taken to the access keys page. 
    install_the_app.png
    Ensure that your access keys are added to your store. For more information about adding your access keys to the store, see the System Config article on Magento documentation.
  7. Sign in to your Magento store's admin.
  8. On the left navigation panel, click System > Web Setup Wizard.
    web_setup_wizard.png
  9. On the Setup Wizard page, click Extension Manager.
  10. On the Extension Manager page, click Review and Install under <number of> Extensions Ready to Install.
  11. Click Install against blueshift/blueshiftconnect on the Ready to Install page. 
  12. Click Start Readiness Check on the Step 1: Readiness Check page. 
    readiness_check.png
    Let the readiness check complete and then click Next to go to the next step.
  13. In Step 2: Create Backup, you can either Create Backup or uncheck all the options and click Next.
  14. The extension is installed in the process extension status. If the extension is installed successfully, you can see the following message:
    app_bsft_1_install_magento.png
  15. If you run into issues at this step:
    1. Sign in to the server on which Magento is running
    2. On the server's terminal, change directory to the location where Magento is installed (for example, /var/www/html/magento)
    3. Run the following commands:
      sudo php bin/magento setup:upgrade
      sudo php bin/magento setup:di:compile 
    4. Run the following commands to let everyone get read and write access to the following directories:
      sudo chmod -R 777 var/ generated/
      sudo chmod -R 777 pub  
    5. After you run the commands above, run the following commands to flush the cache:
      php bin/magento cache:clean
      php bin/magento cache:flush

After you successfully run all the commands above, sign in to Magento admin again and verify if you can see Blueshift listed under stores. 

Magento_Blueshift_Installation.png

After you launch the extension, perform the following steps to integrate our platform with it:

  1. On our Magento extension's page, provide the user API key and the event API key from your Blueshift account and click Save Config. You can get those keys from the API keys tab on the Account Profile page
    app_magento.png
    If you run into an error, expand the Synchronization Data and Catalog section and choose a date in the From field. The fields in this section are described in the next step. 
  2. After the configuration is saved, provide the following details in the Synchronization Data and Catalog section:
    From

    Select the date from which you want to synchronize your store's data with our platform. You can choose a date that is as early as the date when you created your store. 

    The extension can fetch historical data of the users, products, and orders on your store since the date you started your store.

    Unsubscribe Data Select Yes if you want Blueshift to add the information that a user has unsubscribed to marketing communications sent from our platform to the user's profile on your Magento store. Otherwise, select No
    Catalog Name Select a catalog from the list of all catalogs that you created on our platform to which you want to add products of your Magento store. You can also create a new catalog. 
    New Catalog

    Click the Or Create a Catalog button to:

    • Enable this field
    • Provide a name for the catalog that you create
  3. Click Save Config.
  4. In the Status section, click Start Synchronization to synchronize data from your store with our platform. 

The extension uses JavaScript and Magento events to track events on your Magento store that occur when a user performs an action on your store, and sends them to our platform. Here is the list of events that the Magento extension collects:

  • The extension uses a JavaScript (that it inserts at the time of setup) to track the following events:
    • Login activities
      • Login
      • Logout
    • Views
      • Page views
      • Product views
  • The extension tracks the following events through the Magento events that it captures  
    • Cart activities
      • Cart create
      • Cart update
      • Checkout create
    • Order activities
      • Order create
      • Order cancel
      • Fulfilment create
      • Fulfilment update
      • Refund create
    • Customer related activities
      • Customer create
      • Customer update
      • Customer delete
      • Customer enable
      • Customer disable
    • Product related activities
      • Product create
      • Product delete
      • Product update

 

Was this article helpful?
0 out of 0 found this helpful