用于线索生成的 Conversion API

使用 Conversion API 为您的网站发送线索生成事件。AppLovin 建议广告主将 Conversion API 与 AppLovin Pixel 配合使用，以帮助实现最佳的广告活动效果。

请求格式

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

身份验证

查询参数

从 AppLovin dashboard 的 Keys 区域获取您的 AppLovin Event Key 和 Conversion API 密钥。

响应代码

POST 负载

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

服务器事件

事件数据

data 是每个事件的必填项。

• 对于 page_view，将 data 设置为 null。

• 对于 generate_lead，始终发送 { "currency": "«ISO-4217»", "value": «number» }。

可选事件

app_open 事件仅适用于移动应用集成。 当用户启动应用时触发此事件。 此事件无需传递数据对象。

用户数据

发送 aleid

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

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

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

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

发送用户标识符

client_id

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

axwrt

如果您的网站上安装了 AppLovin Pixel，AppLovin Pixel 会自动设置 Cookie _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
      }
    }
  ]
}