​

はじめに

MoEngageとOpenAI Ads Conversionsの連携は、安全なサーバー間（S2S）接続を確立します。Cookieの制限、Intelligent Tracking Prevention（ITP）、広告ブロッカーなどのブラウザ側の障害を回避することで、クライアント側のトラッキングでは見逃されがちなコンバージョンを取得します。 MoEngageは、MoEngage App MarketplaceのOpenAI Ads Conversionsアプリを通じて、OpenAI向けの単一のオムニチャネルコネクタを提供しています。Webサイト、モバイルアプリ、実店舗など、すべての環境で取得したコンバージョンイベントをOpenAI Ads Managerに直接送信します。

​

ユースケース

OpenAI Ads ConversionsをMoEngageと連携すると、イベントデータを同期して以下のユースケースに対応できます。

• シグナルの回復力: 通常はブラウザのプライバシー設定や広告ブロッカーによってブロックされる「失われた」コンバージョンを回復します。
• リアルタイムのアトリビューション: サーバー側のシグナルをOpenAIに直接送信し、クリックスルーおよびビュースルーのアトリビューションの精度を向上させます。
• 広告費用対効果（ROAS）の最適化: リアルタイムのコンバージョンデータをOpenAIに送信し、広告配信、オーディエンスマッチング、顧客獲得単価（CPA）を改善します。
• マルチソーストラッキング: あらゆるチャネルからの購入、サブスクリプション、サインアップ、予約、カスタムイベントを取得し、広告クリックにアトリビューションします。
• コンバージョンレポート: OpenAI Ads Managerでコンバージョンの量と価値をレポートし、投資収益率を測定します。

​

連携

​

ステップ1: OpenAI Ads Managerで認証情報を生成する

接続を確立するには、OpenAI Ads ManagerでPixel IDを取得し、APIキーを生成します。

​

ステップ1.1: Pixel IDを取得する

Pixel IDを取得するには、以下の手順を実行します。

1. OpenAI Ads Managerアカウントにログインします。
2. 左側のナビゲーションメニューで、Settings > General > Manage conversion keysに移動します。
3. 右上隅にあるCreateをクリックし、Data Sourceを選択します。
4. Data Source Nameボックスに、データソースの名前を入力します。
5. Typeリストで、Webを選択します。
6. Createをクリックします。

OpenAIにPixel IDが表示されます。Copyをクリックし、ステップ2: App MarketplaceでOpenAI Ads Conversionsを接続するセクションで使用するために、値を安全な場所に貼り付けます。

​

ステップ1.2: Conversions APIキーを生成する

Conversions APIキーを生成するには、以下の手順を実行します。

1. OpenAI Ads Managerで、Settings > General > Manage conversion keysに移動します。
2. 右上隅にあるConversion keysをクリックします。
3. Create new keyをクリックします。
4. Nameボックスに、キーの名前を入力します。
5. Createをクリックします。

OpenAIに表示されたアクセストークンをコピーします。

​

ステップ1.3: OpenAI Ads Managerでコンバージョンイベントを作成する

OpenAI Adsでは、MoEngageが送信するイベントが反映される前に、Ads Managerで各コンバージョンイベントを作成する必要があります。MoEngageからイベントが正しく送信されていても、OpenAI Ads Managerに対応するコンバージョンイベントが存在しない場合、レポートには表示されません。 追跡するイベントごとに、以下の手順を実行します。

1. OpenAI Ads Managerアカウントにログインします。
2. 左側のナビゲーションメニューで、Settings > General > Manage conversion keysに移動します。
3. Conversion Eventsタブをクリックします。
4. 右上隅にあるCreateをクリックし、Conversion Eventを選択します。
5. Base Eventリストで、追跡するイベントを選択します。
6. コンバージョンイベントの名前を入力します。
7. Data sourceで、ステップ1.1: Pixel IDを取得するセクションで作成したデータソースを選択します。
8. Createをクリックします。

追跡するすべてのイベントについて、これらの手順を繰り返します。OpenAIがサポートするイベントについては、OpenAIドキュメントのSupported Eventsを参照してください。

​

ステップ2: App MarketplaceでOpenAI Ads Conversionsを接続する

App MarketplaceでOpenAI Ads Conversionsを接続するには、以下の手順を実行します。

