Inkit
InkitとBrazeは、デジタルでもダイレクトメールでも、企業が安全に文書を作成・配布できるようにする。
BrazeとInkitの統合により、BrazeのWebhookを使って文書を生成し、Brazeユーザーに直接郵送することができる。
前提条件
必要条件 | 説明 |
---|---|
Inkitアカウント | このパートナーシップを利用するには、Inkitアカウントが必要である。 |
InkitのAPIキー<INKIT_API_TOKEN> |
このキーは、Inkitダッシュボードの 開発タブにあり、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ウェブフック・テンプレートを選択すると、以下のように表示される:
- ウェブフックのURL:空白
- リクエスト・ボディRaw Text
Webhook URLフィールドで、InkitのWebhook URLを作成し、入力する必要がある。
リクエストヘッダと方法
Inkitは、認証のために、Base 64でエンコードされたInkit APIキーを含む、HTTP Header
。以下はすでにキーと値のペアとしてテンプレート内に含まれているが、「設定」タブでは、<INKIT_API_TOKEN>
をあなたのInkit APIキーに置き換える必要がある。
- HTTPメソッド:POST
- ヘッダーをリクエストする:
- 認可する:ベーシック
{{ '<INKIT_API_TOKEN>' | base64_encode }}
- Content-Type: application/json
- 認可する:ベーシック
Request body
リキッドが以下の必須フィールドとオプションフィールドに関連する適切なカスタム属性と一致していることを確認する。また、どのリクエストにもカスタムデータフィールドを追加することができる。
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タグに該当するテキストは自動的にハイライトされる。street
このWebhookを送信するには、unit
、state
、zip
をカスタム属性として設定する必要がある。
Previewパネルでリクエストをプレビューするか、Testタブに移動して、ランダムなユーザー、既存のユーザーを選択するか、ウェブフックをテストするために自分でカスタマイズする。
ページを離れる前にテンプレートを保存することを忘れないこと!
更新されたWebhookテンプレートは、新しいWebhookキャンペーンを作成するときに、保存されたWebhookテンプレートリストで見つけることができる。