Salesforce Marketing Cloud

Follow this tutorial to get unique promo codes from Voucherify and send them to your customers via Salesforce Marketing Cloud.  

Contents

• AMPscript Configuration
• Step 1: Add your API endpoint and API keys
• Step 2: Add Voucherify Campaign
• Step 3: Map your Customer to Voucherify
• Step 4: Prepare the payload
• Step 5: Send the request
• Step 6: Verify the response
• Code Example

AMPscript Configuration

The integration between Salesforce Marketing Cloud and Voucherify allows you to request unique codes from Voucherify campaigns and pass them to your customers via Salesforce Marketing Cloud send-outs. This integration requires you to call Voucherify API using the Salesforce AMPscript. 

Using Salesforce AMPscripts and Dynamic Content, we're going to add Voucherify unique codes to Salesforce Marketing Cloud’s send-outs. You can use Voucherify campaigns with unique discount coupons, gift cards, loyalty cards, and referral codes. 

Go to your Salesforce Marketing Cloud account and prepare a new send-out script.

To get a unique code for a specific customer, you need to do the following:

• Add the HTTPPost function to communicate with Voucherify. This function will use one of the Voucherify methods to get a unique code.
• Call Voucherify Create Publication API to retrieve a unique code.

When calling the Create Publication method in Voucherify API, you need to define which customer should be assigned to a particular coupon code. 

Here is a code snippet with an example AMPscript configuration.

Step 1: Add your API endpoint and API keys 

If you don't know what your API endpoint is, you can check it in the Project settings > General > API endpoint.

The table below shows an example list of clusters and associated endpoints.

Copy your API keys from the Project Settings > Application Keys.

Step 2: Add Voucherify Campaign

Replace the campaign_id_value variable with your Voucherify campaign identifier.

You can find the campaign id in the URL while displaying campaign details in the dashboard. This campaign will be the source of codes for your send-out. 

Step 3: Map your Customer to Voucherify

    /* Get customer data from SalesForce Marketing Cloud  */     SET @salesforce_customer_id = _subscriberkey
	

Step 4: Prepare the payload

The payload defines the customer who is to receive the code and the campaign from which the code will issued.

    /* Prepare the payload */
    SET @payload = Concat('{ 
        "campaign":",' @campaign_id, '", 
        "customer":",' @salesforce_customer_id, '", 
        "channel":"Salesforce Marketing Cloud", 
        "source_id":"' @source_id'"}')

Step 5: Send the request

Salesforce will use the prepared data to send a request to Voucherify. Voucherify will verify if a voucher can be issued and will return it to the AMPscript.

Step 6: Verify the response (optional)

Verify if the request was successful. If you do not receive a voucher, you can prevent the send-out.

Voucherify may not return a successful response if you have a static campaign. For a static campaign, Voucherify does not generate new codes once all of the codes in the current batch are assigned to customers. You can change your campaign settings using the Auto-update feature in the Campaign Manager to ensure that the number of codes initially created does not run out. This way Voucherify will add a new batch of codes once you have and you assigned all of the coupons in the campaign to other customers.

Finally, you need to add the following code snippet to the body in order to display the published voucher code.

Code Example

We just went through the above example workflow to show you how to configure the AMPscript to get unique promo codes from Voucherify. Below you will find an example code block. 

%%[
    /* Set connection data */
    SET @appID = "VOUCHERIFY-APP-ID"
    SET @appSecretKey = "VOUCHERIFY-SECRET-KEY"
    SET @targetURL = https://{{cluster}}.api.voucherify.io/v1/publications

    /* Set Voucherify's campaign ID - the source of vouchers */
    SET @campaign_id = "campaign_id_value"
    
    /* Get customer data from SalesForce Marketing Cloud  */
    SET @salesforce_customer_id = _subscriberkey

    /* Prepare the payload */
    SET @payload = Concat('{ 
        "campaign":"', @campaign_id, '", 
        "customer":"', @salesforce_customer_id, '", 
        "channel":"Salesforce Marketing Cloud" 
        }')

    /* Send the request */
    VAR @request, @response
    SET @request = HTTPPOST(
        @targetURL,
        "application/json",
        @payload,
        @response,
        "X-App-Id",
        @appID,
        "X-App-Token",
        @appSecretKey
    )

    /* If request failed, do not send out the message */
    IF @request != '200' THEN
        RaiseError('Request failed', true)
    ENDIF
]%%

<script runat="server">
  Platform.Load('Core','1');
  var resp = Variable.GetValue("@response");
  var json = Platform.Function.ParseJSON(resp);
  Variable.SetValue("@code",json.voucher.code)
</script>
 
Here is your voucher code: %%=v(@code)=%%