Conversion API

使用 Conversion API 为您的网站发送转化事件。 AppLovin 建议广告主将 Conversion API 与 AppLovin Pixel 结合使用。 这有助于您获得最佳的广告活动效果。

请求格式

要向 Conversion API 提交一个或多个事件，请向 https://b.applovin.com/v1/event 发送 HTTP POST 请求。

身份验证

查询参数

响应代码

POST 负载

您的 HTTP 请求的 POST 负载描述了您提交的一个或多个事件：

服务器事件

事件数据

请参阅事件和对象以了解如何为每个事件填充 data 字段。 除了此链接中记录的事件外，您还可以在下方找到其他支持的事件。

可选事件

app_open 事件（仅限移动应用集成）

当用户启动应用时触发此事件。 此事件无需传递数据对象。

User data

测量数据

发送 aleid

aleid 是用户点击 AppLovin 广告后，AppLovin 添加到网站 URL 中的查询参数。

利用此参数的存在来识别哪些点击来自 AppLovin。

要发送 aleid，您可以执行以下操作之一：

• 如果您的网站上安装了 AppLovin Pixel，当 AppLovin Pixel 看到 aleid 查询参数时，会自动设置 Cookie _axeid。 每当您看到此类 Cookie 时，请读取其值，然后通过将其作为 aleid 查询参数的值在请求中发送。
• 当您看到 aleid URL 查询参数存在时，请获取其值。 当您的服务器看到 aleid 查询参数时，请在服务器端读取该参数。 AppLovin 建议您在网站上将其设置为名为 _axeid 的 HTTP Cookie。 将此 Cookie 的过期时间设置为一年。 与前一种方法一样，每当您看到此类 Cookie 时，请读取其值，然后通过将其作为 aleid 查询参数的值在请求中发送。

发送用户标识符

client_id

如果您的网站上没有安装 AppLovin Pixel，请传递您存储的用于识别访问者的另一个稳定的第一方 Cookie。 它应该在全局范围内唯一，并在用户的不同浏览会话中保持一致。

axwrt

如果您的网站上安装了 AppLovin Pixel，AppLovin Pixel 会自动设置 Cookie _axwrt。

alart

对于应用（App）用户，当您看到 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
        }
      ]
    }
  }
]