リード獲得向けConversion API

Conversion APIを使用して、ウェブサイトのリード獲得（lead gen）イベントを送信します。AppLovinは、最適なキャンペーンパフォーマンスを達成するために、広告主様がAppLovin Pixelと併用してConversion APIを使用することを推奨しています。

リクエスト形式

AppLovin Event APIに1つ以上のイベントを送信するには、https://b.applovin.com/v1/event に HTTP POST リクエストを送信します。

認証

クエリパラメータ

AppLovin Event KeyおよびConversion API Keyは、AppLovin dashboardのKeysセクションから取得してください。

レスポンスコード

POSTペイロード

HTTPリクエストの POST ペイロードには、送信する1つまたは複数のイベントを記述します。

Server event

Event data

data はすべてのイベントで必須です。

• page_view の場合、data を null に設定します。

• generate_lead の場合、常に { "currency": "«ISO-4217»", "value": «number» } を送信します。

オプションのイベント

app_open イベントは、モバイルアプリの連携専用です。 ユーザーがアプリを起動したときにこのイベントをトリガーします。 このイベントで渡すデータオブジェクトはありません。

User data

aleidの送信

aleid は、ユーザーがAppLovin広告をクリックした後に、AppLovinがウェブサイトのURLに追加するクエリパラメータです。

このパラメータの存在を利用して、どのクリックがAppLovinからのものであるかを識別します。

aleid を送信するには、次のいずれかの方法を実行できます。

1. サイトにAppLovin Pixelがインストールされている場合、AppLovin Pixelは aleid クエリパラメータを検出すると、自動的にクッキー _axeid を設定します。 このクッキーが存在する場合は常にその値を読み取り、リクエストの aleid クエリパラメータの値として送信します。
2. aleid URLクエリパラメータが存在することを確認したら、その値を取得します。 サーバーが aleid クエリパラメータを検出したら、サーバー側でそのパラメータを読み取ります。 AppLovinは、これをサイト上の _axeid という名前のHTTPクッキーとして設定することを推奨します。 このクッキーの有効期限は1年に設定してください。 前の方法と同様に、このクッキーが存在する場合は常にその値を読み取り、リクエストの aleid クエリパラメータの値として送信します。

ユーザー識別子の送信

client_id

サイトにAppLovin Pixelがインストールされていない場合は、訪問者を識別するために保存している別の安定したファーストパーティクッキーを渡します。 これはグローバルに一意であり、ユーザーのブラウジングセッション間で同一に維持される必要があります。

axwrt

サイトにAppLovin Pixelがインストールされている場合、AppLovin Pixelは自動的にクッキー _axwrt を設定します。

alart

アプリユーザーの場合、alart URLクエリパラメータが存在することを確認したら、その値を取得します。

user_id

システムにおける顧客の一意の識別子。 これは、ユーザーセッション間で一貫して維持される安定した識別子である必要があります。

email

ユーザーのメールアドレス。 AppLovinは、プライバシー保護のためにこの値をSHA-256を使用して自動的にハッシュ化します。 AppLovinのガイドラインに従って識別子を前処理する場合は、独自のSHA-256ハッシュを提供することもできます。

phone

ユーザーの電話番号。 AppLovinは、プライバシー保護のためにこの値をSHA-256を使用して自動的にハッシュ化します。 AppLovinのガイドラインに従って識別子を前処理する場合は、独自のSHA-256ハッシュを提供することもできます。

ペイロードの例

ページビューイベント

{
  "events": [
    {
      "event_time": 1741784485001,
      "event_source_url": "https://applovin.com",
      "name": "page_view",
      "user_data": {
        "client_ip_address": "172.59.8.172",
        "client_user_agent": "chrome/123.456 android mobile",
        "aleid": "_aleid-query-param",
        "axwrt": "_axwrt-cookie-value",
        "user_id": "_user_id",
        "phone": "+1123456789",
        "email": "user@example.com",
        "client_id": "_first_party_identifier",
        "sid": "sid",
        "ifa": "idfa",
        "idfv": "idfv",
        "os": "macos",
        "esi": "web",
        "zip": "12345",
        "country_code": "US"
      },
      "data": null
    }
  ]
}

リード獲得イベント

{
  "events": [
    {
      "event_time": 1741784485001,
      "event_source_url": "https://applovin.com",
      "name": "generate_lead",
      "user_data": {
        "client_ip_address": "172.59.8.172",
        "client_user_agent": "chrome/123.456 android mobile",
        "aleid": "_aleid-query-param",
        "axwrt": "_axwrt-cookie-value",
        "user_id": "_user_id",
        "phone": "+1123456789",
        "email": "user@example.com",
        "client_id": "_first_party_identifier",
        "sid": "sid",
        "ifa": "idfa",
        "idfv": "idfv",
        "os": "macos",
        "esi": "web",
        "zip": "12345",
        "country_code": "US"
      },
      "data": {
        "currency": "USD",
        "value": 30
      }
    }
  ]
}