Lob

Lob.com は、ユーザーにダイレクトメールを送ることができるオンラインサービスである。

Braze と Lob の統合では、Braze Webhook と Lob API を使用して、手紙、ポストカード、小切手などを郵送します。

前提条件

統合

ステップ1:Lobエンドポイントを選択する

Webhook で要求する HTTP URL は、Lob に対して実行できるアクションごとに異なります。以下の例では、postcards APIエンドポイントhttps://api.lob.com/v1/postcards を使っている。すべてのエンドポイントのリストにアクセスして、ユースケースに適したエンドポイントを選択します。

ステップ2:BrazeのWebhookテンプレートを作成する

今後のキャンペーンやCanvasで使用するLobウェブフックテンプレートを作成するには、BrazeプラットフォームのTemplates>Webhook Templatesに移動する。

単発のLob Webhookキャンペーンを作成したい場合、または既存のテンプレートを使用したい場合は、新しいキャンペーンを作成する際にBrazeでWebhookを選択する。

新しいWebhookテンプレートで、以下のフィールドに記入する：

• Webhook URL: <LOB_API_ENDPOINT>
• リクエスト本文:Raw Text

リクエストヘッダと方法

Lob には、認証用の HTTP ヘッダーと HTTP メソッドが必要です。以下の内容はすでにキーと値のペアとしてテンプレートに含まれていますが、[設定] タブで <LOB_API_KEY> をご使用の Lob API キーに置き換える必要があります。このキーの直後に「:」が付加されており、またこのキーは64進数でエンコードされている必要があります。

• HTTPメソッド：POST
• リクエストヘッダー:
  • Authorization:Basic <LOB_API_KEY>:
  • Content-Type: application/json

Request body

Lob ポストカードエンドポイントのリクエスト本文の例を次に示します。このリクエスト本文は Braze の 基本 Lobテンプレートで提供されますが、他のエンドポイントを使用する場合は、それに応じて Liquid フィールドを調整する必要があります。

1
2
3
4
5
6
7
8
9
10
"description": "Demo Postcard",
"to": {
    "name": "{{${first_name}}} {{${last_name}}}",
    "address_line1": "{{custom_attribute.${address_line1}}}",
    "address_city": "{{custom_attribute.${address_city}}}",
    "address_zip": "{{custom_attribute.${address_zip}}}",
    "address_country": "{{custom_attribute.${address_country}}}"
},
"front": "https://lob.com/postcardfront.pdf",
"back": "https://lob.com/postcardback.pdf"

ステップ3:リクエストをプレビューする

この時点で、あなたのキャンペーンはテストと送信の準備ができているはずです。エラーが発生した場合は、LobダッシュボードとBraze開発者コンソールのエラーメッセージログを確認する。例えば、以下のエラーは、認証ヘッダーのフォーマットが正しくないために発生した。