1. MoEngage UIの左側のナビゲーションメニューで、App Marketplaceをクリックします。
2. 検索ボックスに「OpenAI Ads Conversions」と入力します。
3. Search resultsで、OpenAI Ads Conversionsタイルをクリックします。
4. Integrateタブをクリックします。
5. + Add integrationをクリックします。
6. 以下の詳細を入力します。

   フィールド	必須	説明
   Connection name	はい	接続の一意の内部名（例: OpenAI Ads - Production）。
   API Key	はい	ステップ1.2: Conversions APIキーを生成するセクションで生成した、OpenAI Ads ManagerのBearerトークン。API呼び出しを承認します。
   Pixel ID	はい	ステップ1.1: Pixel IDを取得するセクションで取得した、OpenAI Ads ManagerのPixel ID。コンバージョンシグナルを正しいデータセットに送信します。

7. Testをクリックして接続を検証し、保存します。

Integrateタブには、作成した各接続が、そのステータス、連携タイプ、最終更新者とともに一覧表示されます。Statusトグルを使用すると、接続を削除せずにオフにできます。

​

ステップ3: OpenAI Ads Conversionsキャンペーンを作成する

OpenAI Ads Conversionsキャンペーンを作成するには、以下の手順を実行します。

1. MoEngage UIの左側のナビゲーションメニューで、+ Create Newをクリックし、Campaignをクリックします。
2. Connected Appsで、See allをクリックします。
3. Connected AppsダイアログボックスでOpenAI Adsを検索し、OpenAI Ads Conversionsタイルをクリックします。
4. 必要な配信タイプ（One Time、Periodic、またはEvent Triggered）をクリックします。
5. Step 1（Target users）で、オーディエンスを選択します。
6. Step 2（Content）のSelect connectorで、ConnectorリストからTrack OpenAI Ad Conversionsを選択し、Connectionsリストから接続を選択します。
7. Conversion Goalsで、以下を入力します。

   フィールド	必須	説明
   Event Type	はい	OpenAIの標準分類から選択する、追跡対象のコンバージョンイベント。デフォルトはOrder Createdです。
   Custom Event Name	条件付き	Event TypeがCustomの場合にのみ必須です。小文字、数字、アンダースコア、ダッシュを使用して1～64文字で入力します。
   Action Source	はい	コンバージョンが発生したチャネル（Web、Mobile App、Offline、Physical Store、Phone Call、Emailなど）。デフォルトはWebです。
   Event ID	はい	重複排除に使用される一意の取引ID、注文ID、またはイベントID。このIDを持つ最初のシグナルのみが記録されるようにします。
   Currency	条件付き	コンバージョン値のISO 4217通貨コード。Conversion Valueを入力する場合は必須です。デフォルトはUSDです。
   Conversion Value	いいえ	コンバージョンの金銭的価値。通貨の最小単位の整数で指定します。

   Action Sourceによってオムニチャネルトラッキングが可能になり、アプリでのインタラクション、Webサイトへの訪問、実店舗での購入にコンバージョンをアトリビューションできます。任意のテキストボックスに@と入力すると、ユーザー属性またはイベント属性を使用して値をパーソナライズできます。
8. Attributionで、以下を入力します。

   フィールド	必須	説明
   Source URL	条件付き	コンバージョンが発生したURL（例: https://shop.example.com/checkout/confirmation）。Action SourceがWebの場合は必須です。
   IP Address	いいえ	ユーザーマッチングの改善に使用されるIPv4またはIPv6アドレス。ハッシュ化されずにそのまま送信されます。
   Browser Details	いいえ	ブラウザのUser-Agent文字列。クロスデバイスのアトリビューションに役立ちます。

   Webコンバージョンのクリックスルーアトリビューションの精度が向上するため、可能な限りSource URLを含めてください。
   
9. Advanced Matchingで、以下を入力します。これらの識別子は、OpenAIがコンバージョンを特定のユーザーに関連付けるのに役立ちます。MoEngageは、送信前に個人を特定できる情報（PII）を正規化し、SHA-256でハッシュ化します。

   フィールド	必須	説明
   External ID	いいえ	社内の顧客IDまたはユーザーID（例: customer_12345）。SHA-256ハッシュ化で保護されます。
   Country	いいえ	2文字のISO 3166-1国コード（例: US）。そのまま送信されます。
   City	いいえ	都市名。自動的に小文字に変換されます。最大128文字です。
   Zip Code	いいえ	郵便番号またはZIPコード。そのまま送信されます。最大32文字です。

   MoEngageはメールアドレスを独自に送信するため、メールアドレスが登録されていないユーザーについては、これらの識別子を少なくとも1つマッピングしてください。マッチングシグナルがまったくないコンバージョンは、広告にアトリビューションできません。
   ユーザーのメールアドレスは標準属性から自動的に取得されるため、フィールドとしては表示されません。MoEngageは、エイリアスとピリオドを除去し、文字列を小文字に変換してから、SHA-256ハッシュ化を適用して送信します。
   
