新版 Search Ads 360
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
新版 Search Ads 360 會為使用者帳戶、廣告活動、廣告群組、關鍵字 (條件) 和廣告指派新的 ID。這些 ID 還有兩項行為變更：
轉換 API 現在會在接受代理商 ID、廣告客戶 ID 和引擎帳戶 ID 的任何地方接受新版 Search Ads 360 客戶 ID。如果您指定客戶 API，API 會將廣告活動 ID、廣告群組 ID、關鍵字 ID 和廣告 ID 視為新版 Search Ads 360 ID。使用新版 Search Ads 360 關鍵字或廣告 ID 時，請務必在使用關鍵字或廣告 ID 的請求中指定相關聯的廣告活動和廣告群組 ID。
如果您在要求中使用新版 Search Ads 360 ID，回應也會使用新版 Search Ads 360 ID。
插入/更新轉換
我們支援使用新版 Search Ads 360 ID 提出下列要求：
- 只將轉換歸因於某個關鍵字
- 更新轉換，並指定轉換的
criterionId (關鍵字 ID)
端點仍維持不變。您應在每個轉換資源中提供新版 Search Ads 360 ID：請勿設定 agencyId、advertiserId 和 engineAccountId，而應提供 customerId，並在必要時於 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"
}
]
}
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-05-26 (世界標準時間)。
[null,null,["上次更新時間：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```"]]
