第三方监测
简介
华为支持在广告推广中添加第三方监测功能,华为广告推广主或第三方监测平台申请 监测白名单并获得通过后即可使用。
通过引入第三方 API 监测,广告主可以获得由客观公正的第三方监测公司提供认证的 广告数据,监测目标广告的曝光、点击等关键指标。
目前,HUAWEI Ads 已与秒针、国双、AdMaster、Double Click、Sizmek 等国内外多 家第三方监测公司实现技术对接。
实现方式
华为广告主在对推广计划提供创意时,通过填写由第三方平台提供的监测地址,可将创意 的曝光/点击数据发送到第三方平台服务器。 HUAWEI Ads 通过约定监测地址 URL 中指定格式和名称的字符串,确定每次曝光/点 击发生时需要上报给第三方平台服务器的信息。 HUAWEI Ads 支持的检测字段和地址格式要求如下:
支持字段
宏名称 | 字段描述 |
__OS__ | 操作系统名称,仅支持安卓 |
__IP__ | IP 地址 |
__MAC__ | MAC 地址 md5 加密,若 MAC 中有":" ,将 ":"替换为空再做 md5 加密 |
__ANDR OIDID__ | 安卓 ID md5 加密 |
__IMEI__ | IMEI md5 加密 |
宏名称 | 字段描述 |
__APP__ | 媒体名称 utf-8 编码 |
__REQU ESTID__ | 广告请求 ID 替换为 __REQUESTID__ 或 __HWPPSREQUESTID__ |
__OAID_ _ | OAID ,原值,如果用户关闭了个性化广告, OAID 会被设置为全 0,例 如: 00000000-0000-0000-0000-000000000000 |
__TERM_ _ | 机型 |
监测地址格式
监测地址链接是由第三方监测平台提供的、用于 HUAWEI Ads 将曝光/点击数据 传输给第三方监测的链接。 监测地址格式由“前缀+服务器域名+参数”三部分构成,其中:
① 前缀只能是 https 开头;
② 服务器域名必须是能够正常访问的正式域名,不接受 IP 或下载链接;
③ 参数必须是全大写字母,两边为双下划线(参数左右两边均为两个连续的英文 字符"_"),可根据实际选择需要的参数,并使用与号 (&) 分隔参数。
示例: https://www.example.com/track_click.ashx?k=2129556&p=7QJNf&ns=__IP__&tr=__R EQUESTID__&mo=__OS__&m1=__ANDROIDID__&m2=__MAC1__&m3=__OAID __
使用指南
广告主在获取到第三方监测平台申请监测地址后,即可按照如下步骤开启第三方检测 功能。
第三方监测服务器域名信息应在白名单内。
第三方监测平台监测地址需要符合 HUAWEI Ads 平台要求。
说明
步骤 1 新建广告任务
步骤 2 上传广告创意,并添加监测地址
----结束
FAQ
Q1:为什么要使用第三方监测?
通过委托第三方监测,可以核对实际发生的展示或点击数量,以确保广告主的利益。
Q2:支持的监测指标有哪些?
第三方监测支持曝光和点击两项指标的监测。
Q3:第三方监测数据和投放端的数据是否存在较大差异?
通过与已经对接的第三方监测公司实测得到结果,数据差异一般不超过 5%。这些差异主要是由于网络原因、各方反作弊机制等因素造成。
以投放端的数据为准结算实际广告费用,第三测公司提供的曝光/点击量仅供参考。
Marketing
简介
概述
Marketing API 是 HUAWEI Ads 对外开放技术能力的开放平台,为开发者提供统一的鉴 权、开发、管理等服务,在功能、性能、安全、技术支持等多个方向提供良好的开发 体验。通过底层的应用程序接口调用,实现数据与服务功能的传输,让外部客户在本 地也能远程使用 HUAWEI Ads 平台系统,完成广告投放、报表分析、创意制作等功 能,提升营销效率。
Marketing API 主要服务于有着一定的技术能力的大客户,这些客户对于自动化有着强 烈诉求,追求更为定制化、智能化的投放,打造内部系统满足真正个性化的诉求,以 探索更好的投放效率和效果。
API 接入全流程
1. 广告主到联盟完成实名认证。
2. OAuth2.0 认证:Marketing API 采用 OAuth2.0 授权码模式(authorization code)模 式进行授权认证,所有接口均通过请求头中传递的 access_token(授权令牌)来进 行身份认证和鉴权。
3. 申请应用权限:获取到客户端 ID 和密钥后,需要为客户端 ID 申请调用权限。
4. 登录并获取 access_token
5. 调用业务接口
使用指南
接入流程
认证为开发者
广告主到联盟完成实名认证。
Marketing API 采用 OAuth2.0 授权码模式(authorization code)模式进行授权认证,所 有接口均通过请求头中传递的 access_token(授权令牌)来进行身份认证和鉴权。
1. 使用实名认证帐号登录联盟
2. 选择“HMS API 服务>凭证>OAuth2.0 客户端 ID”
3. 选择“服务器应用”,各字段填写方式如下:
− 产品名称:客户端名称
− 应用类型:应用 − 默认语言: 简体中文
− 应用访问地址:客户端原地址,格式 https://{ServerRoot}
注:回调地址必填且与应用访问地址完全一样,且必须是 https 协议类型网址。
4. 点击“创建”,创建凭证成功,复制“客户端 ID”和“秘钥”即可
申请应用权限
获取到客户端 ID 和密钥后,需要为客户端 ID 申请调用权限。
请联系产品经理 huweiwei6@huawei.com 申请应用权限。 注:授权码模式和客户端模式可以用同一个客户端 ID
申请模板:
标题:申请开通 Huawei Ads Marketing API 服务
正文:申请开通如下应用的推广服务权限
登录开发者联盟的华为账号:{开发者联盟平台帐号}
开发者企业名称:{在开发者联盟实名认证的企业名称}
客户端 ID:{1.2 节获取的客户端 ID }
登录广告平台的华为帐号:{HUAWEI Ads 的投放平台帐号}
广告主企业名称:{在广告平台实名认证的企业名称}
投放平台账户 ID:{账户 ID}
回调地址:{获取授权码和 token 时的跳转地址}
认证方式:{授权码模式或客户端模式}
登录并获取 access_token
1. 获取授权码
请求消息
客户端:广告主服务器
服务端: Huawei 帐号服务器
请求协议:HTTPS
请求方式:GET
接口 URL:https://login.cloud.huawei.com/oauth2/v2/authorize
请求参数
参数名称 | 类型 | 是否必 选 | 描述 |
response_typ e | string | 是 | 固定为“code” |
client_id | int | 是 | 客户端 ID |
scope | string | 是 | 功能 scope,多个值使用空格分隔。固定填 写: https://www.huawei.com/auth/account/base.prof ile https://ads.cloud.huawei.com/report https://ads.cloud.huawei.com/promotion https://ads.cloud.huawei.com/tools |
redirect_uri | string | 是 | 授权后回调的 URI,用于接收 Authorization Code 。需要进行 URLEncode 编码,参考请求示例。 注意:如果应用接收回调请求的 redirect_uri 渲染一个 HTML 页面,那么该页面下的任何 资源都将能够访问到 URL 中的 authorization code。脚本可以直接读取 URL,URL 还会出 现在 HTTP 头中的 Referer 字段,这个头部 会被发送到该页面下的任何资源。 为了避免这个问题, 建议应用服务器先处理 这个请求, 然后重定向到另一个不会包含 authorization code 参数的 URL。 |
access_type | string | 否 | 是否需要返回 refresh_token。需要时填写 offline,不需要时不填写 |
state | string | 否 | 用于保持请求和回调的状态, 授权服务器在 回调时(重定向用户浏览器到 “redirect_uri”时) ,会在 Query Parameter 中原样回传该参数。 OAuth2.0 标准协议建 议,利用 state 参数来防止 CSRF 攻击。 |
请求示例
=================================================================== ======================================
GET
https://login.cloud.huawei.com/oauth2/v2/authorize?response_type=code&client_id=123456 &redirect_uri=https%3A%2F%2Fwww.example.com&scope=https%3A%2F%2Fads.cloud.h uawei.com%2Fpromotion&t&
HTTP/1.1
Content-Type: application/x-www-form-urlencoded =================================================================== ======================================
HUAWEI Ads 的登录地址为:
https://login.cloud.huawei.com/oauth2/v2/authorize?response_type=code&client_id=1038074 2&redirect_uri=https%3A%2F%2Fe.hicloud.com&scope=https%3A%2F%2Fwww.huawei .com%2Fauth%2Faccount%2Fbase.profile%20https%3A%2F%2Fads.cloud.huawei.com%2F report%20https%3A%2F%2Fads.cloud.huawei.com%2Fpromotion%20https%3A%2F%2Fad s.cloud.huawei.com%2Ftools&access_type=offline
请将标红的 client_id 替换为 2.2 申请到的客户端 ID,将标红 redirect_uri 替换为业务的 回调地址。
随后,跳转至登录界面,输入投放平台账户密码,OAuth 2.0 服务器会把响应值通过 redirect_uri 反馈给应用,如果用户同意授权,则回调请求中
带有授权码的回调:
https://www.example.com/?authorization_code=DQB6e3x9BA6qhTZtKy9iPYcJNvtK%2FuI LikDUC%2B1ss372SvVbk%2Bs8%2BdU3mWvmWGAjx5QA1z9njJcakOAuqOlS63y4n0Y T35XHfQuojwPC9VkISSRrKinWzuPyYPKZTGKn2oJtZtbnODhsB8LTc26RIcWqIIO7%2B CYR9kYCNa9USzM87hy8lwAJdDXiQCf3qJnyTwvqbt6LJg%3D%3D
2. 用授权码换取 AT
请求消息
客户端:广告主服务器
服务端: Huawei 帐号服务器
请求协议:HTTPS
请求方式:POST
接口 URL:https://login.cloud.huawei.com/oauth2/v2/token
参数名称 | 类型 | 是否必 选 | 描述 |
grant_type | string | 是 | 固定为“authorization_code” |
code | string | 是 | 通过/oauth2/v2/authorize 接口获取到的 Authorization Code。注意 code 是一次性的, 且只有 5 分钟有效期。5 分钟之前获取的 code 或者已经使用过的 code ,是不能再使用的。 |
client_id | int | 是 | 必须和调用/oauth2/v2/authorize 接口时传递的 client_id 一样 |
client_secret | string | 是 | client_id 的密码 |
redirect_uri | string | 是 | 必须和调用/oauth2/v2/authorize 接口时传递的 redirect_uri 参数完全一致 |
请求示例 =================================================================== ======================================
POST https://login.cloud.huawei.com/oauth2/v2/token
HTTP/1.1
Content-Type: application/x-www-form-urlencoded grant_type=authorization_code&code=DQB6e3x9VcE1p6TbMpZYACkHZ1S6%2Bk%2FXq ls2JAhlQhLhBcJRxopxVv8qwajzIowWBVUH2dytzy57S0ix14mohbjzL5kBeOT5m6noOqU qIeHoZ6aZalxTCVF%2BVSHSnZsTBUjR%2FWz7C5e3XHMSvxtqYsUjiXkq4f5MeRRjA8 vnpyI%2Fub45ukyGPXXPdy0QKGKWwZQvGp4L6Q%3D%3D&client_id=123456&client _secret=xxxxxx&redirect_uri=https%3A%2F%2Fe.hicloud.com =================================================================== ======================================
响应参数
参数名称 | 类型 | 是否必选 | 描述 |
access_token | string | 是 | 应用 access_token。 json 字符串中存在转义符。如果用curl 命令 或者 postman 工具手工获取 access_token , 把“\/”还原为“/”才是正确的 access_token,否则在使用 access_token 的 过程中会报 access_token 非法。如果是写代 码,采用任意的第三方库,都能正确解析 json 串,获取到正确的值 |
expires_in | string | 是 | 应用 access_token 过期时间,单位(秒) |
refresh_token | string | 否 | 用于刷新 Access Token 的 Refresh Token, 有效期半年(华为 OAuth 可能会调整这个 配置)。需要在调用/oauth2/v2/authorize 接 口获取 code 时传递参数 access_type=offline 才会返回 refresh_token |
scope | string | 是 | Access Token 最终的访问范围 |
token_type | string | 是 | token 类型 |
响应消息样例 =================================================================== ======================================
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store {"access_token":"CgB6e3x9WivoFhhdEA9nppR\/Tl1eye1OC0c\/a8VH17m\/AYq0yFfgaY6K RbpMmFAq+pg\/YngjAC+p16prtz\/YThC******zKv2bY\/ZNYWtbpHMOSjJw==", "expires_in":3600, "refresh_token": "CF13G0sRaGybtYt7SIyeUILNORtTFwMgz4ao5C7j7vtgLPt6ogmXKjdI8RS\/YlyS71z4*** ***MnOrRlmNK0KhdOUNWd+qVLLRsEEHkqRIKpuAkPvL8=", "scope":"https:\/\/ads.cloud.huawei.com\/promotion openid","token_type":"Bearer"} =================================================================== ======================================
调用业务接口
请求示例 =================================================================== ======================================
POST /openapi/v2/promotion/campaign/create HTTP/1.1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
{ "campaign_name": "3333", "product_type": "WEB", "daily_budget": 100 } =================================================================== ======================================
应答示例 =================================================================== ======================================
HTTPS/1.1 200 OK
{ "code": 200, "data": { "campaign_id":"35003379" }} =================================================================== ======================================
- 2024-10-12
金投赏鲸鸿动能专场,华为广告全场景释放数… - 2024-09-23
华为广告大卡智投支持oCPD,强势助力品效合… - 2024-09-23
冲量黄金周—华为广告鲸鸿动能国庆投放指南… - 2024-09-12
如何1分钟玩转华为广告AI大模型微调推理?… - 2024-09-07
共创价值·赋能增长:携手影娱/资讯/教育行… - 2024-08-22
2024 CDEC高峰论坛:鸿蒙生态技术赋能 构筑… - 2024-08-20
华为广告携手某炒股软件,首次解锁「智慧多… - 2024-08-17
华为广告开户流程和广告计费、展示、形式有… - 2024-08-13
鲸鸿动能五大行业解决方案发布,以生态力量… - 2024-04-11
华为广告 | “低代码开发实践分享:共创未…
管理员
该内容暂无评论