optilyz

optilyz is a direct mail automation platform that enables you to run more customer-centric, sustainable, and profitable direct mail campaigns.

This integration is maintained by optilyz.

통합 정보

Use the optilyz and Braze webhook integration to send your customers direct mail such as letters, postcards, and self-mailers.

Prerequisites

Use cases

Running direct mail like a digital channel means moving away from mass mailings and leveraging the channel as part of your (digital) customer journeys. The benefits of a modern approach to direct mail are:

• Increased conversion rates via increased relevance, additional use cases, easier A/B testing, and cross-channel effects
• Reduced effort via automation and an end-to-end solution
• Reduced cost via frame contracts and cost transparency

Integration

To integrate with optilyz, use the optilyz API to send recipient data to the Braze webhook.

Step 1: Create your Braze webhook template

To create an optilyz webhook template to use in future campaigns or Canvases, navigate to Templates > Webhook Templates in the Braze platform.

If you would like to create a one-off optilyz webhook campaign or use an existing template, select Webhook in Braze when creating a new campaign.

In your new Webhook template, fill out the following fields:

• Webhook URL: The Webhook URL is unique to each customer and your optilyz customer success manager will provide it to you.
• Request Body: Raw Text

Request headers and method

optilyz also requires an HTTP Header for authorization and an HTTP method. The following will already be included within the template as a key-value pair, but in the Settings tab, you must replace the <OPTILYZ_API_KEY> with your optilyz API key. This key must include a “:” directly after the key and be encoded in base 64.

• HTTP Method: POST
• Request Headers:
  • Authorization: {{ '<OPTILYZ_API_KEY>:' | base64_encode }}
  • Content-Type: application/json

요청 본문

In the following request body, you can use any Liquid personalization tags and build a custom request template according to optilyz’ API documentation.

The variation field is optional and can define which design inside the automation should be used. If a variation is omitted, optilyz will assign one of the defined variations randomly.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
    "address": {
        "title": "{{custom_attribute.${salutation}}}",
        "firstName": "{{${first_name}}}",
        "lastName": "{{${last_name}}}",
        "street": "{{custom_attribute.${street}}}",
        "houseNumber": "{{custom_attribute.${houseNumber}}}",
        "address2": "{{custom_attribute.${address2}}}",
        "zipCode": "{{custom_attribute.${zipCode}}}",
        "city": "{{custom_attribute.${city}}}",
        "country": "{{custom_attribute.${country}}}"
    },
    "variation": {{custom_attribute.${designVariation}}}
}

2단계: Preview your request

Next, preview your request in the Preview panel or navigate to the Test tab, where you can select a random user, an existing user, or customize your own to test your webhook. 페이지에서 나가기 전에 템플릿을 저장하는 것을 잊지 마세요!