Adjust 提供用于删除用户数据的 API 终端。该终端会为给定设备完成下列操作：

* 从 Adjust 中永久删除指定应用中该用户的个人数据。
* 不再从指定应用的 Adjust SDK 接收该用户/设备的信息。
* 从 Adjust 控制面板中移除指定应用中该用户/设备数据的所有引用。

设置您的服务器，以便在用户发送数据删除请求时向此 API 终端发送请求。要进一步了解个人数据删除请求，请参考我们的[个人数据删除权文档](/zh/article/gdpr)。

<callout type="important">
此操作具有 <b>永久性</b>。删除请求发送后，Adjust 将无法恢复与此设备关联的数据，也无法在未来接收该设备的请求。
</callout>

[终端](endpoint-1)
----------------

```url
https://gdpr.adjust.com/gdpr_forget_device
```

### [POST 请求](post-request)

发送包含应用识别码和设备 ID 的 POST 请求，移除于设备关联的所有数据。

<callout type="note">
删除请求仅适用于您在调用中指定的应用。其他应用的设备数据不会受影响。
</callout>

#### [参数](parameters)

<table>
  <colgroup>
    <col width="148" />
    <col width="113" />
    <col width="61" />
    <col />
    <col width="77" />
  </colgroup>
  <thead>
    <tr>
      <th>参数</th>
      <th>数据类型</th>
      <th>In</th>
      <th>值描述</th>
      <th>是否必要</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>app_token</code></td>
      <td>字符串</td>
      <td>查询</td>
      <td>控制面板上的 Adjust 应用识别码。</td>
      <td>允许</td>
    </tr>
    <tr>
      <td><code>s2s</code></td>
      <td>布尔</td>
      <td>查询</td>
      <td>调用是否通过服务器到服务器方式发送 (S2S 调用)。值必须为 <code>1</code> (true)。</td>
      <td>允许</td>
    </tr>
    <tr>
      <td><code>null<device_token></code></td>
      <td>字符串</td>
      <td>查询</td>
      <td>需要 Adjust 遗忘的设备 ID。请查看下方表格，了解可用的值。</td>
      <td>允许</td>
    </tr>
  </tbody>
</table>

+++>

### [设备标识符](device-identifiers)

请务必在请求中包含设备标识符。可用的标识符如下：

<table>
  <colgroup>
    <col width="124" />
    <col width="150" />
    <col width="92" />
    <col />
    <col />
  </colgroup>
  <thead>
    <tr>
      <th>参数</th>
      <th>数据类型</th>
      <th>In</th>
      <th>示例值</th>
      <th>值描述</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>IDFA</code></td>
      <td>字符串</td>
      <td>查询</td>
      <td><code>8C6CBCOD-5F43-4765-A6E6-84DFF3D24707</code></td>
      <td>iOS 广告主 ID。</td>
    </tr>
    <tr>
      <td><code>idfv</code></td>
      <td>字符串</td>
      <td>查询</td>
      <td><code>CCB300A0-DE1B-4D48-BC7E-599E453B8DD4</code></td>
      <td>iOS 供应商 ID。</td>
    </tr>
    <tr>
      <td><code>gps_adid</code></td>
      <td>字符串</td>
      <td>查询</td>
      <td><code>38400000-8cf0-11bd-b23e-10b96e40000d</code></td>
      <td>Google Play 应用商店广告 ID。</td>
    </tr>
    <tr>
      <td><code>fire_adid</code></td>
      <td>字符串</td>
      <td>查询</td>
      <td><code>63c5519b-7e66-7ee6-aa5d-3b290743811f</code></td>
      <td>Fire OS 广告 ID。</td>
    </tr>
    <tr>
      <td><code>win_adid</code></td>
      <td>字符串</td>
      <td>查询</td>
      <td><code>107e8ea14329d4a2194ebbb6dc0c0fd7</code></td>
      <td>Windows 广告 ID。</td>
    </tr>
    <tr>
      <td><code>adid</code></td>
      <td>字符串</td>
      <td>查询</td>
      <td><code>18546f6171f67e29d1cb983322ad1329</code></td>
      <td>Adjust 设备 ID。</td>
    </tr>
  </tbody>
</table>

+++<

#### [示例](example)

++++>

### cURL

```bash
curl -X POST "https://gdpr.adjust.com/gdpr_forget_device?s2s=1&app_token=kwrqhymtnsr2&idfa=9C5CBC1D-4F42-4764-A5E6-84DAF3D24707"
```

++++<

### [响应](response)

<table>
  <thead>
    <tr>
      <th>状态代码</th>
      <th>含义</th>
      <th>描述</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>200</code></td>
      <td>OK</td>
      <td>已收到并处理请求。</td>
    </tr>
    <tr>
      <td><code>400</code></td>
      <td>Bad request</td>
      <td>格式或识别码无效。请仔细检查，确保在请求中包含了必要的参数。如需帮助，请联系您的账户经理或发送邮件至 <a href="mailto:support@adjust.com">support@adjust.com</a> 。</td>
    </tr>
    <tr>
      <td><code>429</code></td>
      <td>Too many requests</td>
      <td>该终端的限制为每分钟 10 次请求，一旦超过此限制，则停止响应避免滥用。请晚些再次尝试发送请求。</td>
    </tr>
    <tr>
      <td><code>451</code></td>
      <td>由于法规原因不可用</td>
      <td></td>
    </tr>
  </tbody>
</table>

GDPR API 参考

阅读 Adjust 设置向导、最佳做法及常见问题解答，让您的业务更上一层楼。



营销人员

在您的应用和业务分析中集成我们的 API 和开源 SDK。


开发者


全球技术合作伙伴如何与 Adjust 开展高效合作？本文提供了大量实用建议。



参数	数据类型	In	值描述	是否必要
`app_token`	字符串	查询	控制面板上的 Adjust 应用识别码。	允许
`s2s`	布尔	查询	调用是否通过服务器到服务器方式发送 (S2S 调用)。值必须为 `1` (true)。	允许
`null`	字符串	查询	需要 Adjust 遗忘的设备 ID。请查看下方表格，了解可用的值。	允许

参数	数据类型	In	示例值	值描述
`IDFA`	字符串	查询	`8C6CBCOD-5F43-4765-A6E6-84DFF3D24707`	iOS 广告主 ID。
`idfv`	字符串	查询	`CCB300A0-DE1B-4D48-BC7E-599E453B8DD4`	iOS 供应商 ID。
`gps_adid`	字符串	查询	`38400000-8cf0-11bd-b23e-10b96e40000d`	Google Play 应用商店广告 ID。
`fire_adid`	字符串	查询	`63c5519b-7e66-7ee6-aa5d-3b290743811f`	Fire OS 广告 ID。
`win_adid`	字符串	查询	`107e8ea14329d4a2194ebbb6dc0c0fd7`	Windows 广告 ID。
`adid`	字符串	查询	`18546f6171f67e29d1cb983322ad1329`	Adjust 设备 ID。

状态代码	含义	描述
`200`	OK	已收到并处理请求。
`400`	Bad request	格式或识别码无效。请仔细检查，确保在请求中包含了必要的参数。如需帮助，请联系您的账户经理或发送邮件至 support@adjust.com 。
`429`	Too many requests	该终端的限制为每分钟 10 次请求，一旦超过此限制，则停止响应避免滥用。请晚些再次尝试发送请求。
`451`	由于法规原因不可用