ローカルコネクテッドコンテンツ変数

Brazeは、connected_contentタグ内に指定されたエンドポイントに送信時に標準のGETリクエストを行います。エンドポイントがJSONを返す場合、それは自動的に解析され、connectedという変数に格納されます。エンドポイントがテキストを返す場合、それはconnected_contentタグの代わりにメッセージに直接挿入されます。

応答を変数に保存したい場合は、JSONオブジェクトを返すことをお勧めします。そして、コネクテッドコンテンツの応答でタグをテキストに置き換えたい場合は、応答が有効なJSONではないことを確認してください（[json.org]46)

URLの後に:save your_variable_nameを指定して、データを別のものとして保存することもできます。例えば、次のconnected_contentタグは、localweatherというローカル変数に応答を保存します（複数のconnected_content JSON変数を保存できます）：

1
{% connected_content https://www.metaweather.com/api/location/2459115/ :save localweather %}

Metaweatherは、地域の天気を返すために「Where-on-Earth ID」を使用する無料の天気APIです。テストと学習の目的でのみこのコードを使用してください。

格納された変数は、connected_contentリクエストを含むフィールド内でのみアクセスできます。例えば、メッセージとタイトルフィールドの両方でlocalweather変数を使用したい場合は、両方のフィールド内でconnected_contentリクエストを行う必要があります。リクエストが同一である場合、Brazeは送信先サーバーへの2回目のリクエストを行うのではなく、キャッシュされた結果を使用します。ただし、コネクテッドコンテンツの呼び出しはHTTP POST経由ではデフォルトでキャッシュされず、送信先サーバーに2回目のリクエストを行います。POST呼び出しにキャッシュを追加したい場合は、cache_max_ageオプションを参照してください。

JSON解析

コネクテッドコンテンツは、:saveを指定すると、JSON形式の結果をローカル変数に解釈します。例えば、天気関連のコネクテッドコンテンツエンドポイントは、次のJSONオブジェクトを返します。これを:save localweatherを指定してローカル変数localweatherに格納します。

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
{
  "consolidated_weather": [
    {
      "id": 5.8143475362693e+15,
      "weather_state_name": "Clear",
      "weather_state_abbr": "c",
      "wind_direction_compass": "WSW",
      "created": "2017-06-12T14:14:46.268110Z",
      "applicable_date": "2017-06-12",
      "min_temp": 22.511666666667,
      "max_temp": 31.963333333333,
      "the_temp": 27.803333333333,
      "wind_speed": 6.8884690250312,
      "wind_direction": 251.62921994166,
      "air_pressure": 1021.335,
      "humidity": 50,
      "visibility": 14.945530601288,
      "predictability": 68
    },
    .
    .
    .
    "title": "New York",
    "location_type": "City",
    "woeid": 2459115,
    "latt_long": "40.71455,-74.007118",
    "timezone": "US\/Eastern"
  }

雨が降っているかどうかをテストするには、{{localweather.consolidated_weather[0].weather_state_name}}を参照してください。これをこのオブジェクトで使用すると、Clearが返されます。もし結果の場所の名前でもパーソナライズしたい場合は、{{localweather.title}}はNew Yorkを返します。

次の画像は、設定が正しく行われている場合にダッシュボードで表示される構文のハイライトの種類を示しています。また、例のconnected_contentリクエストを活用する方法も示しています！

1
2
3
4
5
6
7
8
9
10
{% connected_content https://www.metaweather.com/api/location/search/?query={{custom_attribute.${customCity}}} :save locationjson %}
{% connected_content https://www.metaweather.com/api/location/{{locationjson[0].woeid}}/ :save localweather %}

{% if {{localweather.consolidated_weather[0].weather_state_name}} == 'Rain' %}
It's raining! Grab an umbrella!
{% elsif {{localweather.consolidated_weather[0].weather_state_name}} == 'Clouds' %}
No sunscreen needed :)
{% else %}
Enjoy the weather!
{% endif %}

APIが{{localweather.consolidated_weather[0].weather_state_name}}でRainを返した場合、ユーザーはこのプッシュを受け取ります。

デフォルトでは、コネクテッドコンテンツはContent-TypeヘッダーをGET HTTPリクエストに設定し、それをapplication/jsonにAccept: */*で送信します。別のコンテンツタイプが必要な場合は、タグに:content_type your/content-typeを追加して明示的に指定してください。Brazeは、指定したタイプにContent-TypeおよびAcceptヘッダーの両方を設定します。

1
{% connected_content http://numbersapi.com/random/trivia :content_type application/json %}

HTTP POST

デフォルトでは、コネクテッドコンテンツは指定されたURLにHTTP GETリクエストを送信します。代わりにPOSTリクエストを行うには、:method postを指定します。

指定された:bodyの後にkey1=value1&key2=value2&...形式のクエリ文字列またはキャプチャされた値への参照を指定することで、オプションでPOSTボディを提供できます。Content-Typeのデフォルトはapplication/x-www-form-urlencodedです。:content_type application/jsonを指定し、key1=value1&key2=value2のようなフォームURLエンコードされた本文を提供すると、Brazeは送信前に自動的に本文をJSONエンコードします。

デフォルトコンテンツタイプ

1
{% connected_content https://example.com/api/endpoint :method post :body key1=value1&key2=value2 %}

Application/JSON Content-Type

1
{% connected_content https://example.com/api/endpoint :method post :body key1=value1&key2=value2 :content_type application/json %}

JSONボディの提供

独自のJSONボディを提供したい場合、スペースがない場合はインラインで記述できます。体にスペースがある場合は、割り当てまたはキャプチャのステートメントを使用する必要があります。つまり、これらの3つのいずれも受け入れられます:

インライン：スペースは許可されていません

1
{% connected_content https://example.com/api/endpoint :method post :body {"foo":"bar","baz":"{{1|plus:1}}"} :content_type application/json %}

キャプチャ文の本文：スペースが許可されている

1
2
3
4
{% capture postbody %}
{"foo": "bar", "baz": "{{ 1 | plus: 1 }}"}
{% endcapture %}
{% connected_content https://example.com/api/endpoint :method post :body {{postbody}} :content_type application/json %}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{% capture postbody %}
{
"ids":[ca_57832,ca_75869],"include":{"attributes":{"withKey":["daily_deals"]}}
}
{% endcapture %}

{% connected_content
    https://example.com/api/endpoint
    :method post
    :headers {
      "Content-Type": "application/json"
  }
  :body {{postbody}}
  :save result
%}

代入文の本文：スペースが許可されている

1
2
{% assign postbody = '{"foo":"bar", "baz": "2"}' %}
{% connected_content https://example.com/api/endpoint :method post :body {{postbody}} :content_type application/json %}

HTTPステータスコード

コネクテッドコンテンツ呼び出しからHTTPステータスをローカル変数として保存し、次に__http_status_code__キーを使用することで利用できます。以下に例を示します。

1
2
3
4
{% connected_content https://example.com/api/endpoint :save result %}
{% if result.__http_status_code__ != 200 %}
  {% abort_message('Connected Content returned a non-200 status code') %}
{% endif %}

設定可能なキャッシュ

コネクテッドコンテンツの応答は、送信速度を最適化するために、異なるキャンペーンやメッセージ（同じワークスペース内）でキャッシュできます。

キャッシュサイズの制限

コネクテッドコンテンツのレスポンスボディは1MBを超えてはならず、そうでないとキャッシュされません。

キャッシュ時間

コネクテッドコンテンツは、GETエンドポイントから返される値を最低5分間キャッシュします。キャッシュ時間が指定されていない場合、デフォルトのキャッシュ時間は5分です。

コネクテッドコンテンツのキャッシュ時間は、次の例に示すように:cache_max_ageで長く構成できます。最小キャッシュ時間は5分で、最大キャッシュ時間は4時間です。コネクテッドコンテンツデータは、Memcachedなどの揮発性キャッシュシステムを使用してインメモリでキャッシュされます。その結果、指定されたキャッシュ時間に関係なく、コネクテッドコンテンツデータは指定された時間よりも早くBrazeのインメモリキャッシュから削除される可能性があります。これは、キャッシュ期間が提案であり、実際にBrazeによってデータがキャッシュされる期間を保証するものではないことを意味します。また、指定されたキャッシュ期間で予想されるよりも多くのコネクテッドコンテンツリクエストが発生する可能性があります。

デフォルトでは、コネクテッドコンテンツはPOST呼び出しをキャッシュしません。:cache_max_age をコネクテッドコンテンツの POST 呼び出しに追加することで、この動作を変更できます。

指定された秒数のキャッシュ

この例は900秒（または15分）キャッシュされます。

1
{% connected_content https://example.com/webservice.json :cache_max_age 900 %}

キャッシュバスティング

キャッシュを防ぐために、コネクテッドコンテンツがGETリクエストから返す値を:no_cache設定を使用できます。ただし、Braze 内部のホストからの応答は引き続きキャッシュされます。

1
{% connected_content https://example.com/webservice.json :no_cache %}

POST を使用するとキャッシュバストする必要はありません。Braze は POST リクエストの結果を決してキャッシュしないためです。