OpenAIイベントコネクタ構成ガイド
この記事では、OpenAIイベントコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：OpenAIイベントAPI
- APIバージョン：v1
- APIエンドポイント：
https://bzr.openai.com
構成
コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します：
- 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に送信するイベントのタイプを選択します。 サポートされるイベントタイプ：予約確定、チェックアウト開始、コンテンツ閲覧、カスタム、アイテム追加、リード作成、注文作成、ページ閲覧、登録完了、サブスクリプション作成、トライアル開始。 |
| カスタムイベント名 | イベントタイプがカスタムの場合に必須。イベントにカスタム名を提供します。 他のイベントタイプではこの値は無視されます。 |
イベントデータ
Tealiumの属性をOpenAIのトップレベルイベントフィールドにマッピングします。
| パラメータ | 説明 |
|---|---|
| イベントID | 必須。イベントの一意の識別子で、重複排除に使用されます。 |
| タイムスタンプ | 必須。イベントのタイムスタンプ（ミリ秒単位）。過去7日以内または未来10分以内である必要があります。 |
| OPPRef | OpenAIのプライバシー保護識別子。 |
| ソースURL | アクションソースがwebの場合に必須。イベントが発生したページのURL。 |
| アクションソース | コンバージョンイベントのソース。サポートされる値：web、mobile_app、offline、physical_store、phone_call、email、other。 |
| オプトアウト | イベントをパーソナライゼーションからオプトアウトとしてフラグを立てる場合はtrueに構成します。 |
ユーザーデータ
帰属精度を向上させるために適用可能なユーザー識別子をマッピングします。PII値を自分で事前にハッシュするか、コネクタにハッシュさせることができます。ハッシュ可能なフィールドは、コネクタが正規化してハッシュするための2つの列として表示されます：（SHA256ハッシュを適用） は生の値用、（既にSHA256ハッシュ済み） は事前にハッシュされた値用です。
| パラメータ | 説明 |
|---|---|
| メールアドレス（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）。 |
自動マッピング無効化
チェックすると、このアクションのデフォルトのTealiumからOpenAIへの自動マッピング（タイムスタンプ、ソースURL、IPアドレス、ユーザーエージェント、小売拡張属性_csubtotal、_ccurrency、_csku、_cprodname、_ccat、_cquan、_cprice）が無効になります。明示的なフィールドマッピングが常に優先されます。チェックを外すと、空白を埋めます。
デバッグモード
有効にすると、コネクタはvalidate_only: trueでイベントを送信し、OpenAIがペイロードを検証してイベントを永続化せずにエラーを返します。トラブルシューティングやドライランに使用します。本番トラフィックでは無効にしてください。
ピクセルIDの上書き
オプション。このアクションのコネクタレベルのピクセルIDを上書きします。提供された場合、コネクタはコネクタ構成で構成されたピクセルIDの代わりにこの値を使用します。
APIキーオーバーライド
オプション。このアクションのコネクタレベルのAPIキーを上書きします。提供された場合、コネクタはコネクタ構成で構成されたAPIキーの代わりにこの値を使用します。
イベント送信（バッチ処理）
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加します。詳細については、バッチアクションを参照してください。次のいずれかの閾値に達するか、プロファイルが公開されるまでリクエストがキューに入れられます：
- 最大リクエスト数：1,000
- 最古のリクエストからの最大時間：5分
- リクエストの最大サイズ：1 MB
このアクションは、**イベント送信（リアルタイム）**アクションと同じパラメータとマッピングオプションを使用します。詳細については、イベント送信（リアルタイム）を参照してください。
最終更新日 :: 2026年June月3日