创建广告 API

POST https://api.offer18.com/api/m/offer_create

🔗 点击测试 Offer Create API

通用参数

查询	类型	描述
mid	整数	网络账户 ID
api-key	字符串	网络 API 密钥
secret-key	字符串	网络密钥

操作

查询	类型	描述
type	字符串	允许的值： create / update
oid	整数	在更新 Offer 时必需

---

字段

主体	类型	描述
offer_name	字符串	活动名称
advertiser_id	整数	广告主 ID
offer_url	URL	活动的 URL
external_offer_id	字符串	外部活动 ID（如果有）
app_id	字符串	应用 ID（如果有）
logo	URL	活动徽标的 URL
category	字符串	活动类别
preview_url	URL	活动的预览 URL
currency	字符串	Offer 的货币 🔗 查看货币
price_advertiser	小数	广告主为活动提供的价格
price_affiliate	小数	给予联盟的活动价格
model_advertiser	字符串	活动的广告主模型 🔗 查看模型
model_affiliate	字符串	活动的广告主模型 🔗 查看模型
hide_affiliate_payout	整数	允许的值 1: 隐藏联盟支付
start_datetime	UTC 时间戳	开始日期/时间 (YYYY-MM-DD HH:MM:SS)
end_datetime	UTC 时间戳	结束日期/时间 (YYYY-MM-DD HH:MM:SS )
visibility	字符串	允许的值： public, permission, private
status	字符串	允许的值： approve, pending
deep_links	整数	允许的值 1: 启用 Offer 中的深度链接
offer_terms	字符串	活动条款
offer_kpi	字符串	活动的 KPI 条款
private_note	字符串	活动的私人备注
imps_url	URL	展示 URL
landing_page_name_1	字符串	第一着陆页的名称
landing_page_url_1	URL	活动第一着陆页的 URL
landing_page_name_2	字符串	第二着陆页的名称
landing_page_url_2	URL	活动第二着陆页的 URL
creatives	URL	活动素材的 URL
fallback	布尔值	允许的值： 1: 启用回退
fallback_offer_id	整数	回退的 Offer ID
fallback_url	URL	回退的 URL
fraud_conv_speed	整数	以秒为单位的时间
proxy_block	整数	允许的值： 1: 阻止代理
blank_ref_block	整数	允许的值： 1: 阻止空引用
hide_referral	整数	允许的值： 1: 隐藏推荐
assign_affiliates	整数	将联盟分配到此活动 （逗号分隔的值）
capping_rule_id	字符串	如果用户想更新现有封顶规则
capping[0][capping_rule_name]	字符串	封顶规则名称
capping[0][capping_rule_type]	字符串	封顶规则类型 1. advertiser_capping 2. affiliate_capping
capping[0][capping_timezone]	时间戳	封顶时区
capping[0][capping_events]	字符串	封顶事件
capping[0][capping_type]	字符串	封顶类型 1. gross_conversions 2. approved_conversions 3. gross_revenue 4. approved_revenue 5. gross_payout 6. approved_payout 7. gross_clicks 8. approved_clicks
capping[0][capping_period]	字符串	封顶周期 1. daily 2. weekly 3. monthly 4. hourly
capping[0][capping_value]	整数	封顶值
capping[0][overcap_action]	字符串	超限操作 1. stop 2. fallback 3. fallback_conversion_accept 4. conversion_accept 5. conversion_reject 6. conversion_pending
capping[0][capping_notification_email]	字符串	封顶通知邮箱
capping[0][capping_affiliate_visibility]	整数	1: 向联盟显示封顶规则
capping[0][capping_affiliate_id]	字符串	联盟 ID（逗号分隔）
target_country	字符串	允许特定国家 🔗 查看国家
block_country	字符串	阻止特定国家 🔗 查看国家
target_os	字符串	允许特定操作系统 🔗 查看操作系统
block_os	字符串	阻止特定操作系统 🔗 查看操作系统
target_device	字符串	允许特定设备 🔗 查看设备
block_device	字符串	阻止特定设备 🔗 查看设备
target_browser	字符串	允许特定浏览器 🔗 查看浏览器
block_browser	字符串	阻止特定浏览器 🔗 查看浏览器
target_isp	字符串	允许特定 ISP
block_isp	字符串	阻止特定 ISP
events[0][event_name]	字符串	事件名称
events[0][event_token]	字符串	事件令牌
capping_conversion_period	字符串	已弃用
capping_budget	整数	已弃用
capping_conversion	整数	已弃用
capping_budget_period	字符串	已弃用

封顶规则（说明）

1. 如果您想设置多个封顶规则，可以通过将规则分配给不同的编号来实现 示例 1： capping[1][capping_rule_name] capping[1][capping_rule_type] 示例 2： capping[2][capping_rule_name] capping[2][capping_rule_type]

2. 如果您想更新现有封顶规则，您必须提交 capping_rule_id 在 API 请求中以及新的数据到 0（零）编号 示例： capping[0][capping_rule_name] capping[0][capping_rule_type]

事件（说明）

1. 如果您想创建多个事件，可以通过将事件分配给不同的编号来实现 示例 1： events[1][event_name] events[1][event_token] 示例 2： events[2][event_name] events[2][event_token]

---

示例 API 请求

创建 Offer

API 响应

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

更新 Offer

API 响应

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

---

为保证交互安全，请始终从服务器端调用 API。