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に送信するイベントのタイプを選択します。各値はOpenAIイベントAPIのtypeフィールドにマッピングされ、すべてのイベントに必要です。サポートされるイベントタイプ： appointment_scheduledcheckout_startedcontents_viewedcustomitems_addedlead_createdorder_createdpage_viewedregistration_completedsubscription_createdtrial_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キーの代わりにこの値を使用します。
イベント送信（バッチ処理）
バッチ制限
このアクションは、バッチリクエストを使用してベンダーへの大量データ転送をサポートします。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：
- リクエストの最大数：1,000
- 最古のリクエストからの最大時間：5分
- リクエストの最大サイズ：1 MB
このアクションは、**イベント送信（リアルタイム）**アクションと同じパラメータとマッピングオプションを使用します。詳細については、イベント送信（リアルタイム）を参照してください。
最終更新日 :: 2026年July月29日