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"}')

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.

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>

%%=v(@code)=%%

Code Example

The above example workflow shows you how to configure the AMPscript to get unique promo codes from Voucherify. You can find an example code block below. Insert the code to a Code Snippet 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>

If you want to introduce the voucher code returned by the script, insert the following code into the Content Block:

%%=v(@code)=%%