> For the complete documentation index, see [llms.txt](https://knowledgebase.offer18.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.offer18.com/zh/wang-luo/wang-luo-api/offer-chuang-jian-api.md).

# Offer 创建 API

```
POST https://api.offer18.com/api/m/offers
```

:link: [<mark style="color:blue;">**点击测试 Offer 创建 API**</mark>](https://offer18.readme.io/reference/offers-api)

### 通用参数

| **查询**     | **类型** | **说明**        |
| ---------- | ------ | ------------- |
| mid        | 整数     | 网络账户 ID       |
| api-key    | 字符串    | 网络 API Key    |
| secret-key | 字符串    | 网络 Secret Key |

**操作**

<table data-header-hidden><thead><tr><th width="207.16379474883627"></th><th width="194.99924751175493"></th><th></th></tr></thead><tbody><tr><td><strong>查询</strong></td><td><strong>类型</strong></td><td><strong>说明</strong></td></tr><tr><td>action</td><td>字符串</td><td><strong>允许的值：</strong><br>create / update / delete</td></tr><tr><td>offer_id</td><td>整数</td><td>在 Offer 更新和删除时必填</td></tr></tbody></table>

***

### **字段**&#x20;

<table data-header-hidden data-full-width="false"><thead><tr><th width="329.1820791993198"> </th><th width="124"> </th><th width="293.1921073532865"> </th></tr></thead><tbody><tr><td><strong>请求体</strong></td><td><strong>类型</strong></td><td><strong>说明</strong></td></tr><tr><td>offer_name</td><td>字符串</td><td>活动名称</td></tr><tr><td>advertiser_id</td><td>整数</td><td>广告主 ID </td></tr><tr><td>offer_url</td><td>URL</td><td>活动的 URL</td></tr><tr><td>external_offer_id</td><td>字符串</td><td>外部活动 ID（如有）</td></tr><tr><td>app_id</td><td>字符串</td><td>App ID（如有）</td></tr><tr><td>logo</td><td>URL</td><td>活动 Logo 的 URL</td></tr><tr><td>category</td><td>字符串</td><td>活动类别</td></tr><tr><td>preview_url</td><td>URL</td><td>活动预览 URL</td></tr><tr><td>currency</td><td>字符串</td><td><p>Offer 的货币</p><p><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#currency"><mark style="color:blue;">查看货币</mark></a></p></td></tr><tr><td>price_advertiser</td><td>小数</td><td>广告主为活动提供的价格</td></tr><tr><td>price_affiliate</td><td>小数</td><td>活动支付给联盟客的价格</td></tr><tr><td>model_advertiser</td><td>字符串</td><td>活动的广告主模型<br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#models"><mark style="color:blue;">查看模型</mark></a></td></tr><tr><td>model_affiliate</td><td>字符串</td><td>活动的广告主模型<br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#models"><mark style="color:blue;">查看模型</mark> </a></td></tr><tr><td>hide_affiliate_payout</td><td>整数</td><td>允许的值 <br><strong>1:</strong> 隐藏联盟客分成</td></tr><tr><td>start_datetime</td><td>UTC 时间戳</td><td>开始日期 / 时间<br>(YYYY-MM-DD HH:MM:SS) </td></tr><tr><td>end_datetime</td><td>UTC 时间戳</td><td>结束日期 / 时间<br>(YYYY-MM-DD HH:MM:SS )</td></tr><tr><td>visibility</td><td>字符串</td><td><strong>允许的值：</strong><br>public, permission, private</td></tr><tr><td>status</td><td>字符串</td><td><strong>允许的值：</strong> approve, pending</td></tr><tr><td>deep_links</td><td>整数</td><td>允许的值<br><strong>1:</strong> 在 Offers 中启用深度链接</td></tr><tr><td>offer_terms</td><td>字符串</td><td>活动条款</td></tr><tr><td>offer_kpi</td><td>字符串</td><td>活动的 KPI 条款</td></tr><tr><td>private_note</td><td>字符串</td><td>活动中的私密备注</td></tr><tr><td>imps_url</td><td>URL</td><td>展示 URL</td></tr><tr><td>landing_page_id_1</td><td>整数</td><td>用于用户想更新现有落地页的情况</td></tr><tr><td>landing_page_name_1</td><td>字符串</td><td>第一个落地页名称 </td></tr><tr><td>landing_page_url_1</td><td>URL</td><td>活动第一个落地页的 URL</td></tr><tr><td>landing_page_id_2</td><td>整数</td><td>用于用户想更新现有落地页的情况</td></tr><tr><td>landing_page_name_2</td><td>字符串</td><td>第二个落地页名称</td></tr><tr><td>landing_page_url_2</td><td>URL</td><td>活动第二个落地页的 URL</td></tr><tr><td>creatives</td><td>URL</td><td>活动素材的 URL</td></tr><tr><td>fallback</td><td>布尔值</td><td>允许的值：<br><strong>1:</strong> 启用 Fallback</td></tr><tr><td>fallback_offer_id</td><td>整数</td><td>Fallback 的 Offer ID</td></tr><tr><td>fallback_url</td><td>URL</td><td>Fallback 的 URL</td></tr><tr><td>fraud_conv_speed</td><td>整数</td><td>时间（秒）</td></tr><tr><td>proxy_block</td><td>整数</td><td>允许的值：<br><strong>1:</strong> 阻止代理</td></tr><tr><td>blank_ref_block</td><td>整数</td><td>允许的值：<br><strong>1:</strong> 阻止空白引用</td></tr><tr><td>hide_referral</td><td>整数</td><td>允许的值：<br><strong>1:</strong> 隐藏推荐来源</td></tr><tr><td>assign_affiliates</td><td>整数</td><td>将联盟客分配给此活动<br>（逗号分隔的值）</td></tr><tr><td>capping_rule_id</td><td>整数</td><td>用于用户想更新现有封顶规则的情况</td></tr><tr><td>capping[0][capping_rule_name]</td><td>字符串</td><td>封顶规则名称 </td></tr><tr><td>capping[0][capping_rule_type]</td><td>字符串</td><td>封顶规则类型 <br>1. <strong>advertiser_capping</strong><br>2. <strong>affiliate_capping</strong></td></tr><tr><td>capping[0][capping_timezone]</td><td>时间戳</td><td>封顶时区</td></tr><tr><td>capping[0][capping_events]</td><td>字符串</td><td>封顶事件</td></tr><tr><td>capping[0][capping_type]</td><td>字符串</td><td>封顶类型<br>1. <strong>gross_conversions</strong><br>2. <strong>approved_conversions</strong><br>3. <strong>gross_revenue</strong><br>4. <strong>approved_revenue</strong><br>5. <strong>gross_payout</strong><br>6. <strong>approved_payout</strong><br>7. <strong>gross_clicks</strong><br>8. <strong>approved_clicks</strong></td></tr><tr><td>capping[0][capping_period]</td><td>字符串</td><td>封顶周期<br>1. <strong>daily</strong><br>2. <strong>weekly</strong><br>3. <strong>monthly</strong><br>4. <strong>hourly</strong></td></tr><tr><td>capping[0][capping_value]</td><td>整数</td><td>封顶值</td></tr><tr><td>capping[0][overcap_action]</td><td>字符串</td><td>超额处理动作<br>1. <strong>stop</strong><br>2. <strong>fallback</strong><br>3. <strong>fallback_conversion_accept</strong><br>4. <strong>conversion_accept</strong><br>5. <strong>conversion_reject</strong><br>6. <strong>conversion_pending</strong></td></tr><tr><td>capping[0][capping_notification_email]</td><td>Stirng</td><td>封顶通知邮箱</td></tr><tr><td>capping[0][capping_affiliate_visibility]</td><td>整数</td><td><strong>1:</strong> 向联盟客展示封顶规则</td></tr><tr><td>capping[0][capping_affiliate_id]</td><td>Stirng</td><td>联盟客 ID（逗号分隔）</td></tr><tr><td>targeting_rule_id</td><td>整数</td><td>用于用户想更新现有定向规则的情况</td></tr><tr><td>target_country</td><td>字符串</td><td>允许指定国家 <br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#countries"><mark style="color:blue;">查看国家</mark></a></td></tr><tr><td>block_country</td><td>字符串</td><td>屏蔽指定国家 <br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#countries"><mark style="color:blue;">查看国家</mark></a></td></tr><tr><td>target_os</td><td>字符串</td><td>允许指定操作系统<br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#operating-systems"><mark style="color:blue;">查看操作系统</mark></a></td></tr><tr><td>block_os</td><td>字符串</td><td>屏蔽指定操作系统<br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#operating-systems"><mark style="color:blue;">查看操作系统</mark></a></td></tr><tr><td>target_device</td><td>字符串</td><td>允许指定设备<br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span><a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#devices"> <mark style="color:blue;">查看设备</mark></a></td></tr><tr><td>block_device</td><td>字符串</td><td>屏蔽指定设备<br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span><a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#devices"> <mark style="color:blue;">查看设备</mark></a></td></tr><tr><td>target_browser</td><td>字符串</td><td>允许指定浏览器<br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#browsers"><mark style="color:blue;">查看浏览器</mark></a></td></tr><tr><td>block_browser</td><td>字符串</td><td>屏蔽指定浏览器<br><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/d9d4155c600d0d3d7c6df1cd9f8ebac54fafa4a3#browsers"><mark style="color:blue;">查看浏览器</mark></a></td></tr><tr><td>target_isp</td><td>字符串</td><td>允许指定 ISP</td></tr><tr><td>block_isp</td><td>字符串</td><td>屏蔽指定 ISP</td></tr><tr><td>events[0][event_name]</td><td>字符串</td><td>事件名称 </td></tr><tr><td>events[0][event_token]</td><td>字符串</td><td>事件令牌</td></tr><tr><td>capping_conversion_period</td><td>字符串</td><td><mark style="color:orange;"><strong>已弃用</strong></mark></td></tr><tr><td>capping_budget</td><td>整数</td><td><mark style="color:orange;"><strong>已弃用</strong></mark></td></tr><tr><td>capping_conversion</td><td>整数</td><td><mark style="color:orange;"><strong>已弃用</strong></mark></td></tr><tr><td>capping_budget_period</td><td>字符串</td><td><mark style="color:orange;"><strong>已弃用</strong></mark></td></tr></tbody></table>

**封顶规则（说明）**&#x20;

{% hint style="info" %}

1. 如果你想设置多个封顶规则，可以通过将规则分配到不同的数字来实现\
   **示例 1：** \
   &#x20; capping\[**1**]\[capping\_rule\_name] \
   &#x20; capping\[**1**]\[capping\_rule\_type]\
   **示例 2：**\
   &#x20; capping\[**2**]\[capping\_rule\_name] \
   &#x20; capping\[**2**]\[capping\_rule\_type]
2. 如果你想更新现有封顶规则，必须提交 **capping\_rule\_id** 在 API 请求并携带新数据到 **0**（零）编号\
   **示例：**\
   &#x20; capping\[**0**]\[capping\_rule\_name] \
   &#x20; capping\[**0**]\[capping\_rule\_type]
   {% endhint %}

**事件（说明）**&#x20;

{% hint style="info" %}

1. 如果你想创建多个事件，可以通过将事件分配到不同的数字来实现\
   **示例 1：** \
   &#x20; events\[1]\[event\_name] \
   &#x20; events\[1]\[event\_token]\
   **示例 2：**\
   &#x20; events\[2]\[event\_name] \
   &#x20; events\[2]\[event\_token]
   {% endhint %}

***

### API 请求示例

**Offer 创建**

<figure><img src="/files/2033dfe5a881afc214603883c5c370c1b49344b0" alt=""><figcaption></figcaption></figure>

**API 响应**

```
{
    "status": "200",
    "response": "offer_created_successfully",
    "offer_id": 000012    
}
```

**Offer 更新**

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

**API 响应**

```
{
    "status": "200",
    "response": "offer_updated_successfully",
    "offer_id": "000001"
}
```

***

{% hint style="info" %}
**为了安全交互，请始终从服务器端调用 API。**
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/wang-luo-api/offer-chuang-jian-api.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.