外部APIから取得したデータをBrazeの送信メッセージに含める
Brazeから送信されるメッセージ（Email, プッシュ通知、アプリ内メッセージ、コンテンツカードなど）は、外部のシステムからデータを取得し、メッセージ内に含むことができます。
メッセージを動的に挿入する方法としてBrazeではLiquidが利用できます。外部からデータを取得する際もLiquidを使用することになります。
※ LiquidはShopifyによって作成され、Rubyで記述されたテンプレート言語。オープンソースのプロジェクトとして利用できる
Brazeで利用できるLiquidのタグ一覧は以下
条件分岐や繰り返し処理も書くことができるので、よりパーソナライズされたメッセージを作成することも可能でしょう。
外部APIを呼び出す
外部APIを呼び出すには{% connected_content %}というタグを利用します。
使用例)
{% connected_content https://example.com/api :save result %}
取得したデータを:saveで変数に割り当てることができます
取得した結果は {{result.text}} です。
といったように、結果に割り当てた変数をメッセージに組み込むことができるようになります。
HTTPステータスコードの確認も可能で、__http_status_code__というキーを使用します.
{% connected_content https://example.com/api :save result %}
{% if result.__http_status_code__ != 200 %}
{% abort_message('おっと、何かおかしいようです') %}
{% endif %}
キャンペーンのメッセージに組み込んでみる
今回はアプリ内メッセージで試します。
キャンペーンのメッセージ作成タブの本文に{% connected_content %}タグを組み込みます。
天気予報を提供してくれるOpenWeather APIを使ってみました。
本文サンプル)
おすすめプランが設定されましたのでご紹介いたします
【ご紹介プラン内容】
・プラン名： [イチオシ]★コスパ最強＆公開枠★昼食付★割増なし
・お一人様の料金 ： 4,219円（総額 4,990円）
【周辺天気情報】
{% connected_content https://api.openweathermap.org/data/2.5/forecast?lat=35.66716&lon=138.568993&lang=ja&cnt=1&appid={{OpenWeathernのアプリID}} :save result %}
{{result.city.name}}の予報は "{{result.list[0].weather[0].description}}" です。
テストタブをクリックすると実際に{% connected_content %}タグの中身が実行され、結果が確認できました。
{{result.city.name}}の予報は "{{result.list[0].weather[0].description}}" です。
の部分が、
甲府市の予報は "雲" です。
となっていますね
OAuthにも対応できるので、認証が必要なAPIの実行も可能です。
さいごに
キャンペーンのメッセージに外部のシステムから取得したデータを組み込む方法を試しました。
この機能を使うことで外部で分析したデータからよりパーソナライズされたメッセージを提供する、ユーザーの地域によって言語を変える、人気の記事や動画を紹介するといったことをアプリケーションに組み込むことができるようになるのではないでしょうか。
