> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversions API (CAPI) を使い始める

> Profound Pixel の Conversions API の概要、使用する場面、認証方法

Conversions API (CAPI) は、[Profound Pixel](https://docs.tryprofound.com/ja-jp/pixel/overview.md) のサーバーサイドのチャネルです。バックエンドからコンバージョンイベントを Profound に直接送信するため、訪問者のブラウザーでは何も実行されません。広告ブロッカーやプライバシー重視のブラウザーによってイベントが失われることはなく、訪問から数時間後に確定した注文も記録されます。

この API はブラウザーのピクセルと同じ[イベント](https://docs.tryprofound.com/ja-jp/pixel/events.md)を受け付け、同じ場所に記録します。異なるのは送信経路だけです。

## 使用する場面

決済 Webhook、オフラインや電話での注文、サブスクリプションの更新など、コンバージョンがサーバー上で確定する場合に Conversions API を使用します。

コンバージョンのカバレッジを高めるには、[ブラウザーのピクセル](https://docs.tryprofound.com/ja-jp/pixel/overview.md)を使用したうえで、同じコンバージョンをサーバーからも送信することをお勧めします。両者は失敗する箇所が異なります。ブラウザーのピクセルはサーバーからは見えない訪問や意図を記録し、サーバーは広告ブロッカー、閉じられたタブ、プライバシー重視のブラウザーによって失われてしまう注文を記録します。両方を組み合わせることで、どちらか一方だけの場合よりもはるかに多くをカバーできます。

> [!TIP]
>
> Profound がイベントのペアを照合できるよう、両方のイベントで同じ注文 ID を `dedup_key` として送信してください。[重複排除](https://docs.tryprofound.com/ja-jp/pixel-conversions-api/post-events.md#deduplication)を参照してください。

## 始める前に

* **ピクセル ID を用意します。** 各イベントには、そのイベントが属するピクセルを指定します。ピクセル ID の生成方法は[インストールガイド](https://docs.tryprofound.com/ja-jp/pixel/install.md#step-1)に記載されています。
* **コンバージョンを広告に紐づけるには、ブラウザーのピクセルをインストールします。** コンバージョンを広告に紐づけるための値は、ブラウザーのピクセルが書き込む Cookie から取得されます。これらがない場合、Profound はコンバージョンを記録しますが、広告に紐づけることはできません。[アトリビューション](https://docs.tryprofound.com/ja-jp/pixel-conversions-api/post-events.md#attribution)を参照してください。

## CAPI キーを取得する

> [!NOTE]
>
> CAPI には専用のホストとキーがあります。[認証](https://docs.tryprofound.com/ja-jp/rest-api/authentication.md)で説明している REST API キーはここでは使用できません。

**1. キーを生成する**

Profound プラットフォームで左側のナビゲーションから **Ads** を開き、**Conversions** を選択してから、**Conversions API** の下で **Generate CAPI key** を選択します。

キーを生成するには、ピクセル設定の権限が必要です。ボタンが表示されない場合は、[Admin または Editor ロール](https://docs.tryprofound.com/ja-jp/platform-config/people/roles-and-permissions)を持つユーザーにキーの生成を依頼してください。

**2. キーをコピーする**

キーは `pfck_` で始まります。Profound がキーを表示するのは作成時の 1 回だけなので、すぐにコピーしてください。

**3. 安全な場所に保管する**

キーはシークレットとして扱ってください。キーは組織全体を認証し、組織が所有するすべてのピクセルに書き込むことができます。

1 つの組織で保持できる有効なキーは最大 10 個です。失効したキーは上限にカウントされません。
