Airshipコネクタ構成ガイド

コネクタアクション

アクション名	ビジタープロファイル	イベントデータ
カスタムイベントを作成	✓	✓
タグを追加	✓	✓
タグを削除	✓	✓
属性を構成	✓	✓
属性を削除	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します。

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

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

続行をクリックして、コネクタアクションを構成します。アクションの名前を入力し、リストからアクションタイプを選択します。

アクション — カスタムイベントを作成

バッチ制限

このアクションでは、ベンダーへの大量データ転送をサポートするため、リクエストをバッチ処理します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに格納されます。

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

パラメータ

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

アクション — タグを追加

パラメータ

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

アクション — タグを削除

パラメータ

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

アクション — 属性を構成

パラメータ

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

アクション — 属性を削除

パラメータ

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