# 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="https://2550316299-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FiCJzWDGHotI1R1Pxw9AN%2Fimage.png?alt=media&#x26;token=942bc9f5-01aa-436e-aaaf-34e57b2b70c5" alt=""><figcaption></figcaption></figure>

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

***

### **转到设置**

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

<figure><img src="https://2550316299-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2F6zacFRFZIOEOlpu7qjt0%2Fimage.png?alt=media&#x26;token=6f74195a-7006-4f9a-bbe6-e38339cb1cbc" 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="https://2550316299-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FJw3ZOrVfFq4JjNfoKSiq%2Fimage.png?alt=media&#x26;token=3cb98757-fedc-4549-acc6-6754eb6e4f33" 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="https://2550316299-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FOvwT1jeHkSfdXBd2YrbH%2Fimage.png?alt=media&#x26;token=27345a2a-c600-4d24-8149-3245b7bd9361" alt=""><figcaption></figcaption></figure>

***

### 测试 API

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