--- title: OpenAIイベントコネクタ構成ガイド description: この記事では、OpenAIイベントコネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/openai-events-connector/ --- ## API情報 このコネクタは以下のベンダーAPIを使用します： * API名：OpenAIイベントAPI * APIバージョン：v1 * APIエンドポイント：`https://bzr.openai.com` ## 構成 コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。 コネクタを追加した後、以下の構成を構成します： * **OpenAIイベントAPIキー**：必須。OpenAIイベントAPIへのリクエストを認証するために使用されるBearerトークンです。このキーはAuthorizationヘッダーにBearerトークンとして送信されます。OpenAIアカウントチームがこの値を提供します。 * **ピクセルID**：必須。あなたのOpenAIピクセルID（`pid`）。この値はAPIエンドポイントにクエリパラメータとして追加されます。**OpenAI広告 > 構成 > コンバージョン**でピクセルIDを見つけてください。ライブイベントがレポートにカウントされる前に、ピクセルで送信する各コンバージョンイベント（例：`page_viewed`、`items_added`、`order_created`）を登録する必要があります。 * **デフォルトアクションソース**：コンバージョンイベントのデフォルトソースを選択します。デフォルトは**Web**です。アクションソースパラメータを使用して個々のアクションでこれを上書きします。 * **基本URLの上書き**：デフォルトは`https://bzr.openai.com`です。OpenAIによるサンドボックスまたはステージング環境の指示がある場合のみ上書きします。 ## コネクタアクション | アクション名 | AudienceStream | EventStream | | ----------- | :------------: | :---------: | | イベント送信（リアルタイム） | ✓ | ✓ | | イベント送信（バッチ処理） | ✓ | ✓ | ### イベント送信（リアルタイム） #### パラメータ | パラメータ | 説明 | | --- | --- | | イベントタイプ | 必須。OpenAIに送信するイベントのタイプを選択します。各値はOpenAIイベントAPIの`type`フィールドにマッピングされ、すべてのイベントに必要です。
サポートされるイベントタイプ：
``appointment_scheduled``
``checkout_started``
``contents_viewed``
`custom`
``items_added``
``lead_created``
``order_created``
``page_viewed``
``registration_completed``
``subscription_created``
``trial_started``


