(API変換）APIメタ変換

フォローする
Avatar
Jonathan Chen
Updated
ドキュメント
ウェブ、PC、コンソールイベントのコンバージョンポストバックは、Singularのウェブ、PC、コンソールゲームのアトリビューションにアクセスできるSingularのお客様のみがご利用いただけます。

SingularとMeta Conversions APIとの統合により、広告主はSingularアトリビューションのMetaクリックコンバージョンをMetaに送信することができます。この統合は、Singularのウェブ、PC、コンソールの測定に対応しています。Singularのモバイル測定とMetaの統合については、ヘルプセンターの記事をご覧ください。

Meta Conversions API統合の設定方法

  1. Singularと統合されたウェブ、PC、またはコンソールアプリがあることを確認します。
  2. Singular > Attribution > Partner Configurationに進みます。
  3. Add a Partner "をクリックし、"Meta Conversions API "と入力して選択します。
  4. ダイアログで、設定するアプリとアプリサイト（プラットフォーム）を選択します。この統合でサポートされているのは、ウェブ、PC、コンソールアプリのみです。
  5. Meta Event Managerダッシュボードから、アプリの"Access Token"と "Dataset ID"を貼り付けます。


  6. オプションで、Metaに送信する追加イベントを設定し、"Meta Event Name "にマッピングします。


  7. 保存」をクリックして完了です。

よくある質問

Meta Dataset IDはどこにありますか？
  1. Meta Event Managerに移動します。
  2. データソース]で、ウェブ/PC/コンソールのデータソースを選択してください。

    新しいデータソースの場合は、"Connect Data Sources"から新しいデータソースを作成し、Metaのステップバイステップガイドに従って"Web"データソースを作成してください。Metaデータソースについての詳細はこちらをご覧ください。
  3. 設定"の下にある"データセットID"をコピーしてください。
アクセストークンはどこにありますか？
  1. メタ・イベント・マネージャーに移動してください。
  2. データソース]で、ウェブ/PC/コンソールのデータソースを選択してください。


    これが新しいデータソースである場合、"Connect Data Sources"から新しいデータソースを作成し、Metaのステップバイステップガイドに従って"Web"データソースを作成してください。Metaデータソースについて詳しくはこちらをご覧ください。
  3. 設定」で「コンバージョンAPI」までスクロールダウンし、「直接統合の設定」でアクセストークンを生成し、コピーします。

SingularはどのようなデータをAPI経由で送信しますか？
パラメータ 詳細
event_name
  • 標準イベントまたはカスタムイベント名。このフィールドは自動的に Singular Event Name にマップされる。この値はMETAによるイベントの重複排除を支援するために使用されます。event_idパラメータも重複排除に使用されます。
fbc
  • FacebookクリックID
  • 自動的に渡される
hashed email
  • オプション
  • ハッシュされたEメールはSingular instrumented event属性 "ehash "として渡される。
  • ハッシュされたEメール値は正規化され、SHA 256ハッシュされなければならない。
hashed phone number
  • オプション
  • ハッシュ化された電話番号は、Singular instrumented event属性 "phash "として渡すことができる。
  • ハッシュ化された電話番号は、E164で正規化され、SHA 256でハッシュ化されていなければならない。
hashed first name
  • オプション
  • ハッシュ化された姓は、Singular instrumented event属性 "fnamehash "として渡すことができる。
  • ローマ字の a-z 文字を使用することを推奨する。小文字のみで、句読点は使用しない。特殊文字を使用する場合、テキストはUTF-8フォーマットでエンコードされなければならない。
  • ハッシュされたファーストネームはSHA256ハッシュされたものでなければならない。
hashed last name
  • オプション
  • ハッシュされた姓は、Singular instrumented event属性 "fnamehash "として渡すことができる。
  • ローマ字のa～zを推奨。小文字のみ、句読点なし。特殊文字を使用する場合、テキストはUTF-8フォーマットでエンコードされなければならない。
  • ハッシュされた姓はSHA256ハッシュされたものであること。
IP address
  • クライアントIPアドレス
user agent
  • (ウェブのみ)イベントに対応するブラウザのユーザーエージェント
イベントの重複排除（オプション）
event_id
  • 重複排除のための必須パラメータ
  • イベントの引数で、"eventId"という属性名を使ってevent_idの値をSingularに渡す。

メタ要件：

  • event_idパラメータは、Conversions API とブラウザピクセルの両方からイベントに追加する必要があります。
  • event_idパラメータは、類似したイベントを一意に区別できる識別子です。event_idパラメータについての詳細はこちらをご覧ください。
Meta Conversions APIの制限事項は何ですか？
  • Metaは、Meta Conversion APIを既存のMetaピクセルの実装を補強するために使用することを推奨しています。
  • モバイルインテグレーションについては、MetaとSingularはSingularのモバイルアトリビューション専用インテグレーションを通してモバイルコンバージョンデータをMetaに渡すことを推奨します。Meta Conversions APIを通してモバイルコンバージョンデータを渡すことに興味がある場合は、Singularカスタマーサクセスマネージャーまでご連絡ください。