Question 1

How to collect subscribers on XMTP & Push

Accepted Answer

How to Add Wallet Messaging Integration for Wallet-2-Wallet Messaging campaigns

Start by adding the following code snippet anywhere on your page. Make sure you add your API key from the settings page on your admin panel.

<script type="text/javascript" src="https://assets.getpercs.com/sdk/percs.js"></script> <script type="text/javascript">
&nbsp; // Must initialize with at least the clientKey before using the library or components
&nbsp; window.PERCS.init({
&nbsp; &nbsp; clientKey: "Add your API key from settings here",
&nbsp; &nbsp; apiHost: "https://api.getpercs.com",
&nbsp; })
</script>

Next copy and paste the following code snippet where you want to collect subscribers. Note: this will automatically trigger when your page loads.

<script type="text/javascript">
window.addEventListener("load", function() {
  window.PERCS.openModal({
    subscribe: {
      providers: ["xmtp_messaging"],
      required: true,
      headingImage: {
        src: "Add your image header url here",
      },
      headingText: "Subscribe to our updates!",
      successHeadingText: "Thanks for signing up!",
      successDescriptionText: "Be on the lookout for new product drops and exclusive offers in your inbox!",
    },
    gate: {
      description: "Get exclusive offers sent straight to your inbox!",
    }
  });
});

</script>
<percs-modal/>

headingImage - Image url that will be displayed on your pop-up.

headingText - Large text t

Question 2

Tokengating Products

Accepted Answer

Background

As part of a tokengating campaign the product or group of products included can either be added individually or as a group. Here's the instructions on how to do both

||| Note that products associated with tokengating campaigns with exclusive access to the product and a limited redemption per NFT can not be used in another tokengating campaign

|| The steps to add multiple products quickly is useful but not intuitive until you've done it a couple of times

Adding products individually

In the campaign creation page under the Products section click on the Add products button
From here you can select each product that will be part of the campaign individually | You can also filter products by name in the 🔍 Search products field at the top

Adding individual products to a tokengating campaign

Adding multiple products quickly

From the Shopify admin page select Products
Select the products that will be part of the campaign

There is an option to select all products
You can also filter by name or category

At the bottom of the screen there is a modal with buttons such as bulk edit, Set as Active etc. Click on the … more options button
Select Add PERCS in the dropdown menu

You may need to scroll to the bottom

You are now taken to the tokengating campaign creation screen wi

Question 3

How do I install the PERCS Shopify Plugin?

Accepted Answer

Background

Welcome! You can install the PERCS NFT Gating app on a Shopify store via this link. Once you've installed our app from the Shopify app store, you will need to embed our code snippet in order to get campaigns made in our plug-in to show up on your page.

Adding PERCS snippet to product template

From your admin panel select “Online Store” → “Customize”
Double click on a product category that will be part of a tokengating campaign (typically default product)
Under Product information click on “+ Add block” → Custom liquid
Double click on the Custom liquid now created and paste the following code

```html

{% liquid assign perc = false assign hideCart = false assign percCheckout = false for tag in product.tags if tag contains 'perc:' assign perc = true if tag contains 'perc: access' assign hideCart = true endif if tag contains 'perc: checkout' assign percCheckout = true endif endif endfor %} {% if perc %} {% if hideCart %}

{% endif %}

{% if percCheckout %} {% else %} {% endif %}

<script type="text/javascript" src="http

Question 4

Audiences - which wallets get past a tokengate

Accepted Answer

Background

The audience is the allow-list for the tokengating campaign. Typically this will be an erc-721 contract but PERCS also allows an uploaded csv with a list of eth based wallet addresses, or a snapshot from etherscan ,polyscan, or equivalent. When creating a campaign you can either add a new audience or select a previously added audience

|| Erc-1155 contracts can be added but naturally there are issues when trying to limit redemption per token ID. This is why PERCS recommends limiting erc-1155 audiences to a campaign with unlimited redemption per NFT. Alternatively you can use a snapshot or custom wallet list audience This is discussed in more detail in the Erc-721 versus erc-1155 section below

||| A major difference between using a smart contract address and uploading a csv is that PERCS will track which wallet holds the tokens in the smart contract address including after minting or transfers whereas a csv list of wallet addresses is static. This is discussed in more detail in the Smart contract audiences compared to uploaded csv audiences section below

${youtube}Audiences

How to add an audience

In the campaign creation page under the Audiences section click on the Add audience button

Add an audience

Add smart contract address audience

You can add an audience via a smart contract address for the following blockchains:

Question 5

Create exclusive access to a product with limited redemption per NFT

Accepted Answer

Background

Exclusive access to a product with limited redemption per NFT can be used to giveaway a product or limit access to it a set number of times per NFT. There are three main parts to creating this campaign

Remove the product from active sales channels
Create the tokengating campaign using the PERCS NFT Gating Plug-in
Create a landing page where users can redeem their NFT(s) for access to the product

More information such as a FAQ and support for this type of campaign can be found in this doc

Why create this campaign this way?

While this is the most complicated campaign to create using PERCS, there is support available via builders@getpercs.com. After the first campaign, most clients do not need assistance creating the second campaign. The challenge is worth it since it provides security that ensures that only the users on the allow-list can access the utility. This has been used by brands such as Robert Mondavi Winery to give away $3500 bottles of wine to their NFT holders without a fraudulent claim.

Remove the product from all sales channels

Doing these steps will remove the possibility of someone forcing the product into a cart

From the Product screen ensure that the “Product status” is set to “Active”
Under Product status click “__Manage

Question 6

Create exclusive discounts on product(s) for NFT holders

Accepted Answer

Background

Exclusive discounts for NFT holders is an excellent way to provide utility to and connect with your community. When creating a tokengated discount campaign PERCS will automatically create a discount rule in your Shopify store, while these values can be edited it's important to be mindful of what these changes can impact. The main reason to do so is discussed in the Combining discounts section below and this doc

${youtube}User experience with a tokengated discount campaign

Discounts on a Shopify Store

Since the discounts are created on the Shopify platform all the discount rules created by Shopify trump any settings created by PERCS. This information can be found in this doc by Shopify

Combining discounts

When creating a tokengated discount campaign the discount rule is set to not combine with other discounts by default. These values can be edited with more information on how to do so in this doc

As stated in the above section discount rules created by Shopify trump any settings created by PERCS. More details on Shopify's discount combination rules can be found in this doc by Shopify. These rules

Frequently Read Articles

Browse All Categories