新版 Search Ads
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
新版 Search Ads 360 会为用户账号、广告系列、广告组、关键字(条件)和广告分配新的 ID。以下是这类 ID 的另外两项行为变更:
现在,Conversion API 在接受代理机构 ID、广告客户 ID 和引擎账号 ID 的任何位置都接受新的 Search Ads 360 客户 ID。如果您指定了客户 API,该 API 会预期广告系列 ID、广告组 ID、关键字 ID 和广告 ID 是新的 Search Ads 360 ID。
使用新版 Search Ads 360 关键字 ID 或广告 ID 时,每当请求使用关键字 ID 或广告 ID 时,您都必须指定关联的广告系列 ID 和广告组 ID。
如果您在请求中使用新的 Search Ads 360 ID,则响应中也会使用新的 Search Ads 360 ID。
插入/更新转化
我们支持使用新版 Search Ads 360 ID 发出以下请求:
- 仅将转化归因于某个关键字
- 更新转化,并指定转化的
criterionId
(关键字 ID)
端点仍然不变。您应在每个转化资源中提供新的 Search Ads 360 ID:您应提供 customerId
,而不是设置 agencyId
、advertiserId
和 engineAccountId
,并在必要时在 campaignId
、adGroupId
、criterionId
和 adId
中使用新的 Search Ads 360 ID。
以下请求示例展示了如何使用新版 Search Ads 360 ID 将转化归因于关键字。
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
{
"conversion" : [
{
"customerId": "123-123-1234"
"campaignId": "10000001",
"adGroupId": "20000001",
"criterionId": "30000001",
"conversionId": "floodlight conversion ID 1",
"conversionTimestamp": "1660799917714",
"type": "ACTION",
"quantityMillis": "1000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test"
}
]
}
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-05-26。
[null,null,["最后更新时间 (UTC):2025-05-26。"],[[["\u003cp\u003eSearch Ads 360 is updated to assign globally unique customer IDs to manager, sub-manager, and client accounts and no longer assigns unique IDs to keywords and ads.\u003c/p\u003e\n"],["\u003cp\u003eThe Conversion API now accepts new Search Ads 360 customer IDs and expects new Search Ads 360 IDs for campaign, ad group, keyword, and ad IDs when specified.\u003c/p\u003e\n"],["\u003cp\u003eWhen using new Search Ads 360 keyword or ad IDs, the associated campaign and ad group IDs must be provided.\u003c/p\u003e\n"],["\u003cp\u003eThere's a new endpoint for listing conversions using the new Search Ads 360 IDs, requiring a client account customer ID.\u003c/p\u003e\n"],["\u003cp\u003eInserting or updating conversions supports attributing to keywords or updating existing conversions with new Search Ads 360 IDs by providing \u003ccode\u003ecustomerId\u003c/code\u003e and relevant IDs.\u003c/p\u003e\n"]]],["New Search Ads 360 assigns unique customer IDs to accounts and updates ID behavior for campaigns, ad groups, keywords, and ads. The Conversion API now accepts these new customer IDs. When a customer ID is provided, new Search Ads 360 IDs are expected for other IDs. Keyword and ad IDs require associated campaign and ad group IDs in requests. Responses will use the new IDs. There's a new endpoint for listing conversions, using the customer ID with the same parameters. Attributing or updating a conversion to a keyword is done with the customer ID.\n"],null,["# New Search Ads 360\n\nThe new Search Ads 360 assigns new IDs to user accounts, campaigns, ad groups,\nkeywords (criteria), and ads. There are two additional behavior changes for these IDs:\n\n-\n The new Search Ads 360 assigns a globally unique customer ID to manager, sub-manager,\n and client accounts, formally known as agencies, advertisers and engine accounts,\n respectively.\n\n-\n The new Search Ads 360 no longer assigns unique IDs to keywords and ads.\n\n\nThe conversion API now accepts new Search Ads 360 customer IDs wherever agency ID,\nadvertiser ID, and engine account IDs are accepted. If you specify a customer API, the API\nexpects campaign ID, ad group ID, keyword ID, and ad ID to be new Search Ads 360 IDs.\nWhen using new Search Ads 360 keyword or ad IDs, you must specify the associated\ncampaign and ad group IDs whenever your request uses a keyword or ad ID.\n\n\nWhen you use a new Search Ads 360 ID in your request, the response will also use\nthe new Search Ads 360 IDs.\n\nInsert/update conversion\n------------------------\n\nWe support the following request using the new Search Ads 360 ID:\n\n- Attribute a conversion to a keyword only\n- Update conversion with the conversion's `criterionId` (keyword ID) specified\n\n\nThe endpoints are still the same. You should provide the new Search Ads 360\nID in each conversion resource: Instead of setting `agencyId`,\n`advertiserId` and `engineAccountId`, you should provide\n`customerId`, and use the new Search Ads 360 ID in\n`campaignId`, `adGroupId`, `criterionId`,\n`adId` when necessary.\n\n\nHere is the example request of how to use the new Search Ads 360 ID to\nattribute a conversion to a keyword. \n\n```carbon\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion\n{\n \"conversion\" : [\n {\n \"customerId\": \"123-123-1234\"\n \"campaignId\": \"10000001\",\n \"adGroupId\": \"20000001\",\n \"criterionId\": \"30000001\",\n \"conversionId\": \"floodlight conversion ID 1\",\n \"conversionTimestamp\": \"1660799917714\",\n \"type\": \"ACTION\",\n \"quantityMillis\": \"1000\",\n \"segmentationType\": \"FLOODLIGHT\",\n \"segmentationName\": \"Test\"\n }\n ]\n}\n \n```"]]