# Offer 同步指南

使用此 API 功能的一般目的是快速从广告主平台导入/同步优惠。

#### **1.** 集成 **»** **优惠同步**

![](https://2731110321-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME6HkHUCzlM0Mu33Q9W%2F-MMnbCRAAJrecIJk_pQ7%2F-MMnezTruHuq_1A8-sjb%2F5f2957652ff7bc16ab40b0114ad2bc96.gif?alt=media\&token=e63749c4-dd17-4a66-a535-2da016dc5d7f)

**2. 选择网络/合作平台 »** **设置** 

***

### **转到凭证**

**凭证 -** 这些将是广告主提供的 API 详细信息，包括 API 域名、密钥作为主要凭证。通常，这些会根据平台而变化

<figure><img src="/files/5c0f264bc34dbd744a33bd16678083f611cafe8a" alt=""><figcaption></figcaption></figure>

1. 指定 API 名称
2. 输入 API 凭证
3. 转到下一步&#x20;

***

### **转到设置**

选项行包含用户希望在导入的优惠中进行的各种配置设置

<figure><img src="/files/f6201049f90e1ee457e3ed974730a5ab6f613936" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>字段</strong></td><td><strong>描述</strong></td></tr><tr><td>计划</td><td>这是定义 API 应该自动更新的时间计划</td></tr><tr><td>联盟支付 %</td><td>此项用于指定用户希望与您的联盟分享的支付百分比</td></tr><tr><td>停止优惠</td><td>用户可以配置在下一次 API 调度同步中未能同步的优惠应应用哪些设置</td></tr><tr><td>广告主</td><td>这将是为该广告主创建的配置文件，所有同步的优惠都将保存在该配置文件下</td></tr><tr><td>优惠可见性</td><td>用户可以为联盟选择同步优惠的默认可见性状态。<br>（公开、公开 + 需要审批、私密）</td></tr><tr><td>回退</td><td>全局回退和自定义回退可应用于同步的优惠 </td></tr><tr><td>优惠类别</td><td>可以为同步的优惠选择类别 </td></tr><tr><td>优惠描述</td><td>此处添加的描述将被预先添加到同步优惠的描述中</td></tr><tr><td>优惠 KPI</td><td>此处添加的优惠 KPI 将被预先添加到同步优惠的描述中</td></tr><tr><td>移除跟踪 URL 令牌</td><td>使用此选项可以移除优惠 URL 中不必要的令牌</td></tr><tr><td>追加跟踪 URL 令牌</td><td>使用此选项可以在优惠 URL 中追加必要的令牌</td></tr><tr><td>分配联盟</td><td>可以将联盟分配给同步的优惠</td></tr><tr><td>超额封顶操作</td><td>超额封顶操作可以添加到同步的优惠中</td></tr></tbody></table>

***

### **转到筛选器**

使用筛选选项，可以筛选同步结果以从广告主获取特定/期望的数据&#x20;

<figure><img src="/files/9d51d40b06e097da1eae9b2d64245d8cd6d17538" alt=""><figcaption></figcaption></figure>

优惠同步中的筛选器有

<table data-header-hidden><thead><tr><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>筛选</strong> </td><td><strong>描述</strong></td></tr><tr><td>优惠同步限制</td><td>可以限制从 API 同步的优惠数量 </td></tr><tr><td>模型 </td><td>可以使用此项筛选具有特定模型的优惠 </td></tr><tr><td>价格范围</td><td>可以为从 API 同步的优惠设置价格的下限和上限 </td></tr><tr><td>offer_status</td><td>可以使用此项筛选具有特定状态的优惠<br>已批准/已过期</td></tr><tr><td>操作系统 </td><td>可以使用此项筛选针对特定操作系统的优惠 </td></tr><tr><td>国家 </td><td>可以使用此项筛选针对特定国家的优惠 </td></tr><tr><td>货币</td><td>可以使用此项筛选针对特定货币的优惠 </td></tr><tr><td>事件 / 目标</td><td>可以使用此项筛选包含特定事件的优惠</td></tr><tr><td>广告主优惠</td><td>可以指定必须同步或不得同步其优惠的广告主 ID</td></tr></tbody></table>

**字段**

这些是用户可以配置为始终、一次或从不同步的字段。

<figure><img src="/files/5ebc8c6728302adb731d03a6ec611219446bf0f9" alt=""><figcaption></figcaption></figure>

***

### 测试 API

使用此选项可以检查 API 的原始响应。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.offer18.com/zh/wang-luo/ji-cheng/offer-tong-bu/offer-tong-bu-zhi-nan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.