10. Event DataのConversion Event Dataブロックで、Keyボックスにキーを入力し、隣接するボックスにその値を入力します。追加のペアごとに**+ New KV Pair**をクリックします。

    キー	適用対象	説明
    amount	すべてのイベント	アイテムの金銭的価値。ISO 4217に従った通貨の最小単位の整数で指定します。たとえば、$42.00 USDの場合は4200です。
    currency	amountを含むすべてのイベント	アイテムのISO 4217通貨コード（USDやEURなど）。amountが存在する場合は常に必須です。
    plan_id	Subscriptions、Custom	社内のサブスクリプションまたはプランの識別子（例: plan_starter）。
    item_id	Purchase、Subscriptions、Custom	社内の製品またはアイテムの識別子（例: sku_12345）。
    item_name	Purchase、Subscriptions、Custom	製品名（例: Premium Subscription）。
    item_quantity	Purchase、Subscriptions、Custom	アイテムの数（整数）。
    content_type	すべてで任意	アイテムのカテゴリまたはタイプ（例: product）。
    group_id	すべてで任意	製品グループまたはバンドルの識別子（例: bundle_summer_2024）。
    variant_dict.size	すべてで任意	製品バリアントのサイズ（例: large）。
    variant_dict.color	すべてで任意	製品バリアントの色（例: blue）。

    amountキーとcurrencyキーは、個々のアイテムの価値を設定します。Conversion GoalsのCurrencyフィールドとConversion Valueフィールドは、コンバージョンイベント自体の価値を設定するため、この2つは別のものです。
11. Test Campaignで、識別子のタイプを選択し、テストユーザーの値を入力して、Testをクリックします。
12. Nextをクリックし、Step 3（Schedule and Goals）を設定して、キャンペーンを公開します。

テストキャンペーンではフリークエンシーキャップが無視されます。本番環境に公開する前に、コネクタの設定をテストしてください。

​

カスタムイベント

OpenAIの標準分類以外のコンバージョンを追跡するには、以下の手順を実行します。

1. Conversion Goalsで、Event TypeリストからCustomを選択します。
2. Custom Event Nameボックスに、小文字、数字、アンダースコア、ダッシュを使用して1～64文字の名前を入力します。スペースはサポートされていません。
3. Event Dataで、イベントに適用されるキーをマッピングします。

有効なカスタムイベント名の例としては、video_completed、ebook_downloaded、webinar_registeredがあります。

​

サポートされるコンバージョンイベント

MoEngageは、OpenAIの標準イベント分類への直接マッピングをサポートしています。Event Typeリストで追跡するイベントを選択します。サポートされるイベントの完全なリストと、各イベントが受け付けるデータについては、OpenAIドキュメントのSupported Eventsを参照してください。

​

使用上の制約

• 金額の形式: コンバージョン値は、通貨の最小単位の整数で送信します。たとえば、$42.00 USDは4200、€29.99 EURは2999、£1.50 GBPは150、¥100 JPYは10000です（JPYには小数の補助単位がないため）。コンバージョン値を送信する場合は、必ずCurrencyフィールドを設定してください。
• 重複排除の衛生管理: 取引IDや注文IDなど、一意のEvent IDをマッピングします。OpenAIはEvent IDの最初の発生のみを記録し、重複を無視するため、過大なレポートを防止できます。
• ユーザーマッチングとプライバシー: MoEngageは個人を特定できる情報（PII）をネイティブに正規化し、SHA-256でハッシュ化するため、生の値をコネクタに直接渡してください。
• タイムスタンプの精度: イベントのタイムスタンプは過去7日以内である必要があり、10分以上先の未来にすることはできません。タイムスタンプを省略した場合、MoEngageは現在のタイムスタンプを入力します。
• レート制限とバッチ処理: OpenAI Conversions APIは、1リクエストあたり最大1,000件のイベントのバッチを受け付けます。バッチ内の1つのイベントがスキーマ検証に失敗すると、バッチ全体が失敗するため、すべてのイベントのデータの整合性を確認してください。

​

よくある質問