Search Ads 360 Reporting API cũ đã ngừng hoạt động. Giờ đây, bạn có thể tạo báo cáo bằng API Báo cáo Search Ads 360 mới.
Xin lưu ý rằng các phương thức get và getByCustomerId trong Search Ads 360 Conversion API sẽ ngừng hoạt động trong quý 3 năm 2025. Để tiếp tục truy cập vào dữ liệu lượt chuyển đổi, bạn phải tạo báo cáo bằng tài nguyên lượt chuyển đổi thông qua Search Ads 360 Reporting API mới. Xem thêm thông tin chi tiết tại đây.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Khi khách hàng hoàn tất một hành động được xác định trước trên trang web của nhà quảng cáo, chẳng hạn như mua một mặt hàng hoặc yêu cầu thêm thông tin, Search Ads 360 sẽ báo cáo một lượt chuyển đổi.
Đối với một số nhà quảng cáo, lượt chuyển đổi bắt đầu trực tuyến và kết thúc ngoại tuyến. Ví dụ: một người tiêu dùng bắt đầu tìm hiểu trên mạng để mua hàng, nhấp vào quảng cáo rồi sau đó gọi đến tổng đài để hoàn tất việc mua hàng. Hoặc một người tiêu dùng có điện thoại thông minh nhấn vào nút "gọi ngay" trong quảng cáo rồi mua hàng qua điện thoại. Đối với những lượt chuyển đổi này, Search Ads 360 sẽ tự động có dữ liệu về phần trực tuyến. Nếu muốn cung cấp dữ liệu về phần ngoại tuyến (để cải thiện báo cáo, sử dụng trong quy tắc tự động hoặc để tối ưu hoá trong chiến lược giá thầu), bạn có thể tải dữ liệu đó lên Search Ads 360.
Trong một số trường hợp, bạn có thể cần sửa đổi giá trị của một lượt chuyển đổi hiện có. Ví dụ: bạn có thể chỉnh sửa giá trị lượt chuyển đổi để tính đến các khoản chiết khấu được áp dụng sau khi người dùng mua hàng trực tuyến (chẳng hạn như chiết khấu qua thư), hàng trả lại có kèm phí nhập lại hàng hoặc các khoản tín dụng được áp dụng sau khi mua hàng.
Tất cả yêu cầu chuyển đổi đều là yêu cầu đồng bộ. Bạn có thể thực hiện các yêu cầu đồng bộ song song (tối đa theo hạn mức của dự án) trong một ứng dụng.
Mã nhận dạng và lượt chuyển đổi trên Search Ads 360
Vì lượt chuyển đổi cần được phân bổ cho một chiến dịch, quảng cáo, từ khoá cụ thể và không bắt buộc là cho một lượt truy cập, nên mỗi lượt chuyển đổi đều chỉ định mã nhận dạng Search Ads 360 của một quảng cáo, từ khoá và chiến dịch, cùng với mã nhận dạng của các đối tượng mẹ trong hệ thống phân cấp Search Ads 360.
Khi nhận, thêm hoặc cập nhật một lượt chuyển đổi, bạn cần chỉ định hầu hết các mã nhận dạng này trong yêu cầu.
Lấy mã nhận dạng Search Ads 360
Để tìm các mã này, hãy làm theo một trong những cách sau:
Sử dụng giao diện người dùng của Search Ads 360 để tải báo cáo xuống. Báo cáo này chứa mã nhận dạng của nhà quảng cáo, tài khoản công cụ, chiến dịch, nhóm quảng cáo, từ khoá và quảng cáo.
Thêm macro Search Ads 360 (chẳng hạn như CampaignID và TrackerID) vào URL trang đích. Khi khách hàng nhấp vào quảng cáo, mỗi macro sẽ hướng dẫn Search Ads 360 truyền mã nhận dạng của macro đó đến trang đích của nhà quảng cáo dưới dạng tham số URL.
Bạn có thể truy xuất các mã nhận dạng này từ nhật ký web của nhà quảng cáo và sử dụng chúng trong các yêu cầu Conversion.
Search Ads 360 cung cấp một số macro để gửi mã từ khoá đến trang đích. Để phân bổ lượt chuyển đổi cho một từ khoá, bạn cần thêm macro TrackerID vào URL trang đích.
Mã lượt nhấp
Giá trị nhận dạng lượt nhấp theo dõi một lượt nhấp vào quảng cáo và bạn có thể sử dụng giá trị này để phân bổ lượt chuyển đổi cho một lượt truy cập cụ thể thay vì cung cấp toàn bộ hệ thống phân cấp giá trị nhận dạng cho các đối tượng Search Ads 360. Search Ads 360 sẽ sử dụng giá trị nhận dạng lượt nhấp để tìm và phân bổ từ khoá cũng như quảng cáo phù hợp.
Mã lượt nhấp có phân biệt chữ hoa chữ thường, vì vậy hãy đảm bảo nhật ký web và phần mềm theo dõi của bạn không thay đổi cách viết hoa của mã lượt nhấp.
Tạo giá trị nhận dạng lượt nhấp
Search Ads 360 hoặc Google Ads sẽ tạo mã lượt nhấp.
Nếu bạn bật tính năng tự động gắn thẻ trong một tài khoản Google Ads, thì Google Ads sẽ tạo giá trị nhận dạng lượt nhấp khi một quảng cáo hiển thị. Do đó, nếu người dùng nhấp vào một lần hiển thị quảng cáo cụ thể nhiều lần, thì những lần nhấp đó sẽ chỉ được liên kết với một giá trị nhận dạng lần nhấp. Những lượt truy cập vào trang đích cho cùng một lượt hiển thị sẽ có cùng giá trị nhận dạng lượt nhấp.
Search Ads 360 có thể tạo mã lượt nhấp nếu bạn
kích hoạt dịch vụ API chuyển đổi. Nếu một lượt nhấp được chuyển hướng từ Google Ads và Google Ads đã tạo mã lượt nhấp, thì Search Ads 360 sẽ sử dụng mã lượt nhấp của Google Ads thay vì tạo mã lượt nhấp mới. Nếu một lượt nhấp được chuyển hướng từ một loại công cụ được hỗ trợ khác, thì Search Ads 360 sẽ tạo giá trị nhận dạng.
Thông số mã lượt nhấp
Mỗi mã nhận dạng lượt nhấp bao gồm 2 tham số. Ví dụ:
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
Tham số gclid chứa một mã nhận dạng có phân biệt chữ hoa chữ thường cho lượt nhấp. Search Ads 360 duy trì thông tin phân bổ (chẳng hạn như từ khoá, quảng cáo, chiến dịch, nhóm quảng cáo) cho từng mã lượt nhấp được tạo.
Tham số gclsrc cho biết nguồn của mã lượt nhấp. Hiện tại, giá trị này có thể là một trong những giá trị sau:
gclsrc=ds: mã lượt nhấp do Search Ads 360 tạo. Ngoài ra, lượt nhấp đó là trên một công cụ khác ngoài Google, hoặc lượt nhấp đó là trên Google nhưng tài khoản Google Ads không sử dụng tính năng tự động gắn thẻ.
gclsrc=aw.ds: giá trị nhận dạng lượt nhấp do Google Ads tạo bằng tính năng tự động gắn thẻ và lượt nhấp đã được chuyển qua máy chủ lượt nhấp của Search Ads 360.
gclsrc=: thông số này trống nếu giá trị nhận dạng lượt nhấp do Google Ads tạo, nhưng dịch vụ API chuyển đổi không được bật trong Search Ads 360 khi lượt nhấp xảy ra.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eSearch Ads 360 reports a conversion when a customer completes a pre-defined action on an advertiser's website, such as purchasing an item or requesting information.\u003c/p\u003e\n"],["\u003cp\u003eYou can upload offline conversion data to Search Ads 360 to enhance reports, use in automated rules, or for bid strategy optimization.\u003c/p\u003e\n"],["\u003cp\u003eConversion values can be modified to account for factors like discounts, returns, or credits applied after a purchase.\u003c/p\u003e\n"],["\u003cp\u003eThe Search Ads 360 API allows you to get, insert, and update conversions, but it cannot be used to send personally identifiable information or for advertising targeting.\u003c/p\u003e\n"],["\u003cp\u003eTo attribute conversions, each conversion needs to specify the Search Ads 360 ID of an ad, keyword, and campaign, or utilize a click ID to track the click and attribute accordingly.\u003c/p\u003e\n"]]],["Search Ads 360 reports a conversion when a customer completes a specified action. Advertisers can upload offline conversion data to enhance reports and optimize bid strategies. The Search Ads 360 API allows getting, adding, and updating conversions. Conversions require Search Ads 360 IDs of relevant entities or a click ID to attribute to specific ads. Click IDs, generated by either Search Ads 360 or Google Ads, track ad clicks. Advertisers should maintain the click ID case from the landing page.\n"],null,["# Upload Data About Conversions\n\nWhen a customer completes a pre-defined action on an advertiser's website, such as\npurchasing an item or requesting more information, Search Ads 360 reports a **conversion**.\n\nConversions for some advertisers start online and finish offline. For example, a\nconsumer initiates research online for a purchase, clicks on an ad, and then telephones a\ncall center to complete the purchase. Or a consumer with a smartphone taps a \"call now\"\nbutton in an ad and purchases an item over the telephone. For these conversions,\nSearch Ads 360 will automatically have data about the online portion. If you want to\nprovide data about the offline portion---to enhance reports, for use in automated\nrules, or for optimization in a bid strategy---you can upload it to Search Ads 360.\n\nIn some cases, you might need to modify the value of an existing conversion. For\nexample, you might edit a conversion value to account for discounts that were applied\nafter an online purchase was made (such as a mail-in-rebate), returns that occurred with\na restocking fee, or credits that were applied after the purchase.\n\n\nAfter you've set up your client app as described in [My First App](/search-ads/v2/first-app) (including [activating the\nconversion service](/search-ads/v2/prereqs#activate-conversion-service)), you can send the following conversion-related requests to the\nSearch Ads 360 API:\n\n\n[Insert](/search-ads/v2/how-tos/conversions/insert)\n\n:\n Adds new conversions.\n\n\n[Update](/search-ads/v2/how-tos/conversions/update)\n\n: Modifies existing conversions.\n\n| **Advertisers are prohibited** from using the Search Ads 360 API to send personally identifiable information, as outlined by the [Terms of Service](/search-ads/terms) for the API. Further, this API provides no ability to target advertising. The conversion data is used by advertisers to better manage and report on the amount they pay for advertising and the ROI they get from it.\n\n### Synchronous Requests\n\nAll conversion requests are synchronous. You can make parallel synchronous requests (up to your project's limit) in a single client.\n\nSearch Ads 360 IDs and Conversions\n----------------------------------\n\n\nBecause conversions need to be attributed to a specific campaign, ad, keyword, and\noptionally to a visit, each conversion specifies the Search Ads 360 ID of an ad,\nkeyword, and campaign, along with the IDs of the parent objects in the [Search Ads 360 hierarchy](https://support.google.com/searchads/answer/2491240).\nWhen you get, add, or update a conversion, you'll need to specify most of these IDs in\nthe request.\n\n### Obtaining Search Ads 360 IDs\n\nTo find these IDs, do any of the following:\n\n-\n Use the Search Ads 360 UI to [download\n a report](https://support.google.com/searchads/answer/1184146) that contains IDs for the advertiser, engine accounts, campaigns, ad\n groups, keywords, and ads.\n\n-\n [Add\n Search Ads 360 macros](https://support.google.com/searchads/answer/1649566#macros) such as `CampaignID` and `TrackerID`\n to your landing page URLs. When a customer clicks an ad, each macro will instruct\n Search Ads 360 to pass its ID to the advertiser's landing page as URL parameter.\n You can retrieve these IDs from the advertiser's web logs and use them in your `Conversion`\n requests.\n\n\n Search Ads 360 provides a few different macros for sending keyword IDs to a landing\n page. To attribute conversions to a keyword, you'll need to add the **TrackerID**\n macro to the landing page URLs.\n\n### Click IDs\n\nA **click ID** tracks a click on an ad, and you can use it to attribute a\nconversion to a specific visit instead of providing the entire hierarchy of IDs for\nSearch Ads 360 objects. Search Ads 360 will use the click ID to find and attribute the\nappropriate keyword and ad.\n\nClick IDs are case-sensitive, so **make sure your web logs and tracking software\ndo not change the case of the click ID**.\n\n#### Generating a Click ID\n\nEither Search Ads 360 or Google Ads generates the click ID.\n\nIf [auto-tagging](https://support.google.com/google-ads/answer/3095550) is enabled\nin an Google Ads account, Google Ads generates a click ID when an ad is shown. As a result, if a\nuser clicks on a particular ad impression multiple times, those clicks will be associated\nwith only one click ID. Landing page visits for the exact same impression will share the\nsame click ID.\n\nSearch Ads 360 can generate a click ID if you [activate the conversion API service](https://support.google.com/searchads/answer/2604604#activate). If a click is redirected from Google Ads and Google Ads has\nalready generated a click ID, Search Ads 360 uses the Google Ads ID instead of generating a new one. If a\nclick is redirected from another type of supported engine, Search Ads 360 generates the ID.\n\n#### Click ID Parameters\n\nEach click ID consists of two parameters. For example: \n\n```\ngclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds\n```\n\n\nThe `gclid` parameter contains a case-sensitive ID for the click. Search Ads 360\nmaintains the attribution information (such as keyword, ad, campaign, ad group) for\neach click ID generated.\n\n\nThe `gclsrc` parameter indicates the source of the click ID. Currently, it\ncan have one of the following values:\n\n-\n `gclsrc=ds`: the click ID was generated by Search Ads 360. In addition, the\n click was either on an engine other than Google, or the click was on Google but the\n Google Ads account is not using auto-tagging.\n\n-\n `gclsrc=aw.ds`: the click ID was generated by Google Ads that is using\n auto-tagging, and the click went through the Search Ads 360 clickserver.\n\n-\n `gclsrc=`: the parameter is empty if the click ID was generated by Google Ads,\n but the conversion API service was not enabled in Search Ads 360 when the click occurred.\n\n| **Tip**: We recommend you use the landing page of the website to keep track of the customer's offline contact information (such as phone number called) together with the click ID. When an offline conversion happens, the click ID can then be used to report the conversion back to Search Ads 360."]]
