Conversion API

Conversion APIを使用して、ウェブサイトのコンバージョンイベントを送信します。 AppLovinは、広告主様がAppLovin Pixelと併せてConversion APIを使用することを推奨しています。 これにより、最適なキャンペーンパフォーマンスを達成できます。

リクエスト形式

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

認証

クエリパラメータ

レスポンスコード

POSTペイロード

HTTPリクエストのPOSTペイロードは、送信する1つ以上のイベントを表します：

サーバーイベント

イベントデータ

イベントとオブジェクトを参照して、各イベントのdataフィールドに入力する方法を確認してください。 このリンクに記載されているイベントに加えて、サポートされている追加のイベントを以下に示します。

任意のイベント

app_open イベント（モバイルアプリ連携のみ）

ユーザーがアプリを起動したときにこのイベントをトリガーします。 このイベントに渡すデータオブジェクトはありません。

User data

計測データ

aleidの送信

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

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

aleidを送信するには、次のいずれかを行います。

• サイトにAppLovin Pixelがインストールされている場合、AppLovin Pixelはaleidクエリパラメータを検出すると、自動的にクッキー_axeidを設定します。 そのようなクッキーが確認された場合は常に、その値を読み取り、aleidクエリパラメータの値としてリクエストに含めて送信してください。
• 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ハッシュを提供することもできます。

ペイロードの例

[
  {
    "event_time": 1741784485001,
    "event_source_url": "https://applovin.com",
    "name": "purchase",
    "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",
      "email": "user@example.com",
      "phone": "+11234567890",
      "user_id": "customer_12345",
      "client_id": "_first_party_identifier",
      "sid": "sid",
      "ifa": "idfa",
      "idfv": "idfv",
      "os": "macos",
      "esi": "web",
      "zip": "12345",
      "country_code": "US"
    },
    "measurement_partner_data": {
      "is_claimable": true,
      "attribution_model": "LAST_CLICK",
      "attribution_lookback_window_hours": 24,
      "attribution_share": 0.5,
      "accounting_mode": "ACCRUAL",
      "campaign_id": "456",
      "creative_set_id": "789",
      "is_new_customer": false,
      "last_purchase_ts": null,
      "is_new_visitor": true,
      "last_visit_ts": 1
    },
    "data": {
      "user_id": "customer_12345",
      "currency": "USD",
      "value": 30,
      "transaction_id": "txn_abc123_20250120",
      "shipping": 5.99,
      "tax": 6,
      "items": [
        {
          "item_variant_id": "SKU-123-M",
          "item_id": "PROD-456",
          "item_name": "T-Shirt",
          "affiliation": "affiliation",
          "item_brand": "item_brand",
          "item_category": "item_category",
          "item_category_id": 604,
          "item_category2": "item_category2",
          "image_url": "image_url",
          "price": 15,
          "discount": 10,
          "quantity": 2
        }
      ]
    }
  }
]