APIの概要

Fanplayr 360は、システムにデータを取り込むための多くの連携機能を提供していますが、電話アプリやカスタムCRMなど、まだサポートしていないアプリケーションからデータを取り込む必要がある場合でも、そのためのオプションを用意しています。

イベント

イベントは、Fanplayr 360にデータを取り込むための主要な方法です。これらは、イベント名と属性のキー/バリューペアで構成されます。

通常、属性は数値や文字列のようなスカラー値ですが、セマンティックオブジェクトと組み合わせて使用すると、より複雑になる場合があります。

ユーザーにサプライズ商品（魔法使いの店です！）が表示されたことを示す例は、次のようになります（JavaScript APIを使用）。

// 任意の文字列をイベント名として使用できます。
fp360.track('Suprise Product', {
  // カスタム属性
  websiteSection: 'wizard-shop',
  // セマンティック属性とオブジェクト
  $product: {
    id: 'BF203',
    name: 'Beautiful Training Staff #1',
    price: 12.99,
    currency: 'EUR'
  }
});

その他のインタラクション

その他に使用できるインタラクションは次のとおりです。

• ユーザーに識別情報を追加します。例：「このユーザーはuser@domain.comというメールアドレスで識別されます」。同じメールアドレスで再度ユーザーを識別した場合、Fanplayr 360はこのユーザーのプロフィールとイベントを結合します。

• ユーザーの同意を設定します。例：「このユーザーは、マーケティング目的で電話番号555-555-5555にて電話連絡を受けることに同意しました」。

JavaScript API

システムにデータを取り込む最も簡単な方法は、JavaScript APIを使用することです。すべての複雑さを処理するライブラリがあるので、ウェブサイトにfp360.track('EVENT', { data })を追加するだけで開始できます。

javascript-api

ショッピングカート

さらに簡単に、JavaScript APIを内部で使用する事前構築済みの連携手順を用意しています。

• Shopify

カスタムAPI

Fanplayr 360にイベントを送信し、プロフィール属性を設定するために、すでにJavaScript APIを提供していますが、まだサポートしていないサービス（電話アプリなど）からFanplayr 360にデータを取り込みたい場合があります。

これを行うには、カスタム連携を作成することで取得できる_WRITE_KEY_と_ENDPOINT_が必要です。

その後、_ENDPOINT_にPOSTを作成できます。（開発者にとっては）簡単です。

custom-api

セマンティックデータ

JavaScript APIを使用する場合でも、独自のCustom APIを記述する場合でも、システムを最大限に活用するためにセマンティックデータについて知っておくと良いでしょう。

semantic-data