---
title: ROKTコネクタ構成ガイド
description: この記事では、ROKTコネクタ（旧ROKTイベントコネクタ）の構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/rokt/
---
## API情報

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

* API名：ROKT API
* APIエンドポイント：
  * APIエンドポイント：`https://api.rokt.com`
  * V1：`https://api.rokt.com/v1/events`
  * V2：`https://api.rokt.com/v2/events`
  * カスタムオーディエンスインポート：`https://data.rokt.com/v3/import/suppression`
* ドキュメント：
  * [カスタムオーディエンスインポートAPI](https://docs.rokt.com/developers/api-reference/custom-audience-import/)
  * [イベントAPI](https://docs.rokt.com/developers/api-reference/event-api/)


<blockquote>
イベント送信アクションは、v1およびv2の認証方法をサポートしています。アクションレベルで使用するAPIを指定できます。ただし、カスタムオーディエンスの更新アクションはv2認証方法のみをサポートしています。詳細については、[Rokt: イベントAPI v1](https://docs.rokt.com/developers/api-reference/event-api#generating-app-id-and-app-secret)または[Rokt: イベントAPI v2](https://docs.rokt.com/developers/api-reference/event-api/#authentication-v2)のドキュメントを参照してください。
</blockquote>


## バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

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

## 構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/ja/server-side/connectors/manage/)を参照してください。

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

* **クライアント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ハッシュ化する場合、このチェックボックスを選択します。 |