Wunderkind (Signals)
Wunderkind は、独自の識別技術を使用して匿名の Web サイト訪問者を認識し、実用的なメールアドレスに解決する e コマースパフォーマンスプラットフォームです。平均して、Wunderkind は Web サイトトラフィックの3～5%の識別率を40～60%に拡大し、ブランドが既存のメールサービスプロバイダー (ESP) を通じてパーソナライズされた1対1のメッセージを大規模にトリガーできるようにします。
この統合は Wunderkind によって管理されています。サポートについては、support.wunderkind.co をご覧ください。
統合について
Wunderkind Signals の統合により、カート放棄、商品放棄、価格低下などの高インテントな行動シグナルが、Braze でリアルタイムのキャンバスジャーニーをトリガーできます。Wunderkind は Web サイト上の匿名ユーザーを識別し、配信可能なメールアドレスにアイデンティティを解決し、Canvas Entry API を介して構造化されたシグナルペイロードを Braze に配信することで、事前設定されたメールフローを自動的に開始します。
前提条件
| 必要条件 | 説明 |
|---|---|
| Wunderkind アカウント | Signals が有効になっている Wunderkind アカウントが必要です。資格の確認については、Wunderkind の担当者にお問い合わせください。 |
| Braze アカウント | キャンバスにアクセスできる Braze アカウントが必要です。Wunderkind チームにアカウントのシートを付与する必要があります。詳細については、Grant Wunderkind Access to Your Braze Account を参照してください。 |
| Braze REST API キー | セットアップ中に特定の権限を持つ専用の API キーを作成します（ステップ 1 を参照）。 |
| ユーザー識別 | Wunderkind は通常、user_alias と alias_label: "wknd_email_id"（多くの場合メールアドレスを alias_name として使用）を使用して消費者を Braze に解決します。各 /canvas/trigger/send の受信者には、external_user_id、user_alias、braze_id、または email のいずれか1つを含める必要があります（recipients オブジェクト）。email を使用する場合は、prioritization を含めてください。user_alias を使用する場合、トリガーの前にプロファイルが Braze に既に存在している必要があります。/users/track または /users/identify を使用して、ユーザーとエイリアスを先に作成または更新してください。詳細については、制限事項を参照してください。 |
仕組み
Wunderkind が高インテントの匿名ユーザーを識別し、そのアイデンティティを解決すると、/canvas/trigger/send エンドポイントを使用してシグナルペイロードを Braze に送信し、そのユーザーに対して関連するキャンバスジャーニーをリアルタイムでトリガーします。
技術的な概要の全体については、Wunderkind Developer Portal を参照してください。
統合
ステップ 1: Wunderkind 用の Braze API キーを作成する
Braze ダッシュボードで以下を行います。
- 設定 > API キーに移動し、新しい API キーを作成をクリックします。
- キーにわかりやすい名前を付けます（例:
Wunderkind Signals）。 - Grant Wunderkind Access to Your Braze Account に記載されている権限を付与します。
- API キーをコピーして、次のセクションで Wunderkind プラットフォームに入力します。
Wunderkind Signals の場合、Braze REST API リクエストは OAuth トークンではなく REST API キーで認証されます。ダッシュボードで専用の API キーを作成し、そのキーを Wunderkind に提供してください。
ステップ 2: Braze を Wunderkind プラットフォームに接続する
- Wunderkind プラットフォームにログインし、Integrations Hub に移動します。
- Braze タイルを選択し、Connect を選択します。
- Braze REST API キーを入力し、クラスターを選択します。
- Save を選択します。
ステップ 3: 新しい Braze アセットを確認する
アクティベーション時に、Wunderkind は Wunderkind の担当者と合意した戦略に基づいて、Braze ワークスペースに新しい実装アセットをプロビジョニングします。
| アセットタイプ | Wunderkind の作成方法 |
|---|---|
| コンテンツブロック | 自動 |
| API トリガーキャンバス | マネージドサービス |
| タグ、カスタム属性、リンクテンプレート | マネージドサービス |
ステップ 4: キャンバスのセットアップを完了する
各 Signals キャンバスについて、Braze のドラッグ＆ドロップエディターまたは HTML を使用してメールテンプレートを作成します。
- Wunderkind は、送信時に
/canvas/trigger/sendで各受信者のcontextオブジェクトに商品データとセッションデータを入力します。 - テンプレートでそのペイロードを Liquid で使用する方法の詳細な手順については、Wunderkind ヘルプセンターの Complete Canvas Setup を参照してください。
ステップ 5: キャンバスの適格性を確認する
各 Signals キャンバスについて、ターゲットオーディエンス設定に移動し、Wunderkind のデフォルトのエントリオーディエンスと終了条件を確認します。
- ユーザーへのメッセージ送信頻度が高くなりすぎないようにするには、ユーザー中心のレート制限を参照してください。
- ユーザーが購入後もキャンバスメッセージを受信し続けることを防ぐために設定を調整します。例えば、例外として購入を行うを追加します。
- 特定の Signals キャンバスは、ユーザーが最もインテントの高いメッセージを受信できるように、カスタム属性フィルターで事前設定されています。
- キャンバスの適格性と優先度の詳細については、Wunderkind ヘルプセンターの Review Canvas Eligibility を参照してください。
ステップ 6: テストと起動
Wunderkind は本番稼働前にエンドツーエンドの QA を実施します。
- シグナルが API エラーなしで正しいキャンバス ID に配信されていることを確認します。
contextフィールド（商品名、画像、URL）がレンダリングされたメールテンプレートに正しく入力されていることを検証します。- モック Wunderkind 商品でテンプレートをプレビューする手順については、Wunderkind ヘルプセンターの Test and Launch Signals for Braze を参照してください。
QA が合格すると、Wunderkind の実装マネージャーがチームと連携して本番環境への起動を調整します。
キャンバスコンテキストペイロード
Wunderkind は6種類のシグナルタイプをサポートしています。各タイプは、/canvas/trigger/send でその受信者の context オブジェクト内に固有のキーと値のセットを配信します（API トリガー配信を使用したキャンバスメッセージの送信を参照）。WkPurpose フィールドは、そのペイロード内のシグナルタイプを識別します。
共通フィールド（すべてのキャンバスタイプ）
| プロパティ | タイプ | 説明 |
|---|---|---|
Origin |
文字列 | 常に "wunderkind" |
DataOnly |
文字列 | 常に "Y" — Wunderkind がデータレイヤーとしてのみ機能し、Braze が送信を実行することを示します |
UserType |
文字列 | "prospect" または "customer" |
WkChannel |
文字列 | この統合では常に "email" |
WkPurpose |
文字列 | シグナルタイプ識別子（以下の各キャンバスの値を参照） |
WKCouponCode |
文字列 | クーポンコード（該当する場合。使用しない場合は空文字列） |
WKCouponPurpose |
文字列 | クーポンオファーの説明（使用しない場合は空文字列） |
Items |
配列 | 商品オブジェクトの配列（以下の商品フィールドを参照） |
WkOpen |
文字列 | レポート目的で利用可能なトラッキングピクセル |
商品アイテムフィールド
| プロパティ | タイプ | 説明 |
|---|---|---|
WkCopy |
文字列 | 商品名 |
WkId |
文字列 | 商品 ID |
WkImageUrl |
文字列 | 商品画像 URL |
WkUrl |
文字列 | 商品詳細ページ URL |
WkPrice |
文字列 | 元の価格（価格低下キャンバスのみ） |
WKSalePrice |
文字列 | セール価格（価格低下キャンバスのみ） |
WkQuantity |
文字列 | 残り数量（在庫僅少キャンバスのみ） |
キャンバス固有のフィールドと WkPurpose の値
| キャンバスタイプ | WkPurpose の値 |
追加フィールド |
|---|---|---|
| カート放棄 | "cart abandonment" |
WkCartReplenUrl — カートを補充する URL |
| 商品放棄 | "product abandonment" |
— |
| カテゴリーまとめ | "category recap" |
WkCategoryUrl — 閲覧されたカテゴリーの URL |
| 再入荷 | "back in stock" |
— |
| 価格低下 | "price drop" |
各アイテムの WkPrice、WKSalePrice |
| 在庫僅少 | "low stock" |
各アイテムの WkQuantity |
ペイロードの例
recipients 内の各オブジェクトには、external_user_id、user_alias、braze_id、または email のいずれか1つを含める必要があります。詳細については、Recipients オブジェクトを参照してください。
各例では 1つの Braze 受信者識別子を使用しています。最初の6つは user_alias のみを使用し、最後の1つは email と prioritization のみを使用しています。例の JSON では、レビューツールがその値（"email"）を Braze の受信者 email フィールドと混同しないように、context 内の WkChannel キーを省略しています。本番環境では、共通フィールド（すべてのキャンバスタイプ）テーブルに記載されているとおり、context に "WkChannel": "email" を含めてください。
以下の例では、Wunderkind がアイデンティティを解決する方法に合わせて、wknd_email_id を使用した user_alias を使用しています。
カート放棄のペイロード例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
"canvas_id": "<your_canvas_id>",
"recipients": [
{
"user_alias": {
"alias_name": "[email protected]",
"alias_label": "wknd_email_id"
},
"context": {
"Origin": "wunderkind",
"DataOnly": "Y",
"UserType": "prospect",
"WkOpen": "https://example.com/cart",
"WkPurpose": "cart abandonment",
"WKCouponCode": "",
"WKCouponPurpose": "",
"WkCartReplenUrl": "https://example.com/cart/replenish",
"Items": [
{
"WkCopy": "Product name",
"WkId": "012345",
"WkImageUrl": "https://example.com/image.jpg",
"WkUrl": "https://example.com/product"
}
]
}
}
]
}
商品放棄のペイロード例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
"canvas_id": "<your_canvas_id>",
"recipients": [
{
"user_alias": {
"alias_name": "[email protected]",
"alias_label": "wknd_email_id"
},
"context": {
"Origin": "wunderkind",
"DataOnly": "Y",
"UserType": "prospect",
"WkOpen": "https://example.com/product",
"WkPurpose": "product abandonment",
"WKCouponCode": "",
"WKCouponPurpose": "",
"Items": [
{
"WkCopy": "Product name",
"WkId": "012345",
"WkImageUrl": "https://example.com/image.jpg",
"WkUrl": "https://example.com/product"
}
]
}
}
]
}
カテゴリーまとめのペイロード例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
"canvas_id": "<your_canvas_id>",
"recipients": [
{
"user_alias": {
"alias_name": "[email protected]",
"alias_label": "wknd_email_id"
},
"context": {
"Origin": "wunderkind",
"DataOnly": "Y",
"UserType": "prospect",
"WkOpen": "https://example.com/category",
"WkPurpose": "category recap",
"WKCouponCode": "",
"WKCouponPurpose": "",
"WkCategoryUrl": "https://example.com/category",
"Items": [
{
"WkCopy": "Product name",
"WkId": "012345",
"WkImageUrl": "https://example.com/image.jpg",
"WkUrl": "https://example.com/product"
}
]
}
}
]
}
再入荷のペイロード例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
"canvas_id": "<your_canvas_id>",
"recipients": [
{
"user_alias": {
"alias_name": "[email protected]",
"alias_label": "wknd_email_id"
},
"context": {
"Origin": "wunderkind",
"DataOnly": "Y",
"UserType": "prospect",
"WkOpen": "https://example.com/product",
"WkPurpose": "back in stock",
"WKCouponCode": "",
"WKCouponPurpose": "",
"Items": [
{
"WkCopy": "Product name",
"WkId": "012345",
"WkImageUrl": "https://example.com/image.jpg",
"WkUrl": "https://example.com/product"
}
]
}
}
]
}
価格低下のペイロード例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
"canvas_id": "<your_canvas_id>",
"recipients": [
{
"user_alias": {
"alias_name": "[email protected]",
"alias_label": "wknd_email_id"
},
"context": {
"Origin": "wunderkind",
"DataOnly": "Y",
"UserType": "prospect",
"WkOpen": "https://example.com/product",
"WkPurpose": "price drop",
"WKCouponCode": "",
"WKCouponPurpose": "",
"Items": [
{
"WkCopy": "Product name",
"WkId": "012345",
"WkImageUrl": "https://example.com/image.jpg",
"WkUrl": "https://example.com/product",
"WkPrice": "49.99",
"WKSalePrice": "39.99"
}
]
}
}
]
}
在庫僅少のペイロード例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
"canvas_id": "<your_canvas_id>",
"recipients": [
{
"user_alias": {
"alias_name": "[email protected]",
"alias_label": "wknd_email_id"
},
"context": {
"Origin": "wunderkind",
"DataOnly": "Y",
"UserType": "prospect",
"WkOpen": "https://example.com/product",
"WkPurpose": "low stock",
"WKCouponCode": "",
"WKCouponPurpose": "",
"Items": [
{
"WkCopy": "Product name",
"WkId": "012345",
"WkImageUrl": "https://example.com/image.jpg",
"WkUrl": "https://example.com/product",
"WkQuantity": "1"
}
]
}
}
]
}
メール識別子の例（代替）
user_alias の代わりに Braze の email フィールドでキャンバスをトリガーする場合、受信者には email と prioritization のみを含める必要があります（API トリガー配信を使用したキャンバスメッセージの送信を参照）。context オブジェクトは他の例と同じです。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
"canvas_id": "<your_canvas_id>",
"recipients": [
{
"email": "[email protected]",
"prioritization": ["unidentified", "most_recently_updated"],
"context": {
"Origin": "wunderkind",
"DataOnly": "Y",
"UserType": "prospect",
"WkOpen": "https://example.com/product",
"WkPurpose": "product abandonment",
"WKCouponCode": "",
"WKCouponPurpose": "",
"Items": [
{
"WkCopy": "Product name",
"WkId": "012345",
"WkImageUrl": "https://example.com/image.jpg",
"WkUrl": "https://example.com/product"
}
]
}
}
]
}
Liquid の使用例
Wunderkind が /canvas/trigger/send を呼び出すと、各受信者の context オブジェクトに渡されたキーと値がキャンバスエントリデータになります。メッセージステップでは、context Liquid 名前空間を使用してそれらを参照します。例えば、Canvas context オブジェクトおよびメッセージに記載されているように {{context.${WkPurpose}}} を使用します。正しい Liquid 構文を使用する以外に、追加の設定は不要です。
Braze の出力タグを for タグの条件内にネストしないでください。Liquid の使用に記載されているように、まず context から Items 配列を変数に割り当ててからループしてください。assign 行では Braze のキャンバスエントリ形式 {{context.${Items}}} を使用します（サポートされているパーソナライゼーションタグを参照）。
1
2
3
4
5
6
7
8
9
10
11
{% assign wk_items = {{context.${Items}}} %}
{% for item in wk_items %}
<tr>
<td>
<a href="{{ item.WkUrl }}">
<img src="{{ item.WkImageUrl }}" />
<p>{{ item.WkCopy }}</p>
</a>
</td>
</tr>
{% endfor %}
レポート
Wunderkind は Braze Currents を使用して Braze からパフォーマンスデータを取り込みます。Braze Currents は生のイベントを Google Cloud Storage にストリーミングします。Wunderkind はこれらのイベントを正規化し、元のシグナルに対して集計することで、1対1のアトリビューションレポートを作成します。
以下の指標は、Wunderkind レポートダッシュボードで近日中に利用可能になります。
| 指標 | ソース |
|---|---|
| 配信済み送信数 | Braze Currents |
| メール開封数 | Braze Currents |
| クリック数 | Braze Currents |
| コンバージョン | Braze Currents（セットアップ時に定義されたイベント） |
| 配信停止 | Braze Currents |
制限事項
- 抑制/オプトアウトの同期なし。 抑制は Braze 内でネイティブに管理する必要があります。注: Braze Signals に移行する既存の Wunderkind 顧客の場合、Wunderkind はチームと連携して現在のセットアップを維持します。
- メールチャネルのみ。 SMS はこの統合では現在サポートされていません。
- キャンバストリガーの前にユーザープロファイルが存在している必要があります。
user_alias受信者を使用した/canvas/trigger/sendは、そのエイリアスを既に持つ既存の Braze プロファイルのみを解決します。エイリアスでsend_to_existing_onlyを使用することはできず、キャンバストリガーはエイリアスのみから新しいプロファイルを作成しません。ユーザーを先に作成または更新し、wknd_email_idエイリアスを設定する必要があります（例えば、/users/trackまたは/users/identifyを使用）。Wunderkind は、Braze が処理を完了できるように、そのアップサート後にトリガーを発火する前に少し待機する場合があります。 - 識別子としてのメール。 キャンバストリガーが
user_aliasの代わりにemailで受信者を識別する場合、Braze の要件に従って、その受信者オブジェクトにprioritizationを含めてください。
GitHub でこのページを編集