包含管理关键字 (keyword) URL 的方法、跟踪模板和自定义参数。 有关详细信息,请参阅 使用升级的 URL 进行 URL 跟踪。
方法
| 方法名称 | 返回类型 | 说明 |
|---|---|---|
| clearFinalUrl | void | 删除关键字 (keyword) 的最终 URL。 |
| clearMobileFinalUrl | void | 针对移动设备,删除关键字 (keyword) 的最终 URL。 |
| clearTrackingTemplate | void | 删除关键字 (keyword) 的跟踪模板。 |
| getCustomParameters | Object | 获取关键字 (keyword) 的自定义参数。 |
| getFinalUrl | string | 获取关键字 (keyword) 的最终 URL。 |
| getMobileFinalUrl | string | 获取移动设备关键字 (keyword) 的最终 URL。 |
| getTrackingTemplate | string | 获取关键字 (keyword) 的跟踪模板。 |
| setCustomParameters (对象 customParameters) | void | 设置关键字 (keyword) 的自定义参数。 |
| setFinalUrl (字符串 finalUrl) | void | 设置关键字 (keyword) 的最终 URL。 |
| setMobileFinalUrl (字符串 finalUrl) | void | 设置针对移动设备关键字 (keyword) 的最终 URL。 |
| setTrackingTemplate (字符串 trackingTemplate) | void | 设置关键字 (keyword) 的跟踪模板。 |
clearFinalUrl
删除关键字 (keyword) 的最终 URL。
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
clearMobileFinalUrl
针对移动设备,删除关键字 (keyword) 的最终 URL。
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
clearTrackingTemplate
删除关键字 (keyword) 的跟踪模板。
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
getCustomParameters
获取关键字 (keyword) 的自定义参数。
自定义参数有助于跨多个 URL 共享动态信息。 有关其用法的详细信息,请参阅 自定义参数。
返回
| 类型 | 说明 |
|---|---|
| Object | 关键字 (keyword) 的自定义参数的映射。 例如, {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自定义参数的名称,value 是参数的值。 |
getFinalUrl
获取关键字 (keyword) 的最终 URL。 这是用户点击广告时转到的网页的 URL。
覆盖规则与其他地方一样适用。 例如,指定关键字 (keyword) 的最终 URL 将覆盖广告的最终 URL。
返回
| 类型 | 说明 |
|---|---|
| string | 关键字 (keyword) 的最终 URL。 |
getMobileFinalUrl
获取移动设备关键字 (keyword) 的最终 URL。 这是用户点击广告时转到的移动网页的 URL。
覆盖规则与其他地方一样适用。 例如,指定关键字 (keyword) 的移动最终到达网址会覆盖广告的移动最终到达网址。
返回
| 类型 | 说明 |
|---|---|
| string | 关键字 (keyword) 的移动设备最终 URL。 |
getTrackingTemplate
获取关键字 (keyword) 的跟踪模板。
跟踪模板与关键字 (keyword) 的 FinalUrl 一起使用,以创建广告使用的目标 URL。 有关详细信息,请参阅我 可以使用哪些跟踪或 URL 参数?
返回
| 类型 | 说明 |
|---|---|
| string | 关键字 (keyword) 的跟踪模板。 |
setCustomParameters (对象 customParameters)
设置关键字 (keyword) 的自定义参数。 如果最终 URL 或跟踪模板包含自定义替换字符串,请使用此方法。
若要在最终 URL 或跟踪模板中使用客户参数名称,请将该名称括在大括号中,并在名称前加上下划线 (_) 。 例如,如果参数名称为 foo,则在跟踪模板或最终 URL 中使用 {_foo}。 定义自定义参数对象时,不要在参数名称中添加前导下划线。
调用此方法将替换关键字 (keyword) 的现有自定义参数。
若要从关键字 (keyword) 中清除自定义参数,请传递空对象 (例如 setCustomParameters({})) 。 如果清除关键字 (keyword) 的自定义参数,则关键字 (keyword) 从其父广告组继承 URL, (如果广告组指定 URL) 。 若要完全清除自定义参数,请清除层次结构中所有级别的自定义参数。
自定义参数有助于跨多个 URL 共享动态信息。 有关其用法的详细信息,请参阅 自定义参数。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| customParameters | Object | 最多包含三个要在关键字 (keyword) 中使用的自定义参数的映射。 例如, {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自定义参数的名称,value 是参数的值。 参数名称可能仅包含字母数字字符,参数值不得包含空格。 该名称最多可包含 16 个 8 字节字符,值最多可包含 200 个 8 字节字符。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
setFinalUrl (字符串 finalUrl)
设置关键字 (keyword) 的最终 URL。
最终 URL 标识用户点击广告时转到的网页。 如果未指定,实体将从其父实体继承最终 URL。 例如,关键字 (keyword) 实体继承广告的最终 URL。 指定关键字 (keyword) 的最终 URL 以覆盖广告的最终 URL。
有关详细信息,请参阅我 可以使用哪些跟踪或 URL 参数?
如果属性的值无效,则调用以无提示方式失败。 要确认属性是否确实已更新,请再次获取对象并测试属性的值是否等于新值。 有关信息,请参阅 处理错误和警告。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| finalUrl | string | 关键字 (keyword) 的最终 URL。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
setMobileFinalUrl (字符串 finalUrl)
设置移动设备关键字 (keyword) 的最终 URL。
最终 URL 标识用户点击广告时转到的网页。 如果未指定,实体将从其父实体继承最终 URL。 例如,关键字 (keyword) 实体继承广告的最终 URL。 指定关键字 (keyword) 的最终 URL 以覆盖广告的最终 URL。
有关详细信息,请参阅我 可以使用哪些跟踪或 URL 参数?
若要为移动设备指定最终 URL,请首先为非移动设备指定最终 URL, (请参阅 setFinalUrl()) 。
如果属性的值无效,则调用以无提示方式失败。 要确认属性是否确实已更新,请再次获取对象并测试属性的值是否等于新值。 有关信息,请参阅 处理错误和警告。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| finalUrl | string | 关键字 (keyword) 的最终 URL 移动设备。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
setTrackingTemplate (字符串 trackingTemplate)
设置关键字 (keyword) 的跟踪模板。
跟踪模板与关键字 (keyword) 的 FinalUrl 一起使用,以创建广告使用的目标 URL。 有关详细信息,请参阅我 可以使用哪些跟踪或 URL 参数?
如果属性的值无效,则调用将在无提示的情况下失败。 要确认属性是否确实已更新,请再次获取对象并测试属性的值是否等于新值。 有关信息,请参阅 处理错误和警告。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| trackingTemplate | string | 关键字 (keyword) 的跟踪模板。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |