创建营销链路转化

1. 概述

1.1. 背景

在广告系统升级版（3.0 系统）中进行广告创建时，将新增对广告转化「营销链路」的表达。
因此广告主在投放前，需在「转化归因」模块完成营销链路的转化规则创建工作，并按要求完成数据的回传及联调。

1.2. 概念

名词说明
营销链路营销链路是指用户在营销活动中，从广告点击到完成转化所经过的完整路径，由承接转化的营销载体和多个行为节点序列组成。广告主通过在广告创编中选择营销链路，精准表达营销标的和转化路径。
转化分类转化分类对应广告投放的「营销载体」概念，是营销链路的优化目标（或生意目标）发生的场所。例如某次投放的优化目标是促进用户在某小程序上完成交易，那么在为该广告准备营销链路资产时，需要选择该小程序作为转化分类。
优化目标在同一条营销链路中，选择不同的优化目标时，会有不同的数据回传要求，需满足要求后才可在投放时选择对应优化目标
上报节点在营销链路的节点序列中，广告主需回传对应数据的节点，即上报节点。上报节点包括所选优化节点要求的必传节点和推荐回传节点，所选的上报节点均需在联调工具中完成数据联调。




2. 指引

2.1. 步骤 1：选择营销链路

2.1.1. 概述

腾讯广告按照各行业的业务实际情况，已预置了一批营销链路模板，不同模板的区别在于：用户经过的节点序列（即行为的类型和载体）不同。因此在创建营销链路资产前，需先通过 conversion_links/get 接口，获取可用的营销链路模板，并根据实际需求选择对应的节点序列。
在选择营销链路模板时，可根据下述信息，进行链路的区分和选择：

  • 转化分类：按照回传数据的客户端类型（如 iOS APP、微信小程序），查询适用的营销链路

  • 优化目标：按照广告投放的优化目标组合，查询适用的营销链路（可以通过查询优化目标权限接口查询是否有对应优化目标权限）

转化分类

枚举值含义
ANDROID安卓应用
IOSiOS 应用
QUICK_APP快应用
WEB网页
WECOM企业微信
WECHAT_CHANNELS微信视频号
WECHAT_MINI_PROGRAM微信小程序
WECHAT_OFFICIAL_ACCOUNT微信公众号
WECHAT_MINI_GAME微信小游戏
QQ_MINI_GAMEQQ 小游戏


优化目标类型

字段含义
optimization_goal优化目标
deep_optimization_goal深度优化目标
forward_link_assist助攻行为目标
deep_advanced_optimazation_goal深度辅助目标
deep_conversion_optimization_goal深度优化 ROI 目标
deep_advanced_roi深度辅助 ROI 目标


2.1.2. 调用方式

接口文档

https://developers.e.qq.com/v3.0/docs/api/conversion_links/get

请求参数

名称二级参数类型描述
account_id*integer推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id
second_category_type*enum营销链路二级分类，枚举详情
可选值：{ ANDROID, IOS, QUICK_APP, WEB, WECHAT_OFFICIAL_ACCOUNT, WECHAT_CHANNELS, WECHAT_MINI_PROGRAM, WECOM, WECHAT_MINI_GAME, QQ_MINI_GAME }
optimization_goal_structstruct
optimization_goalenum优化目标，枚举列表：[枚举详情]
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
deep_optimization_goalenum深度优化目标，枚举列表：[枚举详情]
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
forward_link_assistenum助攻行为目标，枚举列表：[枚举详情]
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
deep_advanced_optimazation_goalenum深度辅助目标，枚举列表：[枚举详情]
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
deep_conversion_optimization_goalenum深度优化 ROI 目标，枚举列表：[枚举详情]
可选值：{ GOAL_7DAY_PURCHASE_ROAS, GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS, GOAL_7DAY_MONETIZATION_ROAS, GOAL_7DAY_RETENTION_TIMES, GOAL_7DAY_LONGTERM_PURCHASE_ROAS, GOAL_14DAY_LONGTERM_PURCHASE_ROAS, GOAL_30DAY_LONGTERM_PURCHASE_ROAS, GOAL_QYT_7DAY_LIVE_STREAM_DEAL_ROAS, GOAL_WITHDRAW_DEPOSITS_ROAS }
deep_advanced_roiinteger深度辅助 ROI 目标，枚举列表：[枚举详情]
可选值：{ GOAL_7DAY_PURCHASE_ROAS, GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS, GOAL_7DAY_MONETIZATION_ROAS, GOAL_7DAY_RETENTION_TIMES, GOAL_7DAY_LONGTERM_PURCHASE_ROAS, GOAL_14DAY_LONGTERM_PURCHASE_ROAS, GOAL_30DAY_LONGTERM_PURCHASE_ROAS, GOAL_QYT_7DAY_LIVE_STREAM_DEAL_ROAS, GOAL_WITHDRAW_DEPOSITS_ROAS }

参考如下请求示例：

curl -v -G 'https://api.e.qq.com/v3.0/conversion_links/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \ 
-d 'account_id=<ACCOUNT_ID>' \ 
-d 'second_category_type=ANDROID' \ 
-d 'optimization_goal_struct={"optimization_goal": "OPTIMIZATIONGOAL_APP_ACTIVATE"}'


返回参数

名称类型描述
liststruct[]返回信息列表
conversion_link_idinteger链路模板 id
marketing_goalenum[]适用营销目的，枚举详情
marketing_target_typestring推广内容资产类型
marketing_carrier_typeenum营销载体类型，枚举详情
gold_link_typeenum黄金链路类型，枚举详情
landing_page_accessstruct落地页准入控制
support_page_typesenum[]支持的落地页类型列表，枚举详情
must_not_page_typesenum[]不允许使用的落地页类型列表，枚举详情
must_page_typesenum[]强制使用的落地页类型列表，枚举详情
conversion_link_nodesstruct[]链路模板节点列表
conversion_link_node_idinteger节点 id
conversion_link_node_namestring节点名称
conversion_link_node_indexinteger节点序号
conversion_link_action_typeenum节点行为类型，枚举详情
carrier_idinteger节点载体类型 id
carrier_namestring节点载体类型名称
data_sourceenum节点数据来源，枚举详情
og_idinteger[]优化目标 id 列表
og_liststruct[]og 信息列表
og_idintegerog id
og_namestringog 名称
roi_og_idinteger[]ROI 优化目标 id 列表
roi_og_liststruct[]roi og 信息列表
roi_og_idintegerroi og id
roi_og_namestringroi og 名称
conversion_infostruct[]回传数据要求列表
conversion_link_node_indexinteger节点序号
data_sourceenum节点数据来源，枚举详情
node_seqs_typeenum节点数据回传要求，枚举详情
conversion_link_application_typeenum节点链路化应用类型，枚举详情

调用接口后的返回示例如下：

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "conversion_link_id": "<CONVERSION_LINK_ID>",
                "conversion_link_nodes": [
                    {
                        "conversion_link_node_id": "<CONVERSION_LINK_NODE_ID>",
                        "conversion_link_node_name": "广告点击",
                        "conversion_link_node_index": 0,
                        "conversion_link_action_type": null,
                        "carrier_id": "<CARRIER_ID>",
                        "carrier_name": "广告",
                        "og_id": null,
                        "roi_og_id": null,
                        "og_list": null,
                        "roi_og_list": null,
                        "conversion_info": [
                            {
                                "conversion_link_node_index": 0,
                                "data_source": "DATA_SOURCE_PLATFORM",
                                "node_seqs_type": "NODE_SEQS_TYPE_REQUIRE",
                                "conversion_link_application_type": "OG_MODELING"
                            }
                        ],
                        "data_source": "DATA_SOURCE_PLATFORM"
                    },
                    {
                        "conversion_link_node_id": "<CONVERSION_LINK_NODE_ID>",
                        "conversion_link_node_name": "启动",
                        "conversion_link_node_index": 1,
                        "conversion_link_action_type": null,
                        "carrier_id": "<CARRIER_ID>",
                        "carrier_name": "外部微信小程序",
                        "og_id": null,
                        "roi_og_id": null,
                        "og_list": null,
                        "roi_og_list": null,
                        "conversion_info": null,
                        "data_source": "DATA_SOURCE_ADVERTISER"
                    },
                    {
                        "conversion_link_node_id": "<CONVERSION_LINK_NODE_ID>",
                        "conversion_link_node_name": "浏览页面",
                        "conversion_link_node_index": 2,
                        "conversion_link_action_type": null,
                        "carrier_id": "<CARRIER_ID>",
                        "carrier_name": "外部微信小程序",
                        "og_id": null,
                        "roi_og_id": null,
                        "og_list": null,
                        "roi_og_list": null,
                        "conversion_info": null,
                        "data_source": "DATA_SOURCE_ADVERTISER"
                    },
                    {
                        "conversion_link_node_id": "<CONVERSION_LINK_NODE_ID>",
                        "conversion_link_node_name": "提交表单",
                        "conversion_link_node_index": 3,
                        "conversion_link_action_type": null,
                        "carrier_id": "<CARRIER_ID>",
                        "carrier_name": "外部微信小程序",
                        "og_id": [
                            "<OG_ID>"
                        ],
                        "roi_og_id": null,
                        "og_list": [
                            {
                                "og_id": "<OG_ID>",
                                "og_name": "表单预约"
                            }
                        ],
                        "roi_og_list": null,
                        "conversion_info": [
                            {
                                "conversion_link_node_index": 3,
                                "data_source": "DATA_SOURCE_ADVERTISER",
                                "node_seqs_type": "NODE_SEQS_TYPE_REQUIRE",
                                "conversion_link_application_type": "OG_MODELING"
                            }
                        ],
                        "data_source": "DATA_SOURCE_ADVERTISER"
                    },
                    {
                        "conversion_link_node_id": "<CONVERSION_LINK_NODE_ID>",
                        "conversion_link_node_name": "接通电话",
                        "conversion_link_node_index": 4,
                        "conversion_link_action_type": "PHONE_CONNECTED",
                        "carrier_id": "<CARRIER_ID>",
                        "carrier_name": "电话",
                        "og_id": [
                            "<OG_ID>"
                        ],
                        "roi_og_id": null,
                        "og_list": [
                            {
                                "og_id": "<OG_ID>",
                                "og_name": "通话三十秒"
                            }
                        ],
                        "roi_og_list": null,
                        "conversion_info": [
                            {
                                "conversion_link_node_index": 3,
                                "data_source": "DATA_SOURCE_ADVERTISER",
                                "node_seqs_type": "NODE_SEQS_TYPE_REQUIRE",
                                "conversion_link_application_type": "PREFACE_MODELING"
                            },
                            {
                                "conversion_link_node_index": 4,
                                "data_source": "DATA_SOURCE_ADVERTISER",
                                "node_seqs_type": "NODE_SEQS_TYPE_REQUIRE",
                                "conversion_link_application_type": "OG_MODELING"
                            }
                        ],
                        "data_source": "DATA_SOURCE_ADVERTISER"
                    },
                    {
                        "conversion_link_node_id": "<CONVERSION_LINK_NODE_ID>",
                        "conversion_link_node_name": "确认意向",
                        "conversion_link_node_index": 5,
                        "conversion_link_action_type": "CONFIRM_EFFECTIVE_LEADS",
                        "carrier_id": "<CARRIER_ID>",
                        "carrier_name": "电话",
                        "og_id": [
                            "<OG_ID>"
                        ],
                        "roi_og_id": null,
                        "og_list": [
                            {
                                "og_id": "<OG_ID>",
                                "og_name": "有效综合线索"
                            }
                        ],
                        "roi_og_list": null,
                        "conversion_info": [
                            {
                                "conversion_link_node_index": 3,
                                "data_source": "DATA_SOURCE_ADVERTISER",
                                "node_seqs_type": "NODE_SEQS_TYPE_REQUIRE",
                                "conversion_link_application_type": "PREFACE_MODELING"
                            },
                            {
                                "conversion_link_node_index": 5,
                                "data_source": "DATA_SOURCE_ADVERTISER",
                                "node_seqs_type": "NODE_SEQS_TYPE_REQUIRE",
                                "conversion_link_application_type": "OG_MODELING"
                            }
                        ],
                        "data_source": "DATA_SOURCE_ADVERTISER"
                    }
                ],
                "marketing_target_type": ["MARKETING_TARGET_TYPE_TRAFFIC"],
                "gold_link_type": "GOLD_LINK_TYPE_UNKNOWN",
                "marketing_carrier_type": "MARKETING_CARRIER_TYPE_JUMP_PAGE",
                "landing_page_access": {
                    "support_page_types": null,
                    "must_page_types": null,
                    "must_not_page_types": [
                        "微信小程序落地页"
                    ]
                },
                "marketing_goal": ["MARKETING_GOAL_BRAND_PROMOTION"]
            }
        ]
    }
}


2.2. 步骤 2：创建转化归因

2.2.1. 概述

创建转化归因时，需基于选择的营销链路，重点配置如下信息：

  • 转化分类和对应 id：根据所选的转化分类，填写具体的 id（如安卓应用 id、IOS 应用 id、小游戏 id 等）

  • 优化目标：填写广告投放的优化目标信息（选择不同优化目标，会有不同的数据上报节点）

  • 上报节点：根据所选优化目标的要求，选择需上报数据的营销链路节点（每个上报节点有对应的数据来源、回传要求和优化方式）

  • 归因方式：选择优化目标对应的归因方式（如点击归因、曝光归因、激活归因等）

  • 监测链接组：从 DataNexus 中配置的监测链接组中，选择后续广告点击/曝光数据下发使用的监测链接组

数据来源

数据来源字段
平台上报DATA_SOURCE_PLATFORM
广告主上报DATA_SOURCE_ADVERTISER


回传要求

回传要求字段
必须上报NODE_SEQS_TYPE_REQUIRE
推荐上报NODE_SEQS_TYPE_RECOMMEND


2.2.2. 调用方式

可使用链路模板 id，通过 conversions/add 接口，创建营销链路对应的转化规则。

接口文档

https://developers.e.qq.com/v3.0/docs/api/conversions/add

请求参数

名称类型描述
account_id*integer推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id
conversion_name*string转化名称，字段长度最小 1 个等宽字符，长度最大 60 等宽字符（即字段最大长度为 60 个中文字或全角标点，120 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
字段长度最小 1 字节，长度最大 120 字节
access_type*enum上报方式，SDK 上报方式仅支持安卓和 ios 转化场景，JS 上报方式仅支持网页转化场景。详见 枚举详情
可选值：{ ACCESS_TYPE_SDK, ACCESS_TYPE_API, ACCESS_TYPE_JS }
conversion_scene*enum转化场景，网页及微信小程序转化场景无需输入推广目标 id。详见 枚举详情
可选值：{ CONVERSION_SCENE_ANDROID, CONVERSION_SCENE_IOS, CONVERSION_SCENE_WEB, CONVERSION_SCENE_WECHAT_MINI_PROGRAM, CONVERSION_SCENE_WECHAT_MINI_GAME, CONVERSION_SCENE_QQ_MINI_GAME, CONVERSION_SCENE_QUICK_APP, CONVERSION_SCENE_WE_COM }
marketing_carrier_idstring营销载体 id，如安卓应用 id、IOS 应用 id、小游戏 id 等
字段长度最小 0 字节，长度最大 2048 字节
app_android_channel_package_idstring安卓应用渠道包 id，在投放推广目标类型为 Android 应用且接入方式为 SDK 的情况下，可以填写 Market API 中android_union_channel_packages/add接口创建的腾讯广告渠道包的渠道包 id。只可以选择自定义渠道包 id 非空的渠道包，且只会将自定义渠道包 id 一致的数据计入转化量。渠道包 id 可以从推广目标模块的读取接口获取，渠道包 id 字段由"xx;yy" 两部分组成，在写入时 xx 会被置为 0，0 为正常。
字段长度最小 1 字节，长度最大 128 字节
claim_type*enum归因方式，SDK 上报方式时归因方式只能为 CLAIM_TYPE_ACTIVATION，JS 上报方式时只能是 CLAIM_TYPE_CLICK,微信小游戏推广仅支持 CLAIM_TYPE_REGISTER，QQ 小游戏推广、企业微信推广仅支持是 CLAIM_TYPE_CLICK，APP 类型、WEB 类型、微信小程序并且配置白名单的账户支持 CLAIM_TYPE_IMPRESSION。详见 枚举详情
可选值：{ CLAIM_TYPE_ACTIVATION, CLAIM_TYPE_CLICK, CLAIM_TYPE_REGISTER, CLAIM_TYPE_IMPRESSION }
feedback_urlstring监控链接，点击监测链接用于接收平台的点击信息，需输入合法 url，可参考文档：广告点击。当自归因为 true 并且 conversion_scene 为 ANDROID 或者 iOS，Feedback_URL 必填
字段长度最大 2048 字节
landing_page_urlstring请填写推广的落地页链接，与上报协议中的 url 保持一致，腾讯广告将根据此链接生成落地页唯一 id，相同域名相同优化目标不同落地页地址可以不用再次创建转化 id。feedback_url 与 landing_page_url 必须至少填写其中一个参数。在自归因 Web 转化场景中，建议填写 feedback_url 并使用 callback 上报行为数据。在非自归因 Web 转化场景中，可以不填写 feedback_url 填写 landing_page_url 并使用 click_id 上报行为数据。
字段长度最大 2048 字节
默认值：No default value!
mini_program_idstring小程序 appid，微信小程序转化场景、企业微信场景必填。企业微信场景输入和企业微信绑定的微信小程序 appid
字段长度最小 1 字节，长度最大 384 字节
默认值：No default value!
self_attributed*boolean是否自归因，当选择 true 代表自归因，自行匹配转化数据后上报给平台，当选择 false 代表全量上报，将产生的所有转化数据上报给平台进行归因。上报方式为 API 时必须为 TRUE，上报方式为 SDK/JS 时必须为 FALSE
可选值：{ true, false }
optimization_goal*enum优化目标类型，支持的优化目标及对应的深度优化目标可通过“查询优化目标权限”接口进行查询。详见 枚举详情
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
deep_behavior_optimization_goalenum深度优化行为目标，深度优化行为目标和深度优化 ROI 目标仅可填写其中一个。枚举列表：枚举详情
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
deep_worth_optimization_goalenum深度优化 ROI 目标，深度优化行为目标、深度优化 ROI 和深度强化 ROI 目标仅可填写其中一个。枚举列表：枚举详情
可选值：{ GOAL_NONE, GOAL_7DAY_PURCHASE_ROAS, GOAL_15DAY_PURCHASE_ROAS, GOAL_30DAY_PURCHASE_ROAS, GOAL_60DAY_PURCHASE_ROAS, GOAL_30DAY_MONETIZATION_ROAS, GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS, GOAL_3DAY_PURCHASE_ROAS, GOAL_3DAY_MONETIZATION_ROAS, GOAL_7DAY_MONETIZATION_ROAS, GOAL_15DAY_MONETIZATION_ROAS, GOAL_7DAY_RETENTION_TIMES, GOAL_7DAY_LONGTERM_PURCHASE_ROAS, GOAL_14DAY_LONGTERM_PURCHASE_ROAS, GOAL_30DAY_LONGTERM_PURCHASE_ROAS, GOAL_QYT_7DAY_LIVE_STREAM_DEAL_ROAS, GOAL_WITHDRAW_DEPOSITS_ROAS }
deep_worth_advanced_goalenum强化 ROI 目标，深度优化行为目标、深度优化 ROI 和深度强化 ROI 目标仅可填写其中一个。枚举列表：枚举详情
可选值：{ GOAL_NONE, GOAL_7DAY_PURCHASE_ROAS, GOAL_15DAY_PURCHASE_ROAS, GOAL_30DAY_PURCHASE_ROAS, GOAL_60DAY_PURCHASE_ROAS, GOAL_30DAY_MONETIZATION_ROAS, GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS, GOAL_3DAY_PURCHASE_ROAS, GOAL_3DAY_MONETIZATION_ROAS, GOAL_7DAY_MONETIZATION_ROAS, GOAL_15DAY_MONETIZATION_ROAS, GOAL_7DAY_RETENTION_TIMES, GOAL_7DAY_LONGTERM_PURCHASE_ROAS, GOAL_14DAY_LONGTERM_PURCHASE_ROAS, GOAL_30DAY_LONGTERM_PURCHASE_ROAS, GOAL_QYT_7DAY_LIVE_STREAM_DEAL_ROAS, GOAL_WITHDRAW_DEPOSITS_ROAS }
user_action_set_idinteger数据源 id，当是否自归因选择 true 时，数据源 id 不可填，当是否自归因选择 false 时，如果该 APP 在当前账户下可见多个数据源，则需要手动指定一个，其他情况可不填
impression_feedback_urlstring监控链接，曝光监测链接用于接收平台的曝光信息，需输入合法 url，可参考文档：枚举详情。白名单账户可选填
字段长度最大 2048 字节
attribution_windowinteger曝光归因窗口期，默认窗口期为 7 天
默认值：7
deep_behavior_advanced_goalenum加强优化行为目标，加强优化行为目标和加强优化 ROI 目标仅可填写其中一个。枚举列表：枚举详情
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
默认值：7
deep_optimization_goal_typeenum深度优化目标类型，如 SELF_OG,AUTO_OG 等。详见枚举详情
可选值：{ SELF_OG, AUTO_OG }
forward_link_assistenum助攻行为类型，支持的助攻行为类型可通过“查询优化目标权限”接口进行查询。详见 枚举详情
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
incubation_optimization_goalenum助启行为优化目标类型，支持的助启行为优化目标类型可通过“查询优化目标权限”接口进行查询。详见 枚举详情
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
conversion_template_idinteger链路模板 id，与 2.1.2 返回体中 conversion_link_id 同值
custom_report_indexList<Integer>选择上报的节点下标，需包含必须上报的节点

参考如下请求示例：

curl 'https://api.e.qq.com/v3.0/conversions/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \ 
-H 'Content-Type: application/json' \ 
-d '{
    "account_id": "<ACCOUNT_ID>",
    "conversion_name": "测试转化",
    "access_type": "ACCESS_TYPE_API",
    "conversion_scene": "CONVERSION_SCENE_ANDROID",
    "marketing_carrier_id": "12345678",
    "app_android_channel_package_id": "0;10000534",
    "claim_type": "CLAIM_TYPE_ACTIVATION",
    "feedback_id": 12345,
    "conversion_template_id": 123,
    "custom_report_index":[1,3,4],
    "feedback_url": "http://wwww.qq.com?a=__CLICK_ID__&b=__CLICK_TIME__&c=__MUID__&d=__ACCOUNT_ID__&f=__CALLBACK__&g=__DEVICE_OS_TYPE__&h=__HASH_MAC__&i=__HASH_OAID__&j=__OAID__&k=__HASH_ANDROID_ID__&l=__PROMOTED_OBJECT_ID__&o=__AD_ID__",
    "self_attributed": true,
    "optimization_goal": "OPTIMIZATIONGOAL_APP_ACTIVATE",
    "deep_behavior_optimization_goal": "OPTIMIZATIONGOAL_APP_REGISTER"
}'


返回参数

名称类型描述
conversion_idinteger转化 id

调用接口后的返回示例如下：

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "conversion_id": 12345
    }
}


2.3. 步骤 3：获取转化归因

2.3.1. 概述

完成转化规则创建后，可通过 conversions/get 接口，获取营销链路对应的转化规则。

2.3.2. 调用方式

接口文档

https://developers.e.qq.com/v3.0/docs/api/conversions/get

请求参数

名称类型描述
account_id*integer推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id
filteringstruct[]过滤条件，若此字段不传，或传空则视为无限制条件，详见 枚举详情
数组最小长度 1，最大长度 10
field*string过滤字段
字段长度最小 1 字节，长度最大 32 字节
operator*enum操作符，枚举详情
当 field 取值 app_android_channel_package_id 时，可选值：{ EQUALS }
当 field 取值 conversion_id 时，可选值：{ EQUALS }
当 field 取值 impression_feedback_url 时，可选值：{ EQUALS }
当 field 取值 attribution_window 时，可选值：{ EQUALS }
当 field 取值 conversion_link_id 时，可选值：{ EQUALS }
当 field 取值 create_source_type 时，可选值：{ EQUALS }
当 field 取值 conversion_name 时，可选值：{ CONTAINS }
当 field 取值 site_set 时，可选值：{ IN }
当 field 取值 optimization_goal 时，可选值：{ EQUALS }
当 field 取值 deep_behavior_optimization_goal 时，可选值：{ EQUALS }
当 field 取值 deep_worth_optimization_goal 时，可选值：{ EQUALS }
当 field 取值 deep_worth_advanced_goal 时，可选值：{ EQUALS }
当 field 取值 access_status 时，可选值：{ IN }
当 field 取值 cost_type 时，可选值：{ EQUALS }
当 field 取值 marketing_scene 时，可选值：{ EQUALS }
当 field 取值 live_video_mode 时，可选值：{ EQUALS }
当 field 取值 live_video_sub_mode 时，可选值：{ EQUALS }
当 field 取值 campaign_type 时，可选值：{ EQUALS }
values*string[]字段取值，values 数组的个数限制与 operator 的取值相关，详见 枚举详情
当 field 取值 create_source_type 时，数组长度为 1
可选值：{ SELF_CREATED, PLATFORM }
当 field 取值 app_android_channel_package_id 时，数组长度为 1
字段长度最小 1 字节，长度最大 128 字节
当 field 取值 impression_feedback_url 时，数组长度为 1
字段长度最小 1 字节，长度最大 2048 字节
当 field 取值 attribution_window 时，数组长度为 1
当 field 取值 conversion_id 时，数组长度为 1
当 field 取值 conversion_link_id 时，数组长度为 1
当 field 取值 conversion_name 时，数组长度为 1
字段长度最小 1 字节，长度最大 120 字节
当 field 取值 site_set 且 operator 取值 IN 时，
数组最小长度 1，最大长度 100
可选值：{ SITE_SET_MOBILE_UNION, SITE_SET_WECHAT, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_MOBILE_YYB, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_QBSEARCH, SITE_SET_SEARCH_SCENE }
当 field 取值 site_set 且 operator 取值 EQUALS 时，
数组长度为 1
可选值：{ SITE_SET_MOBILE_UNION, SITE_SET_WECHAT, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_MOBILE_YYB, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_QBSEARCH, SITE_SET_SEARCH_SCENE }
当 field 取值 optimization_goal 时，数组长度为 1
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
当 field 取值 deep_behavior_optimization_goal 时，数组长度为 1
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
当 field 取值 deep_worth_optimization_goal 时，数组长度为 1
可选值：{ GOAL_NONE, GOAL_7DAY_PURCHASE_ROAS, GOAL_15DAY_PURCHASE_ROAS, GOAL_30DAY_PURCHASE_ROAS, GOAL_60DAY_PURCHASE_ROAS, GOAL_30DAY_MONETIZATION_ROAS, GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS, GOAL_3DAY_PURCHASE_ROAS, GOAL_3DAY_MONETIZATION_ROAS, GOAL_7DAY_MONETIZATION_ROAS, GOAL_15DAY_MONETIZATION_ROAS, GOAL_7DAY_RETENTION_TIMES, GOAL_7DAY_LONGTERM_PURCHASE_ROAS, GOAL_14DAY_LONGTERM_PURCHASE_ROAS, GOAL_30DAY_LONGTERM_PURCHASE_ROAS, GOAL_QYT_7DAY_LIVE_STREAM_DEAL_ROAS, GOAL_WITHDRAW_DEPOSITS_ROAS }
当 field 取值 deep_worth_advanced_goal 时，数组长度为 1
可选值：{ GOAL_NONE, GOAL_7DAY_PURCHASE_ROAS, GOAL_15DAY_PURCHASE_ROAS, GOAL_30DAY_PURCHASE_ROAS, GOAL_60DAY_PURCHASE_ROAS, GOAL_30DAY_MONETIZATION_ROAS, GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS, GOAL_3DAY_PURCHASE_ROAS, GOAL_3DAY_MONETIZATION_ROAS, GOAL_7DAY_MONETIZATION_ROAS, GOAL_15DAY_MONETIZATION_ROAS, GOAL_7DAY_RETENTION_TIMES, GOAL_7DAY_LONGTERM_PURCHASE_ROAS, GOAL_14DAY_LONGTERM_PURCHASE_ROAS, GOAL_30DAY_LONGTERM_PURCHASE_ROAS, GOAL_QYT_7DAY_LIVE_STREAM_DEAL_ROAS, GOAL_WITHDRAW_DEPOSITS_ROAS }
当 field 取值 access_status 且 operator 取值 IN 时，
数组最小长度 1，最大长度 2
可选值：{ ACCESS_STATUS_COMPLETED, ACCESS_STATUS_PENDING }
当 field 取值 cost_type 时，数组长度为 1
可选值：{ BID_TYPE_CPC, BID_TYPE_CPA, BID_TYPE_CPS, BID_TYPE_CPM, BID_TYPE_CPD }
当 field 取值 marketing_scene 时，数组长度为 1
可选值：{ DEFAULT, GAME_RESERVATION, GAME_PROMOTION, GAME_CLOSED_BETA_TEST, ECOMMERCE_GOODS_DIRECT_PURCHASE_DAILY, ECOMMERCE_GOODS_LIVE_PURCHASE_DAILY, ECOMMERCE_CONSUMER_COLLECT_CLUES_DAILY, ECOMMERCE_CONSUMER_ADD_FOLLOWERS_DAILY, ECOMMERCE_CONSUMER_OFFICIAL_ACCOUNTS_DAILY, ECOMMERCE_CONSUMER_CHANNELS_DAILY, ECOMMERCE_CONSUMER_ANDROID_NEW_DAILY, ECOMMERCE_CONSUMER_IOS_NEW_DAILY, ECOMMERCE_CONTENT_BRAND_DAILY }
当 field 取值 live_video_mode 时，数组长度为 1
可选值：{ LIVE_VIDEO_MODE_DEFAULT, LIVE_VIDEO_MODE_VIDEO, LIVE_VIDEO_MODE_LIVE }
当 field 取值 live_video_sub_mode 时，数组长度为 1
可选值：{ LIVE_VIDEO_SUBMODE_DEFAULT, LIVE_VIDEO_SUBMODE_LIVE_ROOM, LIVE_VIDEO_SUBMODE_LIVE_RESERVATION }
当 field 取值 campaign_type 时，数组长度为 1
可选值：{ CAMPAIGN_TYPE_SEARCH, CAMPAIGN_TYPE_NORMAL }
pageinteger搜索页码
最小值 1，最大值 99999
默认值：1
page_sizeinteger一页显示的数据条数
最小值 1，最大值 2000
默认值：10

参考如下请求示例：

curl -v -G 'https://api.e.qq.com/v3.0/conversions/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \ 
-d 'account_id=<ACCOUNT_ID>' \ 
-d 'filtering=[
    {
        "values": []
    }
]' \ 
-d 'page=1' \ 
-d 'page_size=10'


返回参数

名称类型描述
liststruct[]返回信息列表
conversion_idinteger转化 id
conversion_namestring转化名称，字段长度最小 1 个等宽字符，长度最大 60 等宽字符（即字段最大长度为 60 个中文字或全角标点，120 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
access_typeenum上报方式，SDK 上报方式仅支持安卓和 ios 转化场景，JS 上报方式仅支持网页转化场景。详见 枚举详情
claim_typeenum归因方式，SDK 上报方式时归因方式只能为 CLAIM_TYPE_ACTIVATION，JS 上报方式时只能是 CLAIM_TYPE_CLICK,微信小游戏推广仅支持 CLAIM_TYPE_REGISTER，QQ 小游戏推广、企业微信推广仅支持是 CLAIM_TYPE_CLICK，APP 类型、WEB 类型、微信小程序并且配置白名单的账户支持 CLAIM_TYPE_IMPRESSION。详见 枚举详情
feedback_urlstring监控链接，点击监测链接用于接收平台的点击信息，需输入合法 url，可参考文档：广告点击。当自归因为 true 并且 conversion_scene 为 ANDROID 或者 iOS，Feedback_URL 必填
self_attributedboolean是否自归因，当选择 true 代表自归因，自行匹配转化数据后上报给平台，当选择 false 代表全量上报，将产生的所有转化数据上报给平台进行归因。上报方式为 API 时必须为 TRUE，上报方式为 SDK/JS 时必须为 FALSE
optimization_goalenum优化目标类型，支持的优化目标及对应的深度优化目标可通过“查询优化目标权限”接口进行查询。详见 枚举详情
deep_behavior_optimization_goalenum深度优化行为目标，深度优化行为目标和深度优化 ROI 目标仅可填写其中一个。枚举列表：枚举详情
deep_worth_optimization_goalenum深度优化 ROI 目标，深度优化行为目标、深度优化 ROI 和深度强化 ROI 目标仅可填写其中一个。枚举列表：枚举详情
user_action_set_idinteger数据源 id，当是否自归因选择 true 时，数据源 id 不可填，当是否自归因选择 false 时，如果该 APP 在当前账户下可见多个数据源，则需要手动指定一个，其他情况可不填
user_action_set_keystringSDK 接入时对应的密钥，与 user_action_set_id 相对应，当过滤条件里按照转化 id 筛选时返回该字段
site_set_enableboolean当前站点是否可用，true：是，false：否
is_deletedboolean是否已删除，true：是，false：否
access_statusenum接入状态，枚举列表：枚举详情
create_source_typeenum转化创建来源，如 SELF_CREATED,PLATFORM 等，枚举详情
app_android_channel_package_idstring安卓应用渠道包 id，在投放推广目标类型为 Android 应用且接入方式为 SDK 的情况下，可以填写 Market API 中android_union_channel_packages/add接口创建的腾讯广告渠道包的渠道包 id。只可以选择自定义渠道包 id 非空的渠道包，且只会将自定义渠道包 id 一致的数据计入转化量。渠道包 id 可以从推广目标模块的读取接口获取，渠道包 id 字段由"xx;yy" 两部分组成，在写入时 xx 会被置为 0，0 为正常。
marketing_carrier_idstring营销载体 id，如安卓应用 id、IOS 应用 id、小游戏 id 等
conversion_sceneenum转化场景，网页及微信小程序转化场景无需输入推广目标 id。详见 转化归因
owner_idinteger转化的拥有者 id，即创建该转化的账号 id
deep_worth_advanced_goalenum强化 ROI 目标，深度优化行为目标、深度优化 ROI 和深度强化 ROI 目标仅可填写其中一个。枚举列表：android_union_channel_packages_add
conversion_link_idinteger营销链路 id
impression_feedback_urlstring监控链接，曝光监测链接用于接收平台的曝光信息，需输入合法 url，可参考文档：广告曝光。白名单账户可选填
attribution_windowinteger曝光归因窗口期
默认值：7
deep_behavior_advanced_goalenum加强优化行为目标，加强优化行为目标和加强优化 ROI 目标仅可填写其中一个。枚举列表：枚举详情
默认值：7
deep_behavior_advanced_goal_min_priceinteger加强优化行为目标最低出价，单位分
deep_behavior_advanced_goal_max_priceinteger加强优化行为目标最高出价，单位分
deep_optimization_goal_typeenum深度优化目标类型，如 SELF_OG,AUTO_OG 等。详见枚举详情
forward_link_assistenum优化目标类型，支持的优化目标及对应的深度优化目标可通过“查询优化目标权限”接口进行查询。详见 枚举详情
incubation_optimization_goalenum优化目标类型，支持的优化目标及对应的深度优化目标可通过“查询优化目标权限”接口进行查询。详见 枚举详情
conversion_link_idinteger链路模板 id，与 2.1.2 返回体中 conversion_link_id 同值
custom_report_node_listList<Integer>上报数据节点
must_report_node_listList<Integer>必须上报节点
recommend_report_node_listList<Integer>推荐上报节点
conversion_link_nodesstruct链路节点信息
conversion_link_node_idInteger链路节点 id
conversion_link_node_namestring链路节点名称
conversion_link_node_indexinteger链路节点下标
carrier_idinteger载体 id
carrier_namestring载体名称
disable_codeinteger不可用代码
disable_messagestring不可用原因
page_infostruct分页配置信息
pageinteger搜索页码
默认值：1
page_sizeinteger一页显示的数据条数
默认值：10
total_numberinteger总条数
total_pageinteger总页数

调用接口后的返回示例如下：

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "conversion_id": 12345,
                "conversion_name": "测试转化",
                "access_type": "ACCESS_TYPE_API",
                "claim_type": "CLAIM_TYPE_ACTIVATION",
                "feedback_url": "http://wwww.qq.com?a=__CLICK_ID__&b=__CLICK_TIME__&c=__MUID__&d=__ACCOUNT_ID__&f=__CALLBACK__&g=__DEVICE_OS_TYPE__&h=__HASH_MAC__&i=__HASH_OAID__&j=__OAID__&k=__HASH_ANDROID_ID__&l=__PROMOTED_OBJECT_ID__&o=__AD_ID__",
                "self_attributed": true,
                "optimization_goal": "OPTIMIZATIONGOAL_APP_ACTIVATE",
                "deep_behavior_optimization_goal": "OPTIMIZATIONGOAL_APP_REGISTER",
                "is_deleted": false,
                "app_android_channel_package_id": "0;10000534",
                "conversion_scene": "CONVERSION_SCENE_ANDROID",
                "conversion_link_id": 123,
                "conversion_link_info": {
                    "landing_page_access": {
                        "support_page_types": [],
                        "must_not_page_types": [],
                        "must_page_types": []
                    }
                },
                "custom_report_node_list": [],
                "must_report_node_list": [],
                "recommend_report_node_list": [],
                "conversion_link_nodes": [
                    {
                        "conversion_link_action_type": [],
                        "og_id": [],
                        "roi_og_id": []
                    }
                ]
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

广告资源

广告技术

开发文档

辅助工具

帮助支持

手机浏览开发者官网

Copyright © 1998 - Tencent Inc. All Rights Reserved. 腾讯公司 版权所有