Meta Ads 連携
adstage では、Meta Ads（Facebook・Instagram）で運用中の広告キャンペーンの費用データを収集し、adstage で収集したコンバージョンイベントを Meta へ送り返すコンバージョン API（CAPI）を連携できます。Meta Ads 連携は チャネル連携、費用連携、コンバージョン API の 3 つのタブで構成されています。
1. 連携の概要
adstage ダッシュボードの 連携 > 広告チャネル連携 > Meta Ads で、以下の項目を設定します。
| タブ | 役割 |
|---|---|
チャネル連携 | Android Install Referrer の復号に必要な Facebook App ID と復号キーを登録します。 |
費用連携 | OAuth で Meta 広告アカウントを接続し、キャンペーンの費用データを収集します。 |
コンバージョン API | adstage が収集したイベントを Meta Conversions API（CAPI）でサーバー側から送信します。 |
2. 費用を連携する
費用連携 タブで Meta 広告アカウントを接続すると、Meta Ads で運用中のキャンペーンの費用データを adstage ダッシュボードで確認できます。
Meta アカウントで連携する
Meta Business ログイン（OAuth）方式を使って安全に認証します。
-
費用連携タブで費用データの収集スイッチを有効にします。 -
連携アカウントを追加ボタンをクリックします。Facebook ビジネスログインのウィンドウが新しいウィンドウで開きます。 -
Meta アカウントでログインし、adstage が広告データにアクセスできるよう権限を承認します。
連携の事前準備
費用連携を行うには、Meta ビジネスマネージャ（Business Manager）へのアクセス権限と、該当する広告アカウントの管理者権限が必要です。
広告アカウントを選択する
認証が完了すると、その Meta アカウントでアクセスできる広告アカウントの一覧が表示されます。
-
連携する広告アカウントを 1 つ以上選択します。アカウント名、広告アカウント ID（Ad Account ID）、ビジネスマネージャ（Business Manager）の情報が表示されるので、正しいアカウントかどうかを確認します。
-
アカウント名や ID で一覧を検索でき、
すべて選択でまとめて選択することもできます。 -
選択したアカウント数を確認して連携を確定すると、その広告アカウントが adstage と連携されます。
ご注意ください
すでに登録済みの広告アカウントは連携の対象外になります。選択したアカウントがすべて登録済みの場合、連携は行われません。
連携アカウントを管理する
連携した広告アカウントは、費用連携 タブのアカウント一覧で次の情報を確認できます。
| 項目 | 説明 |
|---|---|
広告アカウント | Meta 広告アカウント名と広告アカウント ID（Ad Account ID） |
ステータス | 費用連携のステータス（準備中、成功、失敗） |
最終データ更新 | 直近のデータ収集日時 |
Facebook アカウント | 連携に使用した Meta アカウントのメールアドレスまたは名前 |
管理 | アカウント連携の解除（削除） |
連携を解除するには、アカウント一覧で該当アカウントの削除ボタンをクリックし、確認メッセージで 削除 を選択します。
ご注意ください
アカウントを削除すると、そのアカウントのデータ収集が停止します。すでに収集した過去のデータは adstage に保管されますが、新しいデータは収集されません。
収集されるデータ
費用データは次のように収集されます。
| 項目 | 説明 |
|---|---|
| 収集周期 | 4 時間ごとに自動収集 |
| データの階層 | キャンペーン、広告セット（Ad Set）、広告（Ad）レベルの詳細データ |
| 収集指標 | 費用などキャンペーン別の成果データ |
3. コンバージョン API（CAPI）を連携する
コンバージョン API タブで Meta Conversions API（CAPI）を連携すると、Facebook SDK をアプリに組み込まなくても、adstage が収集したイベントをサーバー側から Meta へ送信できます。iOS の ATT 環境でも、サーバー側からの送信によってアトリビューションの精度を高められます。
Pixel ID を入力する
Meta イベントマネージャ（Events Manager） で Pixel ID を確認して入力します。
- 確認手順：イベントマネージャ → データソース → Pixel を選択 → 設定 → Pixel ID
アクセストークンを入力する
イベントマネージャでコンバージョン API 用のアクセストークンを生成して入力します。
- 生成手順：イベントマネージャ → データソース → Pixel を選択 → 設定 → Conversions API → アクセストークンを生成
アクセストークンは暗号化して保存されます
保存したアクセストークンは暗号化して安全に保管され、保存後は再表示されません。変更する場合は、新しいトークンを入力し直してください。
テストイベントコード（任意）
本番のレポートに影響を与えずにイベントを検証するには、テストイベントコードを設定します。本番モードに切り替えるときは、コードを空にしてもう一度保存します。
- 確認手順：イベントマネージャ → テストイベント（Test Events）タブ → テストコードを確認
接続テストとイベント転送の設定
Pixel ID とアクセストークンを保存すると、次の機能を使用できます。
| 項目 | 説明 |
|---|---|
接続テスト | テストイベントを送信し、CAPI の設定が正常に動作しているかを確認します。 |
イベント転送の設定 | 収集したイベントごとに Meta への送信をオン／オフでき、各 adstage イベントをどの Meta イベントとして送るかをマッピングします。 |
イベント転送の設定には、実際に収集されたイベントのみが表示されます。まだ収集されたイベントがない場合は、アプリからデータが届いた後に一覧に表示されます。
CAPI の動作の仕組み
- ユーザーのメールアドレスと電話番号は、Meta へ送信される前に SHA256 でハッシュ化されます。
- event_id による重複排除が自動で適用され、ブラウザピクセルとの二重計上を防ぎます。
- サーバー側からのイベント送信によって iOS の ATT の制限を回避し、アトリビューションの精度が向上します。
4. チャネルを連携する
チャネル連携 タブでは、Android の Facebook Install Referrer の復号に必要な情報を登録します。
Facebook App ID を確認する
Meta for Developers でアプリを登録してから App ID を確認し、入力します。
- 確認手順：Dashboard → アプリを選択 → 設定（Settings） → ベーシック（Basic） → App ID
復号キーを入力する
Meta が発行した 32 バイトの復号キー（HEX 64 文字）を入力します。
- 確認手順：Dashboard → アプリを選択 → 設定（Settings） → 詳細設定（Advanced） → Install Referrer Decryption Key
復号キーは暗号化して保存されます
保存した復号キーは暗号化して安全に保管され、保存後は再表示されません。変更する場合は、新しいキーを入力し直してください。
5. 注意事項
以下の点にご注意ください。
- Meta Ads と adstage の間で数値に差が生じることがあります。これは集計のタイミング、タイムゾーン、フィルタリング基準の違いによるものです。
- Meta アカウントの権限を取り消したり、トークンの有効期限が切れたりすると、データ収集が停止することがあります。
- 広告チャネルでキャンペーン名を変更した場合、adstage に反映されるまで時間がかかることがあります。
- コンバージョン API を有効にするには、Pixel ID とアクセストークンの両方が保存されている必要があります。