Adobe Commerce (Magento) Integration

This is a self-serve integration guide. For a more comprehensive setup, see the Adobe Commerce integration guide.

Follow the steps below to install and activate impact.com on your Adobe Commerce (Magento) e-commerce platform.

Install impact.com to Adobe Commerce via Composer

This guide follows the General CLI installation process provided by Adobe Commerce (Magento) — refer to their documentation for additional information about installing extensions via a CLI.

impact.com recommends installing the plugin via Composer — it’s easier to install, update, and maintain your installation versus a manual installation.

1. Using a terminal emulator, navigate to your root Adobe Commerce project directory and update your composer.json file with the following command:

Shell

$ composer require impact_tech/module-magento-integration

1. Enter your authentication keys — your public key is your username; your private key is your password. Wait for Composer to finish downloading and installing the impact.com plugin.

Shell

Updating dependencies (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
   - Installing impact_tech/module-magento-integration (X.Y.Z): Downloading (100%)
Writing lock file
Generating autoload files

1. Verify that the impact.com plugin has been installed properly with the following command:

Shell

 $ bin/magento module:status Impact_Integration

By default, the impact.com plugin should be installed and disabled.

1. To enable the impact.com plugin, use the following command to enable and clear any Adobe Commerce-generated static view files:

Shell

$ bin/magento module:enable Impact_Integration --clear-static-content

You should see the following output:

Shell

The following modules have been enabled:
Impact_Integration To make sure that the enabled modules are properly registered, run 'setup:upgrade'. Cache cleared successfully. Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes. Generated static view files cleared successfully.

1. Register the impact.com plugin with the following command:

Shell

 $ bin/magento setup:upgrade

1. Recompile your Adobe Commerce project using the following command:

Shell

$ bin/magento setup:di:compile

1. If you’re running Adobe Commerce in Production mode, deploy the module’s static files with the following command:

Shell

$ bin/magento setup:static-content:deploy

1. Verify that the impact.com plugin is enabled with the following command:

Shell

$ bin/magento module:status Impact_Integration

This command should return Module is enabled.

1. Finally, flush and clean the cache with the following commands:

Shell

$ bin/magento cache:flush
$ bin/magento cache:clean

Activate & Configure impact.com

The following instruction set shows how to enable the integration using the Adobe Commerce Admin Dashboard.

Activate impact.com

1. In the left navigation bar of the Adobe Commerce Admin Dashboard, select System → Integrations .

1. On the Integrations screen, find the ImpactIntegration line item and select Activate.

Confirm that impact.com can access the necessary files of your store by selecting Allow, then confirm that the integration reads Active under the Status column.

1. In the left navigation bar of the Adobe Commerce Admin Dashboard, select Stores → Configuration.

1. Select Impact Settings from the Impact section of the Configurations screen.
2. Scroll down to the Already have an impact.com account? and select Set up your integration.

1. Select Existing Customer and fill in all fields with your impact.com account information. Your impact.com account values appear in the table below — copy and paste these exact values into Adobe Commerce:

Account Data	Description
Impact Account SID	In the impact.com platform, from the top navigation bar, select [User profile] → Settings → API and copy your Account SID.
Auth Token	In the impact.com platform, from the top navigation bar, select [User profile] → Settings → API and copy your Auth Token.
Program ID	Enter your Program ID value. To find this value, select your brand name in the top-left corner of the impact.com app. Your Program ID is the numerical value under the program name.
Event Type ID	In the impact.com platform, from the top navigation bar, select [User profile] → Settings → Event Types. Copy the number in parenthesis next to the name of the event type.
Universal Tracking Tag	From the top navigation bar, select [User profile] → Settings → General. Paste your entire unique UTT code into this field.

1. In the top right corner of the screen, select Save Config.

Once the impact.com app is fully installed, you can begin end-to-end testing to ensure everything is working properly. Learn how to proceed with End-to-End Testing.