gdd2009 ad words-adwords-ap_is-and-tools
TRANSCRIPT
AdWords API
Fred Chung
3
•! AdWords API 功能概述
•!技 介
•!版本 行与 展路
•!最佳 技巧
•!参考 源
•!工具演示
程
4
AdWords 介
5
常用 AdWords 的方式
AdWords
我的客中心
AdWords
•!三种不同的 Google 品界面
•! 管理 、 化 、 告等功能
我我我我我的的的的的客客客客中中中中心心心心心
e gle 品界面
、 告等功能
6
功能比
可以自 化的功能
管理多个
内部
系 集成 定制功能
需要技 支持和投
AdWords
我的客 中心
AdWords
7
功能比
可以自 化的功能
管理多个
内部
系 集成 定制功能
需要技 支持和投
告
告 !"
告、
管理 !!"
AdWords
我的客 中心
AdWords
!
8
功能比
可以自 化的功能
管理多个
内部
系 集成 定制功能
需要技 支持和投
告
告 !"
告、
管理 !!"
!" !"
例如: CRM、
系 、
存管理 系
!" !"
AdWords
我的客 中心
AdWords
9
AdWords 的方式
AdWords API v13
HTML / HTTPS SOAP / HTTPS S
ds API v
AP ///// HT
AdWords
AdWords 我的客 中心
AdWords
定制 件平台
10
1.! 建 和自 化 管理
2.! 内部系 集成
3.! 添加定制增 功能
使用 AdWords API 的好
11
•! 建 和自 化 管理
更改 例如: 停、 增加关 字
分析 告数据
下 告 建
重复
•!每个 操作人 每天可以 省数小 !!
使用 AdWords API 的好
12
•!内部系 集成
•! 操作人 提供 一的界面
•!数据再无需反复 入
•!企 内部流程自 化
CRM
其他系
本地 数据 AdWords AdAd
API
使用 AdWords API 的好
存管理系
13
•!添加增 的功能
!!
如 消 高(或 低) 修改出价
比 消 与 算
下 表 告
关 字将直接 用于同行 的 新
将关 字按照 一定的行 保存在本地数据
手 或者 借助工具找到 关 字
使用 AdWords API 的好
!!
14
•!添加增 的功能
!!
根据不同分店 品存量而修改 关 字出价
与 存管理 系 整合
使用 AdWords API 的好
15
人力成本 vs. 管理 数量
10’s 100’s 1,000’s 10,000’s
<10
10’s
100’s
人力成本
(客服数量)
管理 数量
网 版/ 器 1 CSR : 100
AdWords API 1 CSR : 1000 以上
16
•!当前版本: v13
•!下一版本: v14
API 版本 行与 展路
推出 v2009 区 版本
推出 v13 版
2008 年
10 月
2009 年
4 月
7 月 10 月 12 月 2010 年
!
在未来数月分 段推出 v2009 (6 月份至 9 月份)
停止支持 v13
(2010年初)
: vvvvvvvvv111111111444444444 v2009
AdWords API 技 介
18
•!当前版本: v13
•!由 10 个网 服 成
•!提供程序 的接口
•!基于 SOAP – 各 言与平台通用
•!我 提供 WSDL
•! 最常用的 程 言提供工具包
•! Java
•! PHP
•! Perl
•! Python
•! .NET
•! Ruby
API 技
Ad
Report
Info, Site
Suggestion Keyword
Tool
Traffic Estimator
Criterion Account
Ad Group
Campaign
19
v13 SOAP 求示例 <?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope>
<SOAP-ENV:Header>
<email>[email protected]</email>
<password>[email protected]</password>
<useragent>User_agent</useragent>
<clientEmail>client1@email_test</clientEmail>
<developerToken>ABCDEFGHIJKL11212</developerToken>
<applicationToken>11232AQQ-wdsEWDd</applicationToken>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<addCriteria>
<criteria>
<adGroupId>1111</adGroupId>
<criterionType>Keyword</criterionType>
<text>旅 </text>
<type>Broad</type>
</criteria>
</addCriteria>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
y
<addCriteria>
<criteria>
<adGroupId>1111</adGroupId>
<criterionType>Keyword</criterionType>
<text>旅 </text>
<type>Broad</type>
</criteria>
</addCriteria>
Header
正文 Body
信包 Envelope
20
.NET 代 示例
000 CriterionService service = new CriterionService(); 001 service.emailValue.Text = new String[] {"[email protected]"}; 002 service.passwordValue.Text = new String[] {"mcc_password1"}; 003 service.clientEmailValue.Text = new String[] {"[email protected]"}; 004 service.useragentValue.Text = new String[] {"test-user-agent"}; 005 service.developerTokenValue.Text = new String[] {"ABCEDEFGHIJKL11212"}; 006 service.applicationTokenValue.Text = new String[] {"11232ABCD…"};
007 Keyword keyword = new Keyword(); 008 keyword.adGroupId = 111; 009 keyword.criterionType = CriterionType.Keyword; 010 keyword.criterionTypeSpecified = true; 011 keyword.text = "\u65C5\u9986"; // 旅 012 keyword.type = KeywordType.Broad; // 广泛匹配 013 014 Criterion[] criteria = service.addCriteria(new Criterion[] {keyword});
V13 添加关 字
21
当前 AdWords 的方式
AdWords API v13
HTML / HTTPS SOAP / HTTPS S
ds API v
AP ///// HT
AdWords
AdWords 我的客 中心
AdWords
定制 件平台
22
v2009 AdWords 的方式
AdWords
通用
AdWords API v2009
AdWords 我的客 中心
AdWords
定制 件平台
23
AdWords API v2009 的重要升
•!兼容更多网 版 AdWords 的功能 例如: 度数据, 自定 形状
•! 次 求中可以包含多种操作
–! 可以在一个 求中包含添加和更新操作
–! 跨广告 的 更改
•!支持异步模式,提高信息 效率
•!提高容 的能力,批量更改 只需重 的 求
•!更低 API 位的使用成本
•!基于 ClientLogin 的新的身份 模式
24
Google ClientLogin API
•! v2009 利用 ClientLogin API 行身分
•! SOAP 文件 再不必包括:MCC email, 密 , 开 人 和用程序令牌等等
客 端
HTTP POST
https://www.google.com/accounts/ClientLogin
•! accountType=GOOGLE •! service=adwords
•! Email=mcc%40login.email •! Passwd=mcc_password1
……. ….. •! Auth=DQAA…..
SOAP 只需包括 令牌
25
v2009 与 v13 的网 服 比
V13 v2009
CampaignService CampaignService
无 CampaignCriterionService
CampaignService 的其中一部分 CampaignTargetService
AdGroupService AdGroupService
AdService AdGroupAdService
CriterionService AdGroupCriterionService
26
<SOAP-ENV:Envelope>
<SOAP-ENV:Header>
<RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/
v200902">
<authToken>DQAA….</authToken>
<clientEmail>client1@email_test</clientEmail>
</RequestHeader>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<mutate xmlns="https://adwords.google.com/api/adwords/cm/v200902">
<operations>
<operator>ADD</operator>
<operand xsi:type="BiddableAdGroupCriterion">
<adGroupId>
<id>1111</id>
</adGroupId>
<criterion xsi:type="Keyword">
<matchType>BROAD</matchType>
<text>旅 </text>
</criterion>
</operand>
</operations>
</mutate>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
v2009 SOAP 求示例
<RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/
v200902">
<authToken>DQAA….</authToken>
<clientEmail>client1@email_test</clientEmail>
<mutate xmlns="https://adwords.google.com/api/adwords/cm/v200902">
<operations>
<operator>ADD</operator>
<operand xsi:type="BiddableAdGroupCriterion">
<adGroupId>
<id>1111</id>
</adGroupId>
<criterion xsi:type="Keyword">
<matchType>BROAD</matchType>
<text>旅 </text>
</criterion>
</operand>
Header
正文 Body
信包 Envelope
27
.NET 代 示例
00 AuthToken authToken = new AuthToken("[email protected]", "mcc_password1"); 01 string token = authToken.GetToken(); 02 AdGroupCriterionService service = new AdGroupCriterionService(); 03 service.Url = "https://adwords-sandbox.google.com/api/… AdGroupCriterionService"; 04 05 service.RequestHeader = new RequestHeader(); 06 service.RequestHeader.authToken = token; 07 service.RequestHeader.clientEmail = clientEmail; 08 09 Keyword keyword = new Keyword(); 10 keyword.text = "\u65C5\u9986"; 11 keyword.matchTypeSpecified = true; 12 keyword.matchType = KeywordMatchType.BROAD; 13 14 BiddableAdGroupCriterion criterion = new BiddableAdGroupCriterion(); 15 criterion.adGroupId = new AdGroupId(); 16 criterion.adGroupId.idSpecified = true; 17 criterion.adGroupId.id = long.Parse("1111"); 18 criterion.criterion = keyword; 19 20 AdGroupCriterionOperation adGroupCriterionOperation 21 = new AdGroupCriterionOperation(); 22 adGroupCriterionOperation.@operator = Operator.ADD; 23 adGroupCriterionOperation.operatorSpecified = true; 24 adGroupCriterionOperation.operand = criterion; 25 26 AdGroupCriterionReturnValue results = 27 service.mutate(new AdGroupCriterionOperation[] {adGroupCriterionOperation});
v2009 添加关 字
28
API 位
•!每个 AdWords API 求都需要耗 一定数目的 API 位
•!每1,000 位需要 USD $0.25 (! RMB ¥1.7)
•!防止 用系
•!促 更有效的使用 API
v2009 划再 低价格!!
29
API 条款和条件
更好的保障双方的权力和利益
!! 多平台的广告数据
!! 多平台的 告
更好的保障双方的
权力和利益
多平台的广告数
据
http://www.google.com/apis/adwords/terms.html
30
最佳 技巧
1.! 管理 求的速度和同 求的数量
–! AdWords API 服 器有 会拒 求量 高的
–! HTTP 503 或 API 代 87 的异常 理
–! 建立判断的 ,在必要 整 求的速度和同 求的数量
2.! 添加日志功能
–! 所有 API 和响 息
–! 以便技 支持和排
3.! 建立重 的
–! 重 失 的
4.! 尽可能使用批量操作
5.! 使用工具作 化,例如自 生成高效的关 字列表
31
参考 源
•! v13 API 开 人 指南 http://code.google.com/intl/zh-CN/apis/adwords/docs/developer/adwords_api_reference.html
•! v2009 API 文档 ( 区 ) http://code.google.com/apis/adwords/v2009/docs/
•!申 使用 API https://adwords.google.com/select/ApiWelcome
•!代 示例 http://code.google.com/intl/zh-CN/apis/adwords/docs/samples.html
•!支持 [email protected]
•!在 http://groups.google.com/group/adwords-api
工具演示
33
MCC
子 1 子 2 子 3 . . . . . 子 N
演示 取数据
34
MCC
子 1 子 2 子 3 . . . . . 子 N
演示 取数据
35
AdWords AA
API
定制平台
演示
答 Q&A