Meta Conversions API拡張機能の概要

Meta Conversions APIでは、広告のターゲティングを最適化し、アクション単価を削減し、結果を測定するために、サーバーサイドのマーケティングデータをMeta テクノロジーに接続できます。 イベントはMeta Pixel IDにリンクされ、クライアントサイドのイベントと同様の方法で処理されます。

Meta Conversions API拡張機能を使用すると、​ イベント転送 ルールのAPI機能を活用して、Adobe Experience Platform Edge NetworkからMetaにデータを送信できます。 このドキュメントでは、拡張機能をインストールし、イベント転送​ ルール ​でその機能を使用する方法について説明します。

デモ

次のビデオは、Meta Conversions APIに関する理解を深めることを目的としています。

前提条件

Meta PixelとConversions APIを使用して、それぞれクライアントサイドとサーバーサイドで同じイベントを共有および送信することを強くお勧めします。これは、Meta Pixelによってピックアップされなかったイベントを回復するのに役立つ可能性があります。 Conversions API拡張機能をインストールする前に、Meta Pixel 拡張機能のガイドで、クライアントサイドのタグ実装に統合する手順を確認してください。

NOTE
このドキュメントの後半の​ イベント重複排除に関する節では、同じイベントがブラウザーとサーバーの両方から受信される可能性があるため、同じイベントが2回使用されないようにするための手順について説明します。

Conversions API拡張機能を使用するには、イベント転送へのアクセス権があり、MetaおよびAd Managerへのアクセス権を持つ有効なEvent Manager アカウントが必要です。 具体的には、拡張機能をアカウントに設定できるように、既存のMeta PixelのIDをコピー(または新しい Pixelを作成)する必要があります。

INFO
この拡張機能をモバイルアプリデータで使用する場合、またはMeta キャンペーンでオフラインイベントデータも使用する場合は、既存のアプリを使用してデータセットを作成し、プロンプトが表示されたら「ピクセル IDから作成」を選択する必要があります。 詳しくは、​ ビジネスに適したデータセット作成オプションを決定の記事を参照してください。 すべての必須およびオプションのアプリトラッキングパラメーターについては、Conversions API for App Events ドキュメントを参照してください。

拡張機能のインストール

Meta Conversions API拡張機能をインストールするには、Data Collection UIまたはExperience Platform UIに移動し、左側のナビゲーションから​ Event Forwarding ​を選択します。 ここで、拡張機能を追加するプロパティを選択するか、代わりに新しいプロパティを作成します。

目的のプロパティを選択または作成したら、左側のナビゲーションで「Extensions」を選択し、「Catalog」タブを選択します。 Meta Conversions API カードを検索し、Install​を選択します。

データ収集UIのInstall拡張機能にMeta Conversions API オプションが選択されています。

表示される設定ビューで、拡張機能をアカウントにリンクするには、先ほどコピーしたPixel IDを指定する必要があります。 IDを入力に直接貼り付けることも、代わりにデータ要素を使用することもできます。

また、Conversions APIを具体的に使用するには、アクセストークンを指定する必要があります。 この値を取得する手順については、Conversions API アクセストークンの生成に関する ドキュメントを参照してください。

完了したら、Save​を選択します

拡張機能の設定ビューでデータ要素として指定されたPixel ID。

拡張機能がインストールされ、イベント転送ルールでその機能を使用できるようになりました。

FacebookおよびInstagram拡張機能との統合 facebook

FacebookとInstagramの拡張機能を使用した統合により、Meta法人用アカウントにすばやく認証できます。 これにより、Pixel IDとMeta Conversions API Access Tokenが自動入力され、Meta Conversions APIのインストールと設定が簡単になります。

Meta Conversions API拡張機能のインストール時に、FacebookおよびInstagramで認証を行うためのダイアログプロンプトが表示されます。

Meta Conversions API Extensionを強調表示するConnect to Meta インストールページ。

FacebookおよびInstagramで認証するためのダイアログプロンプトが、イベント転送内のクイックスタートワークフローUIにも表示されます。

Connect to Metaを強調表示するクイックスタートワークフローUI。

イベント品質マッチスコア(EMQ)との統合 emq

イベント品質マッチスコア(EMQ)との統合により、EMQ スコアを表示することで、実装の有効性を簡単に確認できます。 この統合により、コンテキストの切り替えが最小限に抑えられ、Meta Conversions APIの実装を成功に導くことができます。 これらのイベントスコアは、Meta Conversions API extension設定画面に表示されます。

Meta Conversions API Extensionを強調表示するView EMQ Score設定ページ。

LiveRamp (Alpha)との連携 alpha

サイトにLiveRampの認証トラフィック ソリューション (ATS)をデプロイしているLiveRamp人のお客様は、顧客情報パラメーターとしてRampIDを共有することを選択できます。 Meta アカウント チームと協力して、この機能のAlpha プログラムに参加してください。

Meta イベント転送Ruleの設定ページ(Partner Name (alpha)とPartner ID (alpha)を強調表示)。

イベント転送ルールの設定 rule

