ROKTコネクタ構成ガイド
この記事では、ROKTコネクタ(旧ROKTイベントコネクタ)の構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:ROKT API
- APIエンドポイント:
https://api.rokt.com/v1/events
https://api.rokt.com/v2/events
https://api.rokt.com/v3/import/suppression
- ドキュメント:カスタムオーディエンスインポートAPI
イベント送信アクションは、v1およびv2の認証方法をサポートしています。アクションレベルで使用するAPIを指定できます。ただし、カスタムオーディエンスの更新アクションはv2認証方法のみをサポートしています。詳細については、Rokt: Event API v1またはRokt: Event API v2のドキュメントを参照してください。
バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:
- 最大リクエスト数:100
- 最古のリクエストからの最大時間:10分
- リクエストの最大サイズ:1 MB
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します:
- クライアントID
- 必須。アプリIDまたは公開キーを提供してください。
- クライアントシークレット
- 必須。アプリシークレットまたはシークレットキーを提供してください。
- アカウントID
- 必須。アカウントIDを提供してください。
コネクタの構成が完了したら、完了をクリックします。
アクション
アクション名 | AudienceStream | EventStream |
---|---|---|
イベント送信 | ✓ | ✓ |
イベント送信(バッチ) | ✓ | ✓ |
カスタムオーディエンス更新 | ✓ | ✗ |
カスタムオーディエンス更新(バッチ) | ✓ | ✗ |
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
イベント送信
変換データ
パラメータ | 説明 |
---|---|
イベントID | マッピングされていない場合、Tealiumはこの値にUUIDを生成します。 |
イベント時間 | マッピングされていない場合、現在のタイムスタンプがRFC 3339形式で構成されます。 |
メタデータ | イベントに関する非ビジネスクリティカルな情報。 |
バージョン | V2 がデフォルトです。アプリIDとアプリシークレットキーを使用してV1エンドポイントにイベントを送信するにはV1 に構成します。rpub およびrsec キーを使用してV2エンドポイントにイベントを送信するにはV2 に構成します。 |
イベント送信(バッチ)
変換データ
パラメータ | 説明 |
---|---|
イベントID | マッピングされていない場合、Tealiumはこの値にUUIDを生成します。 |
イベント時間 | マッピングされていない場合、現在のタイムスタンプがRFC b3339形式で構成されます。 |
メタデータ | イベントに関する非ビジネスクリティカルな情報。 |
バージョン | V1 がデフォルトです。アプリIDとアプリシークレットキーを使用してV1エンドポイントにイベントを送信するにはV1 に構成します。rpub およびrsec キーを使用してV2エンドポイントにイベントを送信するにはV2 に構成します。 |
カスタムオーディエンス更新
パラメータ
パラメータ | 説明 |
---|---|
アクション | include に構成すると、訪問を指定されたリストに追加し、ターゲティングまたは抑制に使用できます。exclude に構成すると、訪問を指定されたリストから削除します。 |
メール | メールアドレス。 |
リスト | 使用するカスタムオーディエンスリストの名前。リスト値が提供されていない場合、メールアドレスはデフォルトでAdvertiserDatabaseリストにインポートされます。 |
SHA-256ハッシュ化 | メールフィールドに提供された生のメールアドレスをSHA-256ハッシュ化する場合、このチェックボックスを選択します。 |
カスタムオーディエンス更新(バッチ)
パラメータ
パラメータ | 説明 |
---|---|
アクション | include に構成すると、訪問を指定されたリストに追加し、ターゲティングまたは抑制に使用できます。exclude に構成すると、訪問を指定されたリストから削除します。 |
メール | メールアドレス。 |
リスト | 使用するカスタムオーディエンスリストの名前。リスト値が提供されていない場合、メールアドレスはデフォルトでAdvertiserDatabaseリストにインポートされます。 |
SHA-256ハッシュ化 | メールフィールドに提供された生のメールアドレスをSHA-256ハッシュ化する場合、このチェックボックスを選択します。 |
最終更新日 :: 2025年April月2日