OpenAI Eventsコネクタ構成ガイド

API情報

このコネクタは、次のベンダーAPIを使用します。

• API名：OpenAI Events API
• APIバージョン：v1
• APIエンドポイント：https://bzr.openai.com

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

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

• OpenAI Events APIキー：必須。OpenAI Events APIへのリクエストの認証に使用するBearerトークンです。このキーは、AuthorizationヘッダーでBearerトークンとして送信されます。この値はOpenAIのアカウントチームから提供を受けることができます。
• ピクセルID：必須。OpenAIピクセルID（pid）です。この値は、クエリパラメータとしてAPIエンドポイントに追加されます。ピクセルIDは、OpenAI Ads > Settings > Conversionsで確認できます。送信する各コンバージョンイベント（page_viewed、items_added、order_createdなど）は、ライブイベントがレポートに計上されるようにするため、そのピクセルについて同画面で登録する必要があります。
• デフォルトのアクションソース：コンバージョンイベントのデフォルトソースを選択します。デフォルトはWebです。アクションソースパラメータを使用すると、アクションごとにこの構成を上書きできます。
• ベースURLの上書き：デフォルトはhttps://bzr.openai.comです。サンドボックス環境またはステージング環境向けにOpenAIから指示された場合にのみ上書きしてください。

コネクタを構成したら、完了をクリックします。

コネクタアクション

イベントを送信（リアルタイム）

パラメータ

イベントタイプ

必須。OpenAIに送信するイベントのタイプを選択します。各値は、OpenAI Events APIのtypeフィールドにマッピングされます。サポートされる値は次のとおりです。

• appointment_scheduled
• attribution_appended
• checkout_started
• contents_viewed
• custom
• items_added
• lead_created
• order_created
• page_viewed
• registration_completed
• subscription_created
• trial_started

各イベントタイプは、contents、customer_action、plan_enrollment、custom、attributionの5つのデータタイプオブジェクトのいずれかにマッピングされます。attribution_appendedのフィールドについては、元のイベントデータおよびアトリビューションデータを参照してください。

attribution_appendedは、以前のコンバージョンを参照する個別のアトリビューションレポートを送信します。イベントデータでは、イベントIDがアトリビューションレポートIDです。このIDは一意である必要があり、まったく同じ再試行では再利用する必要があります。タイムスタンプはレポート生成時刻であり、デフォルトは送信時刻です。

attribution_appendedは、OpenAIがお客様の広告主ピクセルに対して有効にした後にのみ使用できます。本番環境で使用する前に、OpenAIのアカウントチームに連絡して利用可能かどうかを確認してください。

カスタムイベント名

イベントタイプがカスタムの場合は必須です。イベントのカスタム名を指定します。この値は、その他すべてのイベントタイプでは無視されます。

OPPRef

任意。OpenAIのアトリビューション識別子です。元の値を変更せずにマッピングしてください。この値はevents[].opprefとして送信され、イベントデータには含まれません。

イベントデータ

Tealium属性をOpenAIのトップレベルイベントフィールドにマッピングします。

アトリビューション追加イベントでは、イベントID、タイムスタンプ、アクションソース、ソースURL、およびOPPRefのみが送信されます。イベントIDはアトリビューションレポートIDです。このIDは一意である必要があり、まったく同じ再試行では再利用する必要があります。タイムスタンプはレポート生成時刻であり、マッピングされていない場合はデフォルトで送信時刻になります。

ユーザーデータ

ユーザーデータは、アトリビューション追加イベントでは送信されません。

• アトリビューションの精度を高めるため、該当するユーザー識別子をマッピングします。各PIIフィールドについて、値を事前にハッシュ化するか、コネクタでハッシュ化するかを選択できます。
• ハッシュ化可能なフィールドには、コネクタで正規化およびハッシュ化する未加工値用の列（SHA256ハッシュを適用）と、すでにハッシュ化済みの値用の列（SHA256ハッシュ化済み）があります。
• サポートされるPIIキー（ハッシュ化必須）：email_address、phone_number、external_id、country、city、zip_code。
• ハッシュ化せずに送信されるフィールド：ip_address、user_agent。

元のイベントデータ

これらのフィールドは、イベントタイプがattribution_appendedに構成されている場合にのみ適用されます。このアトリビューションレポートが参照する元のコンバージョンイベントにマッピングしてください。

