---
title: Adapty Web API
description: ""
---

Web API 是服务端 API 的扩展，专为 Web 应用设计。它允许你通过关联的版位 ID 获取正确的付费墙，并记录付费墙的展示以实现准确的转化追踪。这有助于你使用 Adapty 内置的 A/B 测试和付费墙个性化功能，以及追踪哪些付费墙的效果最佳。

## 使用场景：记录来自 Web 应用的交易并将其关联到所使用的付费墙 \{#use-case-record-a-transaction-from-your-web-app-and-link-it-to-the-used-paywall\}

假设你在 Web 应用中销售产品。你需要向用户展示付费墙，让他们购买产品，然后将交易详情添加到 Adapty。将这些交易与用户完成购买时所使用的特定付费墙关联起来至关重要，这样你的分析数据才能反映准确的信息。使用 Adapty API 可以轻松实现这一点。

### 前提条件 \{#prerequisites\}

1. 在 Adapty 看板中[创建产品](create-product)，这些产品将用于付费墙。
2. 在 Adapty 看板中[创建付费墙](create-paywall)。[使用远程配置](customize-paywall-with-remote-config)来设计你的 Web 付费墙。
3. 在 Adapty 看板中[设置版位](create-placement)，并将付费墙关联到该版位。

### 使用 Adapty API 的步骤 \{#steps-with-adapty-api\}

1. **创建用户画像：** Adapty 在请求付费墙之前需要有一个用户画像，以便根据请求该付费墙的用户对结果进行个性化处理。使用[创建用户画像](api-adapty/operations/createProfile)请求来创建用户画像。
2. **获取并展示付费墙：** 当用户到达 Web 应用中需要展示付费墙的版位时，使用[获取付费墙](api-web/operations/getPaywall)请求通过[版位 ID](placements) 获取付费墙。返回结果将是与你的用户对应的[目标受众](audience)的付费墙。使用返回的产品以及（可选）该付费墙的[远程配置](customize-paywall-with-remote-config)，通过你的代码展示付费墙。
3. **记录付费墙展示：** 使用[记录付费墙展示](api-web/operations/recordPaywallView)将付费墙展示事件记录到 Adapty，以确保你的分析数据准确反映该事件。这对于正确追踪转化至关重要。
4. **记录购买：** 如果用户完成购买，使用 Adapty API 将交易详情发送给 Adapty。在此请求中包含 **variation ID**，以便将交易与所展示的特定付费墙关联起来。有关指导，请参阅我们关于[在移动应用中将付费墙与交易关联](report-transactions-observer-mode)的页面——同样的方法适用于 Web 应用。
5. **添加营销归因数据（如适用）：** 如果你有任何营销归因数据（例如推广活动或广告详情），使用[添加归因](api-web/operations/addAttribution)将其合并到用户画像中，以丰富分析数据并在 Adapty 中深入了解你的广告效果。

---

**后续步骤：**

- 继续进行 [Web API 授权](web-api-authorization)
- 请求接口：
  - [添加归因](api-web/operations/addAttribution)
  - [获取付费墙](api-web/operations/getPaywall)
  - [记录付费墙展示](api-web/operations/recordPaywallView)