GoogleAdWordsAPI说明中文版
- 格式：docx
- 大小：19.21 KB
- 文档页数：6
GoogleAdWordsAPI说明中文版
AdExtensionOverrideService
使用此服务覆盖广告系列中特定广告的现有附加地址信息。
可以对广告附加信息覆盖应用以下条件：
●只能覆盖附加地址信息。
●添加覆盖前，附加地址信息必须已使用广告系列广告附加信息添加到该广告所属的广告
系列。
●一旦设置了广告附加信息覆盖的地址，将无法对其进行更新。如果删除了广告的覆盖，
则任何新覆盖都将继承已删除覆盖的地址信息。
AdGroupAdService
使用此服务管理广告。
下面是一些常用广告类型：
●文字广告搜索网络和展示广告网络中使用的主要广告类型。文字广告包含一个标题、
两行文字和一个目标网址。
●图片广告标准图片广告。
●移动广告针对移动设备的文字广告。此外，移动广告还可以包含点击通话电话号码。
●模板广告（AdWords 展示广告制作工具）一种灵活的广告类型，支持视频广告、图
片搜索广告等广告类型。有关可用模板的列表，请参阅模板广告格式附录。
AdGroupCriterionService
使用此服务管理定位标准（例如关键字或展示位置）。描述决定广告是否应显示的条件的定位标准。
●可出价定位标准定义展示父广告组广告的条件。可出价定位标准还可以指定覆盖父广告
组默认出价的出价金额。
●否定定位标准定义阻止父广告组广告展示的条件。
AdGroupService
使用此服务管理广告组。
广告组将一组广告和定位标准组织在一起，并为其定位标准提供默认出价。一个或多个广告组属于同一个广告系列。
AdParamService
使用此服务管理广告参数，让您快速更新文字广告中参数化的值（例如价格或广告资源级别）。尽管对一般广告文字的更新要在数小时后生效，但对参数化值的更新则只需几分钟即可生效。
要在广告中定义参数化值的显示位置，您可以在广告文字中插入{param#:default-value} 标记。您可以在显示文字的任意行中使用这些标记，也可以在目标网址中使用。当显示文字广告时，这些标记中的值将由广告参数的插入文字替换。default-value 指定当符合下列情况时要显示的字符串：
●尚未设置参数。
●参数的插入文字过长，无法在行中显示。
●广告正在Google 展示广告网络上显示。
AlertService
使用这项服务来获取客户帐户的相关提醒（例如信用卡即将到期或广告系列即将结束）。每个返回的提醒都会封装客户ID 以及提醒的重要性、类型以及其他任何详细信息。
BulkMutateJobService*
使用此服务可以将对您的AdWords 广告系列的大批量更新安排为异步批量Mutate 作业，并可以获取您近期所执行作业的状态、结果或统计信息。
CampaignAdExtensionService
使用此服务管理广告系列广告附加信息。 广告系列广告附加信息将额外的信息附加到标准的文字广告中（例如商户地址、电话号码或额外的网站链接），并应用到指定广告系列内的所有文字广告中。
CampaignCriterionService
使用此服务管理广告系列级定位标准。
广告系列级否定定位标准可阻止广告系列中的广告在特定展示位置或针对特定关键字和受众人口统计特点等进行展示。另外，此服务还可以用来定位地理位置、语言、运营商和平台等标准。
CampaignService
使用此服务管理广告系列。
广告系列由一个或多个广告组组成，并且具有自己的预算、出价策略、投放日期范围和定位设置。您还可以设置广告系列范围的否定条件和广告系列范围的广告附加信息。
CampaignTargetService
使用此服务为广告系列设置定位选项，也就是用来决定广告的展示时机和展示位置的过滤条件。广告系列的定位选项以一系列目标列表表示，其中每个列表包含目标类型：AdScheduleTarget 指定设置出价调节系数的日期和时间，通过设置该系数可以增加减少广告展示机会或阻止广告展示。空AdScheduleTargetList 表示在所有日期和时间机会均等地投放广告。
ConstantDataService
返回常数数据的服务。
ConversionTrackerService
使用此服务管理转化跟踪器。
转化跟踪器提供代码段，此代码将在每次用户访问包含它的网页时进行记录。所提供的数据可以用于评估您的广告和关键字的效果。
CustomerSyncService
根据给定的日期范围，使用此服务为客户帐户或广告系列获取已更改的实体。
DataService 返回与{@Selector} 相匹配的广告系列管理数据的服务。
ExperimentService
使用此服务可以设置广告系列实验：通过实验，您可以准确测试和衡量对关键字、出价、广告组和展示位置所做的更改。
创建和运行广告系列实验涉及以下步骤：
1.创建描述实验本身的Experiment 对象，包括实验ID、日期范围以及引导至该实验的
流量百分比。
2.通过设置AdGroup 和BiddableAdGroupCriterion 对象上的experimentData 字段，设
置对照和实验广告系列实体。使用experimentDataStatus 字段选择该实体应该是对照组的一部分，还是实验组的一部分，还是该实体应该同时处理对照和实验流量。
GeoLocationService
使用此服务检索给定地址的地理坐标和正规形式。以下任务需要GeoLocationService 返回的数据：
●使用CampaignAdExtensionService 和AdExtensionOverrideService 添加附加地址信息●使用CampaignTargetService 添加多边形目标或邻近目标。
InfoService
使用此服务来获取API 使用情况信息，例如在给定日期范围内使用的API 单元量。
LocationCriterionService
返回与指定名称或输入选择器中指定的标准ID 列表匹配的LocationCriterion 常量的服务。请注意，系统不支持按照日期范围过滤。
MediaService
使用此服务管理广告媒体。例如：
●为附加地址信息上传新图片。
●获取要在模板广告中使用的视频的ID。 MutateJobService *
使用MutateJobService 可以将对您的AdWords 广告系列的大批量更新安排为异步批量Mutate 作业，并可以获取您近期所执行作业的状态、结果或统计信息。
如果您希望让应用程序免于主动等待同步响应，则可以使用此服务。在我们异步执行Mutate 时，您的应用程序无法执行其他任务，甚至无法关闭。此服务不应当用于小批量更新。
如果对服务的请求无效，或者违反了作业的任何结构约束，这些请求都会失败，并且无法创建或更新作业（具体取决于所执行的操作）。
ReportDefinitionService
请注意：从v201109 起此服务为只读。不再允许定义新的报告。
报告定义用于描述报告类型、日期范围和要在报告中包含的字段。此外，您可以指定谓词以便过滤要在生成的报告中返回的行。请注意报告下载不支持排序和分页。
ServicedAccountService
可以使用此服务，获取由您的MCC 帐户直接或间接管理的帐户。返回的ServicedAccount 图表中包含所有客户帐户及链接的列表，其中每一个链接都用来说明两个帐户间的关系。
TargetingIdeaService
使用此服务根据选择器中指定的参数生成新的关键字提示和展示位置提示。
您还可以使用此服务检索现有关键字和展示位置的统计信息，方法是将选择器的requestType 设置为RequestType.STATS，并传递相应的搜索参数。
TrafficEstimatorService (v201109)
使用此服务请求所提示的或现有的广告系列、广告组和关键字的流量估算值。
如果只获取一列提示关键字的估算值，请创建一个广告系列估算值请求以及一个使用null ID 的子广告组估算请求，然后将keywordEstimateRequest 设置为包含这些关键字。
●您可以通过设置请求中的广告系列定位选项优化流量估算值。
●所有广告系列估算值请求和广告组估算值请求中的关键字估算值请求最大数量是500。
●所有广告系列估算值请求中的广告组估算值请求最大数量是50。
UserListService (v201109)
将此服务与用户列表定位标准结合使用，可以向过去曾经对您的网站感兴趣的用户展示广告。这种形式的广告称为再营销。
●再营销用户列表包含已经在您的网站上触发了特定转化事件的用户列表。
●逻辑用户列表包含通过逻辑方式将现有用户列表组合起来而构建的用户集。
●外部再营销用户列表包含使用DoubleClick 平台创建的，只面向特定广告客户的用户
列表。