アトリビューションデータ

これらのフィールドは、Event Type が attribution_appended に構成されている場合にのみ適用されます。元のコンバージョンへの貢献が認められた OpenAI 広告のタッチポイントを記述するものであり、Tealium によって自動マッピングまたは生成されることはありません。

必須のアトリビューションフィールドが欠けている場合、コネクタはイベントを送信しません。検証エラーが Trace とコネクタログに表示されます。

E コマース

Customer Action イベント（Appointment Scheduled、Lead Created、Registration Completed）では、注文概要フィールドのみが受け付けられます。OpenAI は、その他すべての E コマースフィールドを送信ペイロードから除外します。

Attribution Appended イベントでは、Currency、Amount、Amount - convert to minor units、Minor Unit Factor、Data Content Type、Customer Segmentation のみが受け付けられます。E コマースの自動マッピングは適用されません。

金額には次の 2 つの指定方法があります。

• 変換済みの値：補助単位ですでに表されている値（例：29.90 USD の場合は 2990）を、Amount または Content Amount (per unit) にマッピングします。
• 送信時に変換：主要単位の小数値（例：29.90）を Amount - convert to minor units または Content Amount (per unit) - convert to minor units にマッピングし、Minor Unit Factor に通貨に適した乗数を構成します（例：USD/EUR/GBP は 100、JPY/KRW は 1、KWD/BHD/OMR は 1000）。

同じフィールドに両方の形式がマッピングされている場合は、変換済みの値が優先されます。

E コマースの自動マッピングを無効化

• オンにすると、このアクションに対する Tealium から OpenAI へのデフォルトの E コマース自動マッピングが無効になります。対象は、timestamp_ms（Tealium のイベント時刻から取得）、source_url（標準 URL 属性から取得）、およびリテール拡張属性 _csubtotal、_ccurrency、_csku、_cprodname、_ccat、_cquan、_cprice です。
• 明示的なフィールドマッピングが常に優先されます。オフにした場合は、空のフィールドのみが補完されます。
• Minor Unit Factor がマッピングされている場合、コネクタは自動マッピングされた _csubtotal と _cprice の値にも係数を乗算してから送信します。
• ID の自動マッピング（IP Address と User Agent）は、Disable Identity Automapping チェックボックスによって個別に制御されます。

以前の Disable Automapping チェックボックスを有効にして、IP アドレスとユーザーエージェントが自動マッピングされないようにしていた場合は、Disable Identity Automapping も有効にする必要があります。以前のチェックボックスは、現在では E コマースフィールドの自動マッピングのみを制御します。

ID の自動マッピングを無効化

• オンにすると、コネクタは IP Address と User Agent を自動的にマッピングしません。ID メタデータを完全に手動で管理する場合や、プライバシー上の理由からこれらのフィールドを除外する必要がある場合に使用します。
• オフ（デフォルト）の場合、コネクタは ip_address（Tealium の標準 IP 属性から取得）と user_agent（Tealium の標準 User Agent 属性から取得）を自動的にマッピングします。

デバッグモード

有効にすると、コネクタは validate_only: true を指定してイベントを送信します。これにより、OpenAI はイベントを保存せずにペイロードを検証し、エラーがあれば返します。トラブルシューティングやドライランに使用してください。本番トラフィックでは無効のままにしてください。

Pixel ID の上書き

任意。このアクションについて、コネクタレベルの Pixel ID を上書きします。指定した場合、コネクタはコネクタ構成で構成された Pixel ID の代わりにこの値を使用します。

API キーの上書き

任意。このアクションについて、コネクタレベルの API Key を上書きします。指定した場合、コネクタはコネクタ構成で構成された API Key の代わりにこの値を使用します。

イベントの送信（バッチ）

バッチ制限

このアクションでは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達する場合があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに保持されます。

• リクエストの最大数：1,000
• 最も古いリクエストからの最大経過時間：5 分
• リクエストの最大サイズ：1 MB

このアクションでは、Send Event (Real-Time) アクションと同じパラメータおよびマッピングオプションを使用します。詳細については、イベントの送信（リアルタイム）を参照してください。

attribution_appended イベントタイプのバッチ配信は、まだサポートされていません。アトリビューションイベントには Send Event (Real-Time) アクションを使用してください。