各イベントタイプは、4つのデータタイプオブジェクトのいずれかにマッピングされます：**contents**、**`customer_action`**、**`plan_enrollment`**、または**custom**。
予約確定
チェックアウト開始
コンテンツ閲覧
カスタム
アイテム追加
リード作成
注文作成
ページ閲覧
登録完了
サブスクリプション作成
トライアル開始 | | カスタムイベント名 | イベントタイプが**カスタム**の場合に必要です。イベントにカスタム名を提供します。
他のイベントタイプではこの値は無視されます。 | #### イベントデータ Tealiumの属性をOpenAIのトップレベルイベントフィールドにマッピングします。 | パラメータ | 説明 | | --- | --- | | イベントID | 必須。イベントの一意の識別子で、重複排除に使用されます。 | | タイムスタンプ | 必須。イベントのタイムスタンプ（ミリ秒単位）。過去7日以内または未来10分以内である必要があります。 | | OPPRef | OpenAIのプライバシー保護識別子。 | | ソースURL | アクションソースが`web`の場合に必須。イベントが発生したページのURL。 | | アクションソース | コンバージョンイベントのソース。サポートされる値：`web`、`mobile_app`、`offline`、`physical_store`、`phone_call`、`email`、`other`。 | | オプトアウト | イベントをパーソナライゼーションからオプトアウトとしてフラグを立てる場合は`true`に構成します。 | #### ユーザーデータ * 適用可能なユーザー識別子をマッピングして、帰属精度を向上させます。PIIフィールドごとに、値を自分で事前にハッシュするか、コネクタにハッシュさせるかを選択できます。 * ハッシュ可能なフィールドは、コネクタが正規化してハッシュするべき生の値用の2つの列と、すでにハッシュされた値用の列を提供します。 * サポートされるPIIキー、必要なハッシング：`email_address`、`phone_number`、`external_id`、`country`、`city`、`zip_code`。 * ハッシュされていないフィールド：`external_id_raw`、`ip_address`、`user_agent`。 | パラメータ | 説明 | | --- | --- | | メールアドレス（SHA256ハッシュ適用） | 小文字のプレーンテキストメールアドレスを提供し、コネクタがOpenAIが期待する形式でこの値をハッシュします。空またはnullの値は無視されます。 | | メールアドレス（すでにSHA256ハッシュ済み） | SHA256ハッシュされたメールアドレスを提供します。 | | 電話番号（SHA256ハッシュ適用） | 小文字のプレーンテキスト電話番号を提供し、コネクタがOpenAIが期待する形式でこの値をハッシュします。空またはnullの値は無視されます。 | | 電話番号（すでにSHA256ハッシュ済み） | SHA256ハッシュされた電話番号を提供します。 | | 外部ID（SHA256ハッシュ適用） | プレーンテキストの外部ID（例：ロイヤリティカードIDやその他の識別子）を提供し、コネクタがOpenAIが期待する形式でこの値をハッシュします。 | | 外部ID（すでにSHA256ハッシュ済み） | SHA256ハッシュされた外部IDを提供します。 | | 国（SHA256ハッシュ適用） | イベントに関連する国を提供し、コネクタがOpenAIが期待する形式でこの値をハッシュします。 | | 国（すでにSHA256ハッシュ済み） | SHA256ハッシュされた国の値を提供します。 | | 市（SHA256ハッシュ適用） | 小文字の変換イベントに関連する市を提供し、コネクタがOpenAIが期待する形式でこの値をハッシュします。 | | 市（すでにSHA256ハッシュ済み） | SHA256ハッシュされた市の値を提供します。 | | 郵便番号（SHA256ハッシュ適用） | 小文字の郵便番号または郵便番号を提供し、コネクタがOpenAIが期待する形式でこの値をハッシュします。 | | 郵便番号（すでにSHA256ハッシュ済み） | SHA256ハッシュされた郵便番号または郵便番号を提供します。 | | 外部ID（生） | ロイヤリティカードIDやその他の識別子などの一意のID。ハッシュせずに送信されます。 | | IPアドレス | デバイスのIPアドレス。 | | ユーザーエージェント | ユーザーのウェブブラウザのユーザーエージェント文字列。 | #### Eコマース カスタマーアクションイベント（**予約確定**、**リード作成**、**登録完了**）の場合、注文概要フィールドのみが受け入れられます。OpenAIは他のすべてのeコマースフィールドをアウトバウンドペイロードから削除します。 | パラメータ | 説明 | | --- | --- | | 金額 | 小単位の整数（例：セント）。提供される場合、通貨が必要です。 | | 通貨 | ISO 4217形式の通貨コード（例：`USD`）。 | #### Eコマース自動マッピング無効化 * チェックすると、このアクションのTealiumからOpenAIへのデフォルトのeコマース自動マッピングを無効にします：`timestamp_ms`（Tealiumイベント時間から）、`source_url`（標準URL属性から）、および小売拡張属性`_csubtotal`、`_ccurrency`、`_csku`、`_cprodname`、`_ccat`、`_cquan`、`_cprice`。 * 明示的なフィールドマッピングが常に優先されます。チェックを外すと、空白を埋めます。 * アイデンティティ自動マッピング（IPアドレスとユーザーエージェント）は、**アイデンティティ自動マッピング無効化**チェックボックスによって別途制御されます。
IPアドレスとユーザーエージェントの自動マッピングを抑制するために、以前の**自動マッピング無効化**チェックボックスを有効にしていた場合、**アイデンティティ自動マッピング無効化**も有効にする必要があります。以前のチェックボックスは現在、eコマースフィールドの自動マッピングのみを制御します。
#### アイデンティティ自動マッピング無効化 * チェックすると、コネクタは自動的にIPアドレスとユーザーエージェントをマッピングしません。アイデンティティメタデータの完全な手動制御を好む場合や、プライバシー上の理由からこれらのフィールドを抑制する必要がある場合に使用します。 * チェックを外すと（デフォルト）、コネクタは自動的に`ip_address`（Tealium標準IP属性から）と`user_agent`（Tealium標準ユーザーエージェント属性から）をマッピングします。 #### デバッグモード 有効にすると、コネクタはイベントを`validate_only: true`で送信し、OpenAIがペイロードを検証してエラーを返しますが、イベントは永続化されません。トラブルシューティングやドライランに使用します。本番トラフィックでは無効のままにしてください。 #### ピクセルIDの上書き オプション。このアクションのコネクタレベルのピクセルIDを上書きします。提供された場合、コネクタはコネクタ構成で構成されたピクセルIDの代わりにこの値を使用します。 #### APIキーの上書き オプション。このアクションのためにコネクターレベルのAPIキーを上書きします。提供された場合、コネクターはコネクター構成で構成されたAPIキーの代わりにこの値を使用します。 ### イベント送信（バッチ処理） #### バッチ制限 このアクションは、バッチリクエストを使用してベンダーへの大量データ転送をサポートします。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます： * リクエストの最大数：1,000 * 最古のリクエストからの最大時間：5分 * リクエストの最大サイズ：1 MB このアクションは、**イベント送信（リアルタイム）**アクションと同じパラメータとマッピングオプションを使用します。詳細については、[イベント送信（リアルタイム）](#send-event-real-time)を参照してください。