エアシップコネクタ構成ガイド | サーバーサイドコネクター

コネクタアクション

アクション名	AudienceStream	EventStream
カスタムイベントの作成	✓	✓
タグの追加	✓	✓
タグの削除	✓	✓
属性の構成	✓	✓
属性の削除	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについての記事を参照してください。

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

リージョン
必須：エアシッププロジェクトに関連するリージョンを選択します。
アクセストークン
必須：API呼び出しに使用されるアクセストークン。
アプリキー
アプリキーは、「カスタムイベントの作成」アクションのAPI呼び出しに使用されます。

アクション構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでコネクタアクションを構成します。

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

アクション - カスタムイベントの作成

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：100
最古のリクエストからの最大時間：5分
リクエストの最大サイズ：1 MB

パラメータ

パラメータ	説明
名前付きユーザーID	(必須) イベントに関連付けられた名前付きユーザー。
イベント名	(必須) イベントの名前。
インタラクションID	イベントが発生した場所を定義する識別子。従来のウェブサイトでは、URLからのパスとクエリ文字列になります。ハッシュルーティングを使用するシングルページアプリでは、パス、クエリ文字列、およびフラグメント識別子になります。
インタラクションタイプ	イベントをトリガーしたインタラクションのタイプを説明します。例：「url」、「social」、「email」。これはほとんどの場合、ウェブイベントに対して「url」であるべきです。エアシップはinteraction_typeによって同じ名前のイベントを区別し、カスタムイベントについての洞察を深めることができます。
発生時	ユーザーにとってのイベント発生時のタイムスタンプをISO 8601 UTC形式 ‘YYYY-MM-DDThh:mm:ss’で記載します。タイムスタンプが提供されていない場合は、現在のタイムスタンプが使用されます。
セッションID	イベントが発生したユーザーセッション。
トランザクション	イベントが単一トランザクションを表す一連のものである場合、トランザクションフィールドを使用してイベントを結びつけます。
値	値フィールドは小数点以下6桁の精度を尊重します。
プロパティ	トップレベル属性のキー値ペアとしてプロパティをマッピングします。より複雑なデータ構造のためにテンプレートをマッピングして使用します。
テンプレート変数	オプション：プロパティオブジェクトデータのテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記（例：items.name）でネストされたテンプレート変数の名前を付けます。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	オプション：プロパティオブジェクトのためのテンプレートを提供します。詳細については、コネクターテンプレートについてを参照してください。イベントデータマッピングの上で、プロパティにテンプレート名を二重中括弧で囲んでマッピングします。例えば、`{{SomeTemplateName}}`。

アクション - タグの追加

パラメータ

パラメータ	説明
名前付きユーザーID	タグを関連付ける名前付きユーザー。
タグ	名前付きユーザーに追加するタグのリスト。タグがすでに存在する場合は変更されません。同じタググループに複数のタグを追加する場合は、タグ値の配列をマッピングします。

アクション - タグの削除

パラメータ

パラメータ	説明
名前付きユーザーID	タグを解除する名前付きユーザー。
タグ	名前付きユーザーから削除するタグのリスト。タグが現在存在しない場合は何も起こりません。同じタググループから複数のタグを削除する場合は、タグ値の配列をマッピングします。

アクション - 属性の構成

パラメータ

パラメータ	説明
名前付きユーザーID	属性を構成する名前付きユーザー。
タイトル、名、姓、フルネーム、性別、郵便番号、市区町村、地域、国、生年月日、年齢、携帯電話、自宅電話、勤務先電話、ロイヤリティ階層、会社、ユーザー名、アカウント作成、メールアドレス、高度、緯度、経度、広告ID（IDFA）	エアシップで事前定義された属性またはカスタム属性にマッピングします。カスタム属性は、マッピングする前にエアシップUIで追加する必要があります。

アクション - 属性の削除

パラメータ

パラメータ	説明
名前付きユーザーID	属性を削除する名前付きユーザー。
属性	名前付きユーザーから削除する属性のリスト。