ユーザー属性とタグ

氏名や生年月日から、残ポイント、レベル、マーケティング同意の有無まで、顧客を特徴づける値はユーザー属性とカスタムタグを通じて連携します。これらを使うことで、顧客をセグメントグループに分けたり、メッセージ配信を自動化したりできます。

ユーザー属性は、電話番号や生年月日のように、あらかじめ定められた形式で連携し、多くの機能で利用される特別なデータです。それ以外の自由形式のデータはカスタムタグとして連携します。

FlareLaneのさまざまな機能と密接に結びつくユーザー単位のデータについては、以下のユーザー属性データを正しい形式で連携してください。

track APIのuserAttributesの値を使用します。

一括バッチによる定期同期などには、次のAPIを使用してください：

• REST API：POST /v1/projects/PROJECT_ID/track

例：API経由でユーザー属性を連携する

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "userAttributes": [
    {
      "userId": "userid1",
      "name": "name",
      "phoneNumber": "+821011112222",
      "email": "john@example.com",
      "dob": "1990-01-01",
      "timeZone": "Asia/Seoul",
      "country": "KR",
      "language": "ko"
    }
  ]
}
'

連携したユーザー属性は、ユーザー一覧で確認できます。

ユーザー属性のほかに、購入履歴、保有クーポンの一覧、マーケティング同意の有無といった自由形式の属性値はタグとして連携します。連携したタグをもとに、より細かなセグメントターゲティングを行ったり、ハイパーパーソナライズメッセージの変数として利用したりできます。

タグの例を以下に示します。

{
  "gender": "male",
  "order_count": 2,
  "liked_products": [1,2,3],
  "coupon_names": ["coupon1","coupon2","coupon3"],
  "firstPurchasedAt": "2024-04-19T14:23:56+09:00"
  "ad_agreement_datetime": "2024-04-19T14:23:56+09:00"
}

track APIのtagsの値を使用できるほか、SDK経由でタグを追加することもできます。

タグを連携すると、含めたタグのみが適用されます。タグを削除するには、その値をnullに設定してください。

一括バッチによる定期同期などには、次のAPIを使用してください：

• REST API：POST /v1/projects/PROJECT_ID/track

クライアント側で値が変化したとき：

• Web SDK / Mobile SDK： FlareLane.setTags({ key: value }})

例：API経由でタグを連携する

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "tags": [
    {
      "subjectType": "user",
      "subjectId": "userid1",
      "tags": {
        "gender": "male",
        "order_count": 2,
        "liked_products": [1,2,3],
        "coupon_names": ["coupon1","coupon2","coupon3"],
        "firstPurchasedAt": "2024-04-19T14:23:56+09:00"
        "ad_agreement_datetime": "2024-04-19T14:23:56+09:00"
      }
    }
  ]
}
'

タグの値は、次のデータ型をサポートしています。

• String（文字列）
• Number（数値）
• Time（時刻。次の2種類のいずれかを使用し、指定の形式に従ってください）
  • ISO8601形式の文字列：例 "2024-04-19T14:23:56+09:00"
  • ミリ秒単位のUnixタイムスタンプ：例 1681721331085
• Boolean（真偽値。true/false）
• Array（配列。型は統一する必要があります。すべて文字列、またはすべて数値）
• null（タグを削除します）

ユーザーIDを連携すると、シナリオに応じて現在のデバイスのタグもあわせて変化します。詳しくは、ユーザーIDのシナリオ別にデバイスタグが変化する仕組みのガイドをご覧ください。

タグは基本的にユーザーID単位で一貫して管理することをおすすめします。ただし、デバイス単位でタグを管理する必要がある場合は、タグのキーの先頭に**@device_**を付けると、このポリシーは適用されません。

連携したタグは、ユーザー一覧またはデバイス一覧で確認できます。

同じページの下部にある連携済みタグの一覧では、利用可能なデータを確認できます。新しいタグを連携すると、しばらくすると自動的に一覧へ追加されます。待たずに手動で一覧に追加して、すぐに利用することもできます。（一覧に追加されたことが、データが正しく連携されたことを必ずしも意味するわけではありません。）

セグメントフィルターのタグフィルターを使うと、あらゆるグループを自由に作成できます。等しい、比較演算子、存在チェックなど、さまざまな条件で設定できます。

連携したタグは、パーソナライズメッセージ（Liquid）構文を使ってメッセージ本文に差し込めます。

使い方：{{ tags.tagName | default: defaultValue }}

• タグのデータには件数の上限があります。この上限があるため、タグ名を動的に割り当てることは推奨しません。
• オブジェクトの配列は今後サポート予定です。