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.
Theo mặc định, lượt chuyển đổi sẽ chứa lượng dữ liệu mô tả hạn chế, chẳng hạn như thời gian
đã xảy ra chuyển đổi, nguồn chuyển đổi và giá trị tiền tệ (không bắt buộc). Nếu bạn
thu thập thêm dữ liệu về các lượt chuyển đổi của bạn, chẳng hạn như quốc gia nơi mặt hàng được mua
được vận chuyển, mã sản phẩm hay thậm chí là thời lượng của một cuộc gọi điện thoại, bạn có thể sử dụng biến Floodlight tuỳ chỉnh để theo dõi
dữ liệu đó rồi tải lên Search Ads 360.
Sau khi tải dữ liệu lên, bạn có thể:
Tạo các cột báo cáo trong Search Ads 360 để hiển thị dữ liệu hoặc dùng dữ liệu đó để
lọc cột Floodlight.
Sử dụng dữ liệu trong các cột công thức.
Sử dụng dữ liệu này để phân đoạn và nhóm các báo cáo.
Mỗi biến được gán một tên thân thiện, là tên duy nhất cho một biến cụ thể
nhà quảng cáo và một trong các loại dữ liệu sau:
Chỉ số: Dữ liệu số mà Search Ads 360 tổng hợp trong báo cáo lượt chuyển đổi. Cho
Ví dụ: bạn có thể dùng các biến chỉ số để theo dõi tổng chi phí vận chuyển hoặc để duy trì
số lượng mặt hàng được mua.
Thứ nguyên: Dữ liệu số hoặc văn bản có thể được sử dụng để lọc dữ liệu trong
báo cáo. Ví dụ: các biến phương diện có thể theo dõi tên cửa hàng hoặc mã sản phẩm dạng số và
sau đó sẽ được dùng trong báo cáo Floodlight
chỉ chứa dữ liệu từ một cửa hàng cụ thể hoặc cho một
của Google.
Tải dữ liệu tuỳ chỉnh lên
Để tải dữ liệu lên cho biến Floodlight tuỳ chỉnh cho chỉ số, hãy thêm phương thức
trường sau đây trong một
Conversion.insert()
hoặc Conversion.update()
yêu cầu:
'customMetric': [
{
'name': 'friendly-name',
'value': Number
},
]
Để tải dữ liệu lên cho biến Floodlight tuỳ chỉnh phương diện, hãy thêm phương thức
trường sau đây trong một
Conversion.insert()
hoặc Conversion.update()
yêu cầu:
Ví dụ: một nhà quảng cáo có các biến Floodlight tuỳ chỉnh sau đây được định cấu hình cho
Search Ads 360:
doanh số bán hàng (chỉ số)
phí vận chuyển (chỉ số)
product_type (phương diện)
product_id (phương diện)
Nếu khách hàng hoàn tất giao dịch mua hàng qua điện thoại, bạn có thể thực hiện những việc sau
Conversion.insert()
yêu cầu tải lượt chuyển đổi lên và bao gồm dữ liệu cho chỉ số tuỳ chỉnh:
POSThttps://www.googleapis.com/doubleclicksearch/v2/conversionAuthorization:BeareryourOAuth2.0accesstokenContent-type:application/json{'kind':'doubleclicksearch#conversionList','conversion':[{'agencyId':'12300000000000456',// Replace with your ID'advertiserId':'78900000000000123',// Replace with your ID'engineAccountId':'101100000000000123',// Replace with your ID'campaignId':'13400000003156701',// Replace with your ID'adGroupId':'58700000128508001',// Replace with your ID'criterionId':'43700001095692142',// Replace with your ID'adId':'0','conversionId':'test_20140121_01','state':'ACTIVE','type':'TRANSACTION','revenueMicros':10000000,// To report $10 of revenue, specify 10 million revenueMicros'currencyCode':'USD','segmentationType':'FLOODLIGHT','segmentationId':'25700000001472562',// Replace with your ID'conversionTimestamp':'1390073000011','floodlightOrderId':'test','customMetric':[{'name':'sales','value':2.0},{'name':'shipping','value':3.0}],'customDimension':[{'name':'product_type','value':'shoes'},{'name':'product_id','value':'shoe2'}]}]}
Xử lý phản hồi của Search Ads 360
Giống như với Conversion.insert() khác
hoặc Conversion.update() yêu cầu,
nếu yêu cầu thành công, thì phản hồi sẽ bao gồm toàn bộ thông tin đại diện nội bộ trong Search Ads 360
cho mỗi lượt chuyển đổi được tải lên.
Nếu yêu cầu không xác thực hoặc tải lên được, thì phản hồi sẽ bao gồm thông báo lỗi.
Để biết thêm thông tin về các thông báo lỗi này, hãy xem bài viết Xử lý
Phản hồi của Search Ads 360 cho các yêu cầu chèn.
[null,null,["Cập nhật lần gần đây nhất: 2024-08-20 UTC."],[[["\u003cp\u003eCustom Floodlight variables allow you to upload additional data about your conversions, such as product details or shipping information, to Search Ads 360.\u003c/p\u003e\n"],["\u003cp\u003eThis uploaded data can be used to create reporting columns, filter reports, build formula columns, segment data, and download reports via the API.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables are configured initially in Campaign Manager and then set up in Search Ads 360 by your customer service contact.\u003c/p\u003e\n"],["\u003cp\u003eEach variable has a friendly name and a data type: "Metric" for numeric, aggregated data, and "Dimension" for filtering and segmenting data.\u003c/p\u003e\n"],["\u003cp\u003eTo upload custom data, use the \u003ccode\u003eConversion.insert()\u003c/code\u003e or \u003ccode\u003eConversion.update()\u003c/code\u003e requests with the appropriate fields for metrics and dimensions, ensuring the variable names match the configuration in Search Ads 360.\u003c/p\u003e\n"]]],["Custom Floodlight variables allow tracking of additional conversion data beyond default information. To use them, set them up in Campaign Manager and Search Ads 360. Variables can be metrics (numeric, aggregated data) or dimensions (text/numeric, filterable data). Upload data via `Conversion.insert()` or `Conversion.update()` requests, including the variable's friendly name and value within `customMetric` or `customDimension` fields. This uploaded data can then be used in Search Ads 360 for reporting, filtering, formula columns, segmentation, and API-driven report downloads.\n"],null,["# Upload Data for Custom Floodlight Variables\n\nBy default, a conversion contains a limited amount of descriptive data, such as the time the\nconversion occurred, the source of the conversion, and optionally a monetary value. If you\ncollect additional data about your conversions, such as the country to which a purchased item\nis shipped, product IDs, or even the duration of a telephone call, you can use [custom Floodlight variables](https://support.google.com/dcm/partner/answer/2823222) to track\nthe data and upload it to Search Ads 360.\n\nAfter you upload the data, you can:\n\n- Create reporting columns in Search Ads 360 to display the data or use it to\n filter a Floodlight column.\n\n- Use the data in formula columns.\n\n- Use the data to segment and group reports.\n\n- Use the Search Ads 360 API to\n [download reports that contain the data](/search-ads/v2/how-tos/reporting/custom-metrics-dimensions).\n\n[Learn more](https://support.google.com/searchads/answer/4397154) about using the\nuploaded data.\n\nSetting up custom Floodlight variables\n--------------------------------------\n\nYou initially set up custom Floodlight variables as part of\n[configuring Floodlight in\nCampaign Manager](https://support.google.com/dcm/partner/answer/2823222). Then, your Search Ads 360 customer service contact will\n[set up the custom\nvariables in Search Ads 360](https://support.google.com/searchads/answer/4397154#setup). After these steps are done, you can specify data\nfor the variables when you add or modify conversions.\n\nVariable name and type\n----------------------\n\nEach variable is assigned a **friendly name** that is unique for a given\nadvertiser and one of the following data types:\n\n- **Metric**: Numeric data that Search Ads 360 aggregates in conversion reports. For\n example, metric variables can be used to keep track of overall shipping costs or to keep\n count of items purchased.\n\n- **Dimension** : Numeric or text data that can be used to filter data in a\n report. For example, dimension variables can track a store name or numeric product ID, and\n then be used in [a Floodlight reporting\n column](https://support.google.com/searchads/answer/2558771) that contains only the data from a specific store or for a specific\n product.\n\nUploading the custom data\n-------------------------\n\nTo upload data for a **metric** custom Floodlight variable, include the\nfollowing field in a\n[`Conversion.insert()`](/search-ads/v2/reference/conversion/insert)\nor [`Conversion.update()`](/search-ads/v2/reference/conversion/update)\nrequest: \n\n```text\n 'customMetric': [\n {\n 'name': 'friendly-name',\n 'value': Number\n },\n ]\n```\n\nTo upload data for a **dimension** custom Floodlight variable, include the\nfollowing field in a\n[`Conversion.insert()`](/search-ads/v2/reference/conversion/insert)\nor [`Conversion.update()`](/search-ads/v2/reference/conversion/update)\nrequest: \n\n```text\n 'customDimension': [\n {\n 'name': 'friendly-name',\n 'value': String\n },\n ]\n```\n| **Important:** Make sure the name you specify in the request matches the name of a custom Floodlight variable as it has been configured in Search Ads 360. Otherwise the request will fail and respond with error message like this: \n| `The request was not valid. Details: [Custom dimension/metric does not exist:\n| Dimension_1]\"`\n\nExample\n-------\n\nFor example, an advertiser has the following custom Floodlight variables configured for\nSearch Ads 360:\n\n- sales (metric)\n- shipping (metric)\n- product_type (dimension)\n- product_id (dimension)\n\nIf a customer completes a purchase over the telephone, you can make the following\n[`Conversion.insert()`](/search-ads/v2/reference/conversion/insert)\nrequest to upload the conversion and include data for the custom metrics: \n\n```carbon\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion\nAuthorization: Bearer your OAuth 2.0 access token\nContent-type: application/json\n\n{\n 'kind': 'doubleclicksearch#conversionList',\n 'conversion' : [{\n 'agencyId': '12300000000000456', // Replace with your ID\n 'advertiserId': '78900000000000123', // Replace with your ID\n 'engineAccountId': '101100000000000123', // Replace with your ID\n 'campaignId': '13400000003156701', // Replace with your ID\n 'adGroupId': '58700000128508001', // Replace with your ID\n 'criterionId': '43700001095692142', // Replace with your ID\n 'adId': '0',\n 'conversionId': 'test_20140121_01',\n 'state': 'ACTIVE',\n 'type': 'TRANSACTION',\n 'revenueMicros': 10000000, // To report $10 of revenue, specify 10 million revenueMicros\n 'currencyCode': 'USD',\n 'segmentationType': 'FLOODLIGHT',\n 'segmentationId': '25700000001472562', // Replace with your ID\n 'conversionTimestamp': '1390073000011',\n 'floodlightOrderId': 'test',\n 'customMetric': [\n {\n 'name': 'sales',\n 'value': 2.0\n },\n {\n 'name': 'shipping',\n 'value': 3.0\n }\n ],\n 'customDimension': [\n {\n 'name': 'product_type',\n 'value': 'shoes'\n },\n {\n 'name': 'product_id',\n 'value': 'shoe 2'\n }\n ]\n }]\n}\n```\n\nHandle Search Ads 360 responses\n-------------------------------\n\nAs with other [`Conversion.insert()`](/search-ads/v2/reference/conversion/insert)\nor [`Conversion.update()`](/search-ads/v2/reference/conversion/update) requests,\nif the request succeeds, the response includes the full Search Ads 360 internal representation\nfor each uploaded conversion.\n\nIf the request fails to validate or upload, the response includes failure messages.\nFor more information about these failure messages, see [Handle\nSearch Ads 360 responses](/search-ads/v2/how-tos/conversions/insert#if-the-request-does-not-succeed) for insert requests."]]