Install through API - Shopify

Step by Step Installation

Follow this step by step guide to Install the Doofinder Shopify through API.

• If you are a new user, check this article to create a new Doofinder account.

If you have an account already or just created one, follow these guidelines:

Log in and Create Store in Doofinder

1. Log in to your Doofinder Admin Panel.
2. Click on "Create Store".

If you are new, a "Create store" button will appear on the front page. If you don't see it or prefer a different method, go to the top bar > click the "Store" dropdown menu > select "Create Store".


3. Once clicked, a pop-up window will appear where you need to enter the URL of your website, and select the platform you are using. Usually, Doofinder identifies the Shopify platform automatically.


Accessing Shopify API for Integration

4. Click on “Continue”. On the next panel, complete the Settings URL, Access Token, and API Secret Key fields. To do this, you will need to exit Doofinder. Do not close Doofinder’s Admin, leave the "Create Store" pop-up open, as you will be filling in each box in the following steps.

Next, open the Shopify admin in a new tab to find the Settings URL, the Access Token and the API secret key.

Go to Shopify > Settings > Apps and Sales Channels > “Develop Apps”.

If you haven’t developed apps before you will need to accept and click on “Allow custom app development” button, just as you observe below:


5. Click on “Create an app”. On the pop-up screen write “Doofinder” on the app name block. After the app is created click on “Configure Admin API Scopes”.


Select API Access Scopes

6. Once you are in the Admin API integration section, navigate to Admin API access scopes and select the scopes listed below:

To select them you can go through the list or look for them in the “filter access scopes” search bar:

• read_content
• read_locales
• read_products
• read_translations
• read_inventory
• read_markets
• read_publications
• read_themes
• write_themes

Verify that you have chosen all the scopes from the list above. Selecting the wrong scopes will result in errors after integration. Click on “Selected” on the Admin API Access Scopes menu to verify you have checked off all the scopes from the list.

Finally, click “save”. Look at the example below:



Adding API Credentials to Doofinder

7. Go to the API credentials section. Copy the URL appearing on the search bar and paste it into the Settings URL box in the store creation in the Doofinder Admin Panel.


Reveal Access Token and API Secret Key

8. Now, click on “Install app”, button, at the top-right side of the panel. Your access token will be created. In here, make sure to copy and paste the Access token and the API secret key. Keep on reading for easy directions:
• First, reveal the access token, copy and paste it in the "Access token" box in Doofinder.

Your Access token can only be revealed once. Make sure to reveal, copy and paste it in the store you are creating in Doofinder. If not, you will need to create the app and the store again.

• At the bottom of the same panel, you will find the API Key and secret key section. Reveal the API secret key, copy and paste it in the corresponding box in the store you are creating in Doofinder.

Reveal the API secret key. Make sure to reveal, copy and paste it in the store you are creating under the "API secret key" box. If you select the API Key, the creation of the store won't work.

Look at the example below:



As a result, your “Create Store” pop-up should contain:

1. The Settings URL from the API Credentials section.
2. The Access token, which starts with “shpat”, and can only be revealed once.
3. The API secret key, located at the bottom of the panel, on the API secret key section.

Your “Create Store” pop-up should look something like this:


9. With all the completed fields, click on “Continue”.

Create a New WebPixel

10. Create the Webpixel to track your conversion rate and other stats. Follow these instructions for a smooth configuration:
    1. Copy the code appearing in the “Create Store” pop-up.
    
    2. Access your Shopify Admin > Settings > Customer Events > click on “Add custom pixel”.
    3. Create a custom name and paste the code.
    4. Click on “save” and “connect”, so you are all set to monitor your conversion.
    

Activate the Script

The script is generated and activated automatically during the installation process.

To verify it is activated, follow these steps:

1. On your Admin Panel go to Configuration > Store Settings > Shopify.
2. Scroll down to Platform Configuration > Doofinder Script > the switch is enabled.

With this, Doofinder should be functioning correctly on your online shop.