Airshipコネクタ構成ガイド
この記事では、Airshipコネクタの構成方法について説明します。
コネクタのアクション
アクション名 | AudienceStream | EventStream |
---|---|---|
カスタムイベントの作成 | ✓ | ✓ |
タグの追加 | ✓ | ✓ |
タグの削除 | ✓ | ✓ |
属性の構成 | ✓ | ✓ |
属性の削除 | ✓ | ✓ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについての記事を参照してください。
コネクタを追加した後、以下の構成を構成します:
- リージョン
必須:Airshipプロジェクトに関連付けられたリージョンを選択します。 - アクセストークン
必須:API呼び出しに使用されるアクセストークン。 - アプリキー
アクション「カスタムイベントの作成」のAPI呼び出しに使用されるアプリキー。
アクション構成 - パラメータとオプション
次へをクリックするか、アクションタブに移動します。ここでコネクタアクションを構成します。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - カスタムイベントの作成
バッチ制限
このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます:
- リクエストの最大数:100
- 最古のリクエストからの最大時間:5分
- リクエストの最大サイズ:1 MB
パラメータ
パラメータ | 説明 |
---|---|
Named User Id | (必須) イベントに関連付けられた名前付きユーザー。 |
Event Name | (必須) イベントの名前。 |
Interaction Id | イベントが発生した場所を定義する識別子。伝統的なウェブサイトでは、URLからのパスとクエリストリングになります。ハッシュルーティングを使用するシングルページアプリでは、パス、クエリストリング、フラグメント識別子になります。 |
Interaction Type | イベントをトリガーしたインタラクションのタイプを説明します。例:「url」、「social」、「email」。これはほとんどの場合、ウェブイベントの場合は「url」になります。Airshipはinteraction_typeによって同名のイベントを分けることができ、カスタムイベントについての洞察を深めることができます。 |
Occurred | ユーザーに対するイベントが発生したタイムスタンプをISO 8601 UTC形式 ‘YYYY-MM-DDThh:mm:ss’で指定します。タイムスタンプが提供されていない場合、現在のタイムスタンプが使用されます。 |
Session Id | イベントが発生したユーザーセッション。 |
Transaction | イベントが単一のトランザクションを表す一連のものである場合、トランザクションフィールドを使用してイベントを結びつけます。 |
Value | Valueフィールドは、小数点以下6桁までの精度を尊重します。 |
Properties | トップレベルの属性のキーと値のペアとしてプロパティをマップします。 より複雑なデータ構造のためのテンプレートをマップして使用します。 |
Template Variables | オプション:Propertiesオブジェクトデータのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 ネストしたテンプレート変数の名前はドット表記法(例:items.name)で指定します。 ネストしたテンプレート変数は通常、データレイヤーリスト属性から作成されます。 |
Templates | オプション:propertiesオブジェクトのテンプレートを提供します。(参照:テンプレートガイド) テンプレート名を二重中括弧で囲んで、上記のイベントデータマッピングのPropertiesにマップします。例えば、 {{SomeTemplateName}}) 。 |
アクション - タグの追加
パラメータ
パラメータ | 説明 |
---|---|
Named User Id | タグを関連付ける名前付きユーザー。 |
Tags | 名前付きユーザーに追加するタグのリスト。タグがすでに存在する場合、それらは変更されません。 同じタググループに複数のタグを追加する場合、タグ値の配列をマップします。 |
アクション - タグの削除
パラメータ
パラメータ | 説明 |
---|---|
Named User Id | タグを関連付け解除する名前付きユーザー。 |
Tags | 名前付きユーザーから削除するタグのリスト。タグが現在存在しない場合、何も起こりません。 同じタググループから複数のタグを削除する場合、タグ値の配列をマップします。 |
アクション - 属性の構成
パラメータ
パラメータ | 説明 |
---|---|
Named User Id | 属性を構成する名前付きユーザー。 |
Title, First Name, Last Name, Full Name, Gender, Zipcode, City, Region, Country, Birthdate, Age, Mobile Phone, Home Phone, Work Phone, Loyalty Tier, Company, Username, Account Creation, Email Address, Altitude, Latitude, Longitude, Advertising ID (IDFA) | Airshipの事前定義またはカスタム属性にマップします。カスタム属性は、マップする前にAirship UIで追加する必要があります。 |
アクション - 属性の削除
パラメータ
パラメータ | 説明 |
---|---|
Named User Id | 属性を削除する名前付きユーザー。 |
Attributes | 名前付きユーザーから削除する属性のリスト。 |
最終更新日 :: 2022年January月20日