シンギュラーコネクタ構成ガイド

API情報

このコネクタは以下のベンダーAPIを使用します：

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を行います：

SDK APIキー
- （必須）SDKキーはAPIリクエストのaパラメータとして渡されます。
- Singular UIのメインメニューにある開発者ツールからSDKキーを取得します。
- レポーティングAPIキーを使用するとデータが拒否されるため、使用しないでください。

アクション名	AudienceStream	EventStream
セッションデータ送信	✗	✓
イベントデータ送信	✗	✓

アクション名を入力し、アクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

パラメータ	説明
プラットフォーム	アプリのプラットフォーム。利用可能な値は：`Android`, `iOS`, `PC`, `Xbox`, `Playstation`, `Nintendo`, `MetaQuest`, `CTV`です。

すべてのパラメータはURLデコードされます。

パラメータ	説明
IPv4アドレス	（必須）デバイスの公開IPv4アドレス。
OSバージョン	（必須）セッション時のデバイスのOSバージョン。
アプリ識別子	（必須）アプリ識別子。
アプリケーションバージョン	（必須）アプリケーションのバージョン。
インストール	（必須）このセッションがインストールまたは再インストール後の最初のセッションであるかどうかを示すパラメータ。
クライアント定義識別子	他のすべての識別子が利用不可能な特殊なケースでのクライアント定義の識別子。
タイムスタンプ	セッションのUNIX時間（秒）。
タイムスタンプ（ミリ秒）	13桁のUNIX時間（ミリ秒）。
グローバルプロパティ	最大5つのキーと値のペアを含むJSONオブジェクト。
IP使用	このパラメータは、HTTPリクエストからIPv4アドレスパラメータではなくIPアドレスを抽出するようSingularに指示します。
国	セッション時のユーザーのISO 3166-1 alpha-2二文字国コード。
ユーザーエージェント	デバイスのユーザーエージェント。
データ共有オプション	情報共有に関するエンドユーザーの同意。
内部ユーザーID	内部ユーザーID。

ベンダーでプラットフォーム固有のパラメータにイベント属性をマッピングします。

パラメータ	説明
プラットフォーム	アプリのプラットフォーム。利用可能な値は：`Android`, `iOS`, `PC`, `Xbox`, `Playstation`, `Nintendo`, `MetaQuest`, `CTV`です。

すべてのパラメータはURLデコードされます。

パラメータ	説明
IPv4アドレス	（必須）デバイスの公開IPv4アドレス。
OSバージョン	（必須）セッション時のデバイスのOSバージョン。
アプリ識別子	（必須）アプリ識別子。
イベント名	（必須）追跡されるイベントの名前。
カスタムイベント属性	JSON形式のカスタムイベント属性。
タイムスタンプ	セッションのUNIX時間（秒）。
タイムスタンプ（ミリ秒）	13桁のUNIX時間（ミリ秒）。
グローバルプロパティ	最大5つのキーと値のペアを含むJSONオブジェクト。
IP使用	このパラメータは、HTTPリクエストからIPv4アドレスパラメータではなくIPアドレスを抽出するようSingularに指示します。
国	セッション時のユーザーのISO 3166-1 alpha-2二文字国コード。
通貨額	通貨額。
通貨コード	ISO 4217の大文字の3文字通貨コード。
SKU識別子	製品SKU識別子。
トランザクション識別子	トランザクション識別子。
データ共有オプション	情報共有に関するエンドユーザーの同意。
内部ユーザーID	内部ユーザーID。
収益イベント？	このブール型パラメータは、イベントが収益イベントかどうかを指定します（`true`または`false`）。

ベンダーでプラットフォーム固有のパラメータにイベント属性をマッピングします。