Skip to content

DOTS.ECO

DOTS.ECOは、追跡可能なデジタル証明書を通じて、ユーザーに実際の環境インパクトを報酬として提供できるサービスです。各証明書には、共有可能な証明書URLや画像URLなどのメタデータを含めることができるため、ユーザーはインパクトの証明を閲覧（および再確認）することができます。

この統合はDOTS.ECOによって管理されています。

この統合について

BrazeとDOTS.ECOは、カスタマーエンゲージメントジャーニーを現実世界のインパクト報酬につなげます。BrazeのCanvasまたはCampaignステップから、コネクテッドコンテンツを使用してDOTS.ECO証明書作成リクエストをトリガーできます。DOTS.ECOは証明書メタデータ（certificate_urlやcertificate_image_urlなど）を返し、これをユーザープロファイルにカスタム属性として保存して、アプリ内メッセージ、Content Cards、プッシュ通知などのチャネルで再利用できます。

ユースケース

  • ユーザーがキーイベント（購入、レベル完了、サブスクリプション、紹介）を完了したときにインパクト証明書をトリガーする。
  • コネクテッドコンテンツのステップが成功した後、アプリ内メッセージでパーソナライズされた証明書画像を表示する。
  • 証明書URLを記載した「証明書を見る」Content Cardsを追加し、後からアクセスできるようにする。
  • 証明書メタデータ（certificate_url、certificate_image_url、certificate_header、greetingなど）をカスタム属性として保存し、将来のメッセージングで再利用できるようにする。
  • リモートユーザーIDを使用して証明書を割り当てることで、ユーザーが後からインパクトを請求・確認できるようにする。
  • 同じDOTS.ECOユーザー更新フローを維持しながら、インパクトメッセージング（異なるコピー/画像）のA/Bテストを実施する。

前提条件

始める前に、以下が必要です。

DOTS.ECOの統合

ステップ1：Canvasを作成し、ユーザー更新ステップを追加する

Brazeダッシュボードで、ユーザーがキーイベント（購入、サブスクリプション、マイルストーンなど）を完了したときにトリガーする新しいCanvasを作成します。

エントリステップの直後にユーザー更新ステップを追加します。このステップは、コネクテッドコンテンツ経由でDOTS.ECO APIを呼び出し、返された証明書データをユーザープロファイルに保存するために使用します。

このステップを使用して、コネクテッドコンテンツ経由でDOTS.ECO APIを呼び出し、返された証明書データをユーザープロファイルに保存します。

ステップ2：高度なJSONを作成する：コネクテッドコンテンツを使ってDOTS.ECOにPOSTリクエストを行う

ユーザー更新ステップで、Advanced JSON Editorに切り替え、コネクテッドコンテンツを使用してDOTS.ECO証明書APIにPOSTリクエストを行います。

captureタグとコネクテッドコンテンツリクエストを使用して、DOTS.ECOの証明書エンドポイントを呼び出します。次に、レスポンスをカスタム属性としてユーザープロファイルに保存します。

コネクテッドコンテンツとユーザー更新の例

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

{% capture post_body %}
{
  "remote_user_email": "{{${email_address} | default: 'braze+nadav@dots.eco'}}",
  "app_token": "YOUR_DOTS.ECO_APP_TOKEN",
  "impact_qty": 1,
  "remote_user_id": "{{${user_id} | default: ${braze_id}}}",
  "allocation_id": "YOUR_DOTS.ECO_ALLOCATION_ID"
}
{% endcapture %}

{% connected_content https://impact.dots.eco/api/v1/certificate/add?format=sdk
  :method post
  :headers { "auth-token": "YOUR_DOTS.ECO_AUTH_TOKEN" }
  :body {{post_body}}
  :content_type application/json
  :save result
%}

{
  "attributes": [
    {
      "certificate_image_url": "{{result.certificate_image_url}}",
      "certificate_url": "{{result.certificate_url}}",
      "certificate_id": "{{result.certificate_id}}"
    }
  ]
}

https://impact.dots.eco/api/v1/certificate/add?format=sdkにリクエストを送信します。

DOTS.ECOユーザー更新ステップ。

ステップ3：メッセージに証明書を表示する

証明書の属性がユーザープロファイルに保存されると、下流のCanvasメッセージステップで参照できるようになります。

DOTS.ECOフロー。

DOTS.ECOメッセージステップ。

DOTS.ECOメッセージ作成セクション。

以下に例を示します。

  • {{custom_attribute.${certificate_image_url}}}を使用して、アプリ内メッセージに証明書画像を表示する
  • {{custom_attribute.${certificate_url}}}を使用して、ホストされた証明書にリンクする

DOTS.ECOメッセージのクリック時の動作。

これにより、アプリ内メッセージ、Content Cards、またはプッシュ通知をインパクト確認でパーソナライズできます。

トラブルシューティング

Brazeダッシュボードの設定 > メッセージアクティビティログでコネクテッドコンテンツのエラーを確認してください。

  • コネクテッドコンテンツが空を返す：:save resultが設定されていること、および期待されるレスポンスフィールドを参照していることを確認してください。
  • 属性がメッセージステップに表示されない：
    • Brazeのカスタム属性名が、ユーザー更新ステップで設定した属性と完全に一致していることを確認してください。
    • ユーザー更新ステップで、Preview and testタブを使用して属性が入力されていることを確認してください。次に、ユーザーにテストを送信し、ユーザープロファイルに属性が保存されていることを確認してください。
  • 422エラー（処理不能なエンティティ）：アプリトークンとインパクト数量が有効であることを確認してください。
  • 401エラー：認証トークンが存在し、正しいことを確認してください。
  • メッセージステップに画像プレビューがない：ユーザー更新ステップでSend Test to Userを選択し、同じユーザーを使用してメッセージをプレビューしてください。
New Stuff!