Inkit
Inkit と Braze により、デジタルでもダイレクトメールでも、企業が安全に文書を作成して配布することができます。
Braze と Inkit の統合により、文書を生成し、Braze Webhook を使用して Braze ユーザーに直接メールで送信できます。
前提条件
必要条件 | 説明 |
---|---|
Inkitアカウント | このパートナーシップを活用するには、Inkit アカウントが必要です。 |
Inkit API キー<INKIT_API_TOKEN> |
このキーは Inkit Dashboard の [Development] タブにあります。このキーにより Braze アカウントと Inkit アカウントを接続できるようになります。 |
Inkitテンプレート ID<INKIT_TEMPLATE_ID> |
テンプレートを作成した後、テンプレートタブからテンプレートIDをコピーしてBrazeのテンプレートで使用することができる。 たとえば、Inkit 環境にテンプレート ID: tmpl_3bDScFl9cwr3OAVR1RSdEC で invoice_template というテンプレートを作成できます。 |
HTTPヘッダー | HTTPヘッダーは、BrazeからInkitに送信するAPIリクエストの一部である。この中には、Inkit API の呼び出しを認証および許可するための Inkit API キーが含まれます。 |
統合
ステップ1:Inkit テンプレートを作成する
Inkitプラットフォーム上で、Brazeキャンペーンで使用するテンプレートをHTML、Word、PowerPoint、ExcelまたはPDFで作成する。詳細については、Inkit のドキュメントを参照してください。
ステップ2:BrazeのWebhookテンプレートを作成する
今後のキャンペーンやCanvasで使用するInkitウェブフックテンプレートを作成するには、Brazeプラットフォームの「テンプレート」>「ウェブフックテンプレート」に移動する。
古いナビゲーションを使用している場合は、「Engagement(エンゲージメント)」>「Templates & Media(テンプレート&メディア)」>「Webhook Templates(ウェブフック・テンプレート)」と進む。
単発のInkitウェブフックキャンペーンを作成したい場合、または既存のテンプレートを使用したい場合は、新しいキャンペーンを作成する際にBrazeのウェブフックを選択する。
Inkitウェブフック・テンプレートを選択すると、以下のように表示される:
- Webhook URL:空白
- リクエスト本文:Raw Text
[Webhook URL] フィールドで、Inkit Webhook URL を作成して入力する必要があります。
リクエストヘッダと方法
Inkit の認証には、Base64 でエンコードされた Inkit API キーを含む HTTP Header
が必要です。以下の内容はすでにキーと値のペアとしてテンプレートに含まれていますが、[設定] タブで <INKIT_API_TOKEN>
を Inkit API キーに置き換える必要があります。
- HTTPメソッド:POST
- リクエストヘッダー:
- Authorization:Basic
{{ '<INKIT_API_TOKEN>' | base64_encode }}
- Content-Type: application/json
- Authorization:Basic
Request body
Liquid が、以下の必須フィールドとオプションフィールドに関連付けられている適切なカスタム属性を照合することを確認します。また、どのリクエストにもカスタムデータフィールドを追加できます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"api_token": "<INKIT_API_TOKEN>",
"template_id": "<INKIT_TEMPLATE_ID>",
"first_name": "{{${first_name}}}",
"last_name": "{{${last_name}}}",
"email": "{{${email_address}}}",
"company": "{{custom_attribute.${company_name}}}",
"phone" : "{{${phone_number}}}",
"address_line_1": "{{custom_attribute.${address}}}",
"address_line_2": "{{custom_attribute.${address2}}}",
"address_city": "{{${city}}}",
"address_state": "{{custom_attribute.${state}}}",
"address_zip": "{{custom_attribute.${zip}}}",
"address_country": "{{${country}}}",
"source" : "Braze"
}
ステップ3:リクエストをプレビューする
生のテキストが適切な Braze タグである場合、このテキストが自動的に強調表示されます。この Webhook を送信するには、street
、unit
、state
、zip
がカスタム属性として設定されている必要があります。
Previewパネルでリクエストをプレビューするか、Testタブに移動して、ランダムなユーザー、既存のユーザーを選択するか、ウェブフックをテストするために自分でカスタマイズする。
ページを離れる前にテンプレートを保存することを忘れないこと!
更新されたWebhookテンプレートは、新しいWebhookキャンペーンを作成するときに、保存されたWebhookテンプレートリストで見つけることができる。