この節では、汎用イベント転送ルールでConversions API拡張機能を使用する方法について説明します。 実際には、受け入れられたすべての標準イベント ​をMeta PixelおよびConversions API経由で送信するために、いくつかのルールを設定する必要があります。 モバイルアプリのデータについては、必須フィールド、アプリのデータフィールド、顧客情報パラメーター、カスタムデータの詳細ここを参照してください。

NOTE
イベントは、​ リアルタイムで送信するか、広告キャンペーンの最適化を向上させるために、できるだけリアルタイムに近い状態にする必要があります。

新しいイベント転送ルールの作成を開始し、必要に応じて条件を設定します。 ルールのアクションを選択する際に、拡張機能に「Meta Conversions API Extension」を選択し、アクションタイプに「Send Conversions API Event」を選択します。

データ収集UIでルールに対して選択されているSend Page View アクションタイプ。

Metaを介してConversions APIに送信されるイベントデータを設定できるコントロールが表示されます。 これらのオプションは、指定された入力に直接入力することも、既存のデータ要素を選択して値を表すこともできます。 設定オプションは、次の4つの主なセクションに分かれています。

設定セクション
説明
Server Event Parameters
イベントの発生時間と、イベントをトリガーしたソースアクションを含む、イベントに関する一般的な情報。 Metaが受け入れた標準イベントパラメーターについて詳しくは、Conversions API開発者ドキュメントを参照してください。

イベントの送信にMeta PixelとConversions APIの両方を使用している場合は、これらの値が​Event Name イベントの重複排除event_nameに使用されるので、必ず​Event IDevent_id)と​ ()の両方をイベントごとに含めてください。

お客様のオプトアウトに対応するために​ Enable Limited Data Use ​のオプションも利用できます。 この機能について詳しくは、Conversions API データ処理オプション に関するのドキュメントを参照してください。
Customer Information Parameters
イベントを顧客に関連付けるために使用されるユーザーID データ。 これらの値の一部は、APIに送信する前にハッシュ化する必要があります。

共通API接続と高いイベントマッチ品質(EMQ)を確保するために、すべての許可された顧客情報パラメーターをサーバーイベントと一緒に送信することをお勧めします。 これらのパラメーターも、その重要性とEMQへの影響に基づいて優先順位付けする必要があります。
Custom Data
広告配信の最適化に使用する追加データ。JSON オブジェクトの形式で提供されます。 このオブジェクトに使用できるプロパティについて詳しくは、Conversions API ドキュメント ​を参照してください。

購入イベントを送信する場合は、このセクションを使用して、必要な属性currencyvalueを指定する必要があります。
Test Event
このオプションは、設定によってサーバーイベントが期待どおりにMetaに受信されているかどうかを確認するために使用されます。 この機能を使用するには、Send as Test Event チェックボックスを選択し、以下の入力で任意のテストイベントコードを指定します。 イベント転送ルールがデプロイされたら、拡張機能とアクションを正しく設定すると、Test Events​のMeta Events Manager ビュー内にアクティビティが表示されます。

完了したら、Keep Changes​を選択して、アクションをルール設定に追加します。

アクション設定に Keep Changesが選択されています。

ルールに問題がなければ、Save to Library​を選択します。 最後に、新しいイベント転送​ ビルド ​を公開して、ライブラリに加えられた変更を有効にします。

イベントの重複の除外 deduplication

前提条件セクション ​で説明したように、Meta Pixel タグ拡張機能とConversions API イベント転送拡張機能の両方を使用して、クライアントとサーバーから同じイベントを冗長な設定で送信することをお勧めします。 これは、どちらかの拡張機能によって取得されなかったイベントを回復するのに役立ちます。

クライアントとサーバーから異なるイベントタイプを送信する際に、2つのイベントタイプ間に重複がない場合は、重複を排除する必要はありません。 ただし、1つのイベントがMeta PixelとConversions APIの両方で共有されている場合は、レポートに悪影響が及ばないように、これらの冗長なイベントが重複しないように注意する必要があります。

共有イベントを送信する場合は、クライアントとサーバーの両方から送信するすべてのイベントにイベント IDと名前が含まれていることを確認してください。 同じIDと名前を持つ複数のイベントを受信すると、Metaは自動的に複数の戦略を採用して、重複を排除し、最も関連性の高いデータを保持します。 このプロセスについて詳しくは、Metaおよび​ イベント Meta Pixel の Conversions API 重複排除に関するのドキュメントを参照してください。

クイックスタートワークフロー:Meta Conversions API拡張機能(Beta) quick-start

IMPORTANT
  • クイックスタート機能は、Real-Time CDP PrimeとUltimate パッケージを購入したお客様が利用できます。 詳しくは、アドビ担当者にお問い合わせください。
  • この機能は新しい実装を対象としており、現在、既存のタグおよびイベント転送プロパティに対する拡張機能と設定の自動インストールはサポートしていません。
NOTE
既存のクライアントは、クイックスタートワークフローを使用して、次の場合に使用できる参照実装を作成できます。
  • 全く新しい実装の始まりとして使用してください。
  • 参照実装として利用して、どのように設定されているかを確認し、現在の実稼動実装で複製することができます。

クイックスタート機能では、Meta Conversions APIとMeta Pixel拡張機能を使用して、容易かつ効率的に設定できます。 このツールは、Adobeのタグとイベント転送で実行される複数のステップを自動化し、セットアップ時間を大幅に短縮します。

この機能は、新しく自動生成されたタグとイベント転送プロパティに、必要なルールとデータ要素を含むMeta Conversions APIとMeta Pixel拡張機能の両方を自動的にインストールして設定します。 さらに、Experience Platform Web SDKとデータストリームも自動インストールおよび設定されます。 さらに、クイックスタート機能により、ライブラリが開発環境で指定されたURLに自動公開され、クライアントサイドのデータ収集とサーバーサイドのイベント転送が、イベント転送とExperience Platform Edge Networkを通じてリアルタイムで可能になります。

次のビデオでは、クイックスタート機能の概要を説明します。

クイックスタート機能のインストール

NOTE
ガイド付き設定機能を使用すると、簡単かつ効率的に設定できます。 このツールは、Adobe タグとイベント転送で実行される複数の手順を自動化します。 あらゆるユースケースに対応できる、エンドツーエンドの機能的な導入を実現することはできません。

ガイド付き設定を開始するには、​ イベント転送ガイド付き設定の手順に従います。

追加イベントの追加

新しいイベントを追加するには、Edit Your Tags Web Property​を選択します。

タグのweb プロパティの編集を表示する次の手順ダイアログ

編集するメタイベントに対応するルールを選択します。 例:MetaConversion_AddToCart

NOTE
イベントがない場合、このルールは実行されません。 これは、すべてのルールに当てはまり、MetaConversion_PageView ルールは例外です。

イベントを追加するには、Add​見出しの下のEventsを選択します。

イベントを表示しない タグのプロパティ ページ

「Event Type」を選択します。この例では、Click イベントを選択し、.add-to-cart-button​が選択されたときにトリガーするように設定しました。 Keep Changes を選択します。

クリックイベントを表示する イベント設定画面

新しいイベントが保存されました。 Select a working library​を選択し、ビルドするライブラリを選択します。

作業用ライブラリのドロップダウンを選択

次に、Save to Library​の横にあるドロップダウンを選択し、Save to Library and Build​を選択します。 これにより、ライブラリの変更が公開されます。

ライブラリに保存してビルドを選択

設定する他のメタコンバージョンイベントに対して、これらの手順を繰り返します。

データレイヤー設定 configuration

IMPORTANT
このグローバルデータレイヤーの更新方法は、web サイトのアーキテクチャによって異なります。 単一ページアプリケーションは、サーバーサイドレンダリングアプリケーションとは異なります。 また、タグ製品内でこのデータの作成と更新を完全に担当する可能性もあります。 いずれの場合も、各MetaConversion_* rulesを実行する間にデータレイヤーを更新する必要があります。 ルール間でデータを更新しない場合は、現在のMetaConversion_* ruleの最後のMetaConversion_* ruleから古いデータを送信しているケースが発生する可能性もあります。

設定中に、データレイヤーの保存場所を尋ねられました。 デフォルトでは、これはwindow.dataLayer.metaであり、meta オブジェクト内では、次に示すようにデータが想定されます。

データレイヤーのメタ情報

これは、すべてのMetaConversion_* ルールがこのデータ構造を使用して、関連するデータをMeta Pixel拡張機能とMeta Conversions APIに渡すため、理解しておくことが重要です。 異なるメタイベントに必要なデータについて詳しくは、標準イベント ​に関するドキュメントを参照してください。

例えば、MetaConversion_Subscribe ルールを使用する場合、window.dataLayer.meta.currency標準イベント window.dataLayer.meta.predicted_ltvに関するドキュメントに記載されているオブジェクトプロパティに従って、window.dataLayer.meta.value、およびを更新する必要があります。

ルールを実行する前にデータレイヤーを更新するために、web サイトで実行する必要がある処理の例を以下に示します。

データレイヤーのメタ情報を更新

デフォルトでは、<datalayerpath>.conversionData.eventIdは、いずれかのMetaConversion_* rulesで「新しいイベント IDを生成」アクションによってランダムに生成されます。

データ層の外観をローカルで参照するには、プロパティのMetaConversion_DataLayer データ要素でカスタムコードエディターを開きます。

次の手順

このガイドでは、Meta拡張機能を使用してサーバーサイドのイベントデータをMeta Conversions APIに送信する方法について説明しました。 ここから、さらにPixelsを接続し、該当する場合はイベントを共有して、統合を拡張することをお勧めします。 次のいずれかを行うと、広告のパフォーマンスをさらに向上させることができます。

  • Pixels統合にまだ接続されていない他のConversions APIを接続します。
  • クライアントサイドのMeta Pixel経由でのみ特定のイベントを送信する場合は、サーバーサイドからもConversions APIに同じイベントを送信します。

統合を効果的に実装する方法について詳しくは、Metaの Conversions API ベストプラクティスに関するのドキュメントを参照してください。 Adobe Experience Cloudでのタグおよびイベント転送に関する一般的な情報については、​ タグの概要を参照してください。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743