Báo cáo về Biến Floodlight tuỳ chỉnh
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.
API Báo cáo Search Ads 360 mới hiện đã ra mắt. API mới cung cấp
linh hoạt hơn nữa trong việc xây dựng các báo cáo tuỳ chỉnh và tích hợp dữ liệu vào các ứng dụng báo cáo
và quy trình. Tìm hiểu thêm về cách di chuyển sang và sử dụng
Báo cáo Search Ads 360 mới
.
Nhà quảng cáo sử dụng biến Floodlight tuỳ chỉnh để báo cáo dữ liệu lượt chuyển đổi
phù hợp với nhu cầu kinh doanh của họ, chẳng hạn như thể loại phim mà người dùng mua, tên
cửa hàng nơi khách hàng mua mặt hàng, phí vận chuyển, v.v. Có thể tải dữ liệu lên
bằng thẻ Floodlight trên trang web của nhà quảng cáo hoặc
bằng API Search Ads 360,
và bạn có thể sử dụng API để tải báo cáo chứa dữ liệu đó xuống.
Tìm hiểu thêm về Floodlight tuỳ chỉnh
các biến trong Search Ads 360.
Chỉ số hoặc phương diện
Trong quá trình thiết lập biến Floodlight tuỳ chỉnh, nhà quảng cáo sẽ sử dụng Search Ads 360
Giao diện người dùng cho biết cách sử dụng từng biến trong báo cáo:
Chỉ số: Trong hầu hết các báo cáo, Search Ads 360 tổng hợp các giá trị của
các biến được xác định dưới dạng chỉ số.
Ví dụ: nhà quảng cáo sử dụng biến Floodlight tuỳ chỉnh để theo dõi phí vận chuyển.
Nếu một người dùng Search Ads 360 xác định biến này là một chỉ số và bạn thêm biến đó vào
trong một báo cáo adGroup
,
bạn sẽ thấy tổng phí vận chuyển liên quan đến từng nhóm quảng cáo trong phạm vi của báo cáo.
Trong conversion
báo cáo lượt chuyển đổi, Search Ads 360 sẽ cung cấp dữ liệu thô về từng lượt chuyển đổi riêng lẻ thay vì dữ liệu tổng hợp.
Lưu ý: Chỉ số tuỳ chỉnh cũng có thể xuất hiện trong
Cột báo cáo Floodlight. Trong
Trong giao diện người dùng của Search Ads 360, người dùng thêm các chỉ số tuỳ chỉnh vào các cột báo cáo Floodlight rồi đưa vào
các cột báo cáo Floodlight trong báo cáo. Bạn cũng có thể thêm những cột Floodlight này
trong yêu cầu báo cáo, cũng giống như bạn có thể thêm bất kỳ loại
cột đã lưu.
Phương diện: Có thể sử dụng những biến được xác định là phương diện để phân đoạn
hầu hết báo cáo.
Ví dụ: một nhà quảng cáo sử dụng biến Floodlight tuỳ chỉnh để theo dõi tên cửa hàng. Sau
một người dùng Search Ads 360 xác định biến này là một phương diện, nên bạn có thể sử dụng biến này để phân đoạn
adGroup
báo cáo và
xem số lượt mua hàng từ mỗi cửa hàng được phân bổ cho quảng cáo trong nhóm quảng cáo.
Trong conversion
báo cáo của bạn, Search Ads 360 sẽ cung cấp dữ liệu thô về từng lượt chuyển đổi riêng lẻ thay vì
dữ liệu tổng hợp. Vì vậy, khi bạn thêm một phương diện tuỳ chỉnh vào báo cáo conversion
,
bạn sẽ thấy giá trị thứ nguyên. Tiếp tục ví dụ từ đoạn trước, nếu bạn
phân đoạn báo cáo conversion
theo phương diện tuỳ chỉnh storeName, bạn sẽ thấy
tên của cửa hàng nơi diễn ra từng giao dịch mua cụ thể.
Lưu ý: Khi người dùng Search Ads 360 xác định một
Cột báo cáo Floodlight
Có thể sử dụng phương diện tuỳ chỉnh làm bộ lọc, nên cột này chỉ báo cáo những lượt chuyển đổi
đã ghi lại một giá trị thứ nguyên cụ thể.
Đưa chỉ số tuỳ chỉnh vào yêu cầu báo cáo
Cách đưa chỉ số tuỳ chỉnh vào yêu cầu báo cáo:
Sau đó, trong yêu cầu báo cáo, hãy cung cấp:
Ví dụ: nếu nhà quảng cáo tạo chỉ số tuỳ chỉnh có tên shippingCost,
đưa thuộc tính phí vận chuyển customMetricName
vào báo cáo:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
Phân đoạn báo cáo theo phương diện tuỳ chỉnh
Cách phân đoạn báo cáo theo phương diện tuỳ chỉnh:
Bạn cần biết tên thân thiện
được chỉ định khi thuộc tính tùy chỉnh
Biến Floodlight được tạo trong Campaign Manager.
Tên thân thiện cũng xuất hiện trong giao diện người dùng Search Ads 360 khi thiết lập
phương diện và chỉ số tuỳ chỉnh.
Phạm vi của báo cáo phải là một nhà quảng cáo cụ thể
hoặc thấp hơn.
-
Mỗi yêu cầu báo cáo chỉ có thể chỉ định một phương diện tuỳ chỉnh. Tuy nhiên,
yêu cầu có thể bao gồm
phân khúc không tuỳ chỉnh bổ sung.
Ví dụ: bạn có thể phân đoạn báo cáo theo phương diện tuỳ chỉnh storeName và
theo phân khúc không tuỳ chỉnh theo quý và theo thiết bị. Xin lưu ý rằng số lượng hàng có thể
sẽ tăng theo cấp số nhân khi mỗi phân đoạn bổ sung.
Sau đó, trong yêu cầu báo cáo, hãy cung cấp:
Ví dụ: nếu một nhà quảng cáo tạo phương diện tuỳ chỉnh có tên storeName,
bao gồm storeName customDimensionName
trong báo cáo để phân đoạn các chỉ số theo tên cửa hàng:
{
"reportScope": {
"agencyId": "20700000000000123", // Replace with your IDs
"advertiserId": "2170000012345" // Replace with your IDs
},
"reportType": "campaign",
"columns": [
{ "columnName": "campaignId" },
{ "columnName": "clicks" },
{ "columnName": "cost" },
{ "columnName": "dfaRevenue"},
{
"customDimensionName": "storeName",
"platformSource": "floodlight"
}
],
...
}
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-08-20 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-08-20 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables allow advertisers to report unique conversion data like product details or shipping costs.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables can be defined as metrics (aggregated values) or dimensions (report segmentation).\u003c/p\u003e\n"],["\u003cp\u003eTo include custom metrics in reports, use the \u003ccode\u003ecustomMetricName\u003c/code\u003e and \u003ccode\u003eplatformSource: floodlight\u003c/code\u003e in your request.\u003c/p\u003e\n"],["\u003cp\u003eTo segment reports by a custom dimension, use the \u003ccode\u003ecustomDimensionName\u003c/code\u003e and \u003ccode\u003eplatformSource: floodlight\u003c/code\u003e while limiting to one custom dimension per request.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows building custom reports and integrating data into reporting applications. Advertisers can use custom Floodlight variables for unique conversion data. These variables can be defined as metrics (aggregated data) or dimensions (segmentation). To include custom metrics, specify the friendly name and set the platform source to \"floodlight\" in the report request. Similarly, segmenting by a custom dimension requires specifying its friendly name and \"floodlight\" as the platform source. Only one custom dimension is allowed per report request.\n"],null,["# Report on Custom Floodlight Variables\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\n\n\nAdvertisers use **custom Floodlight variables** to report conversion data that is\nunique to their business needs, such as the genre of a movie that a user purchases, the name\nof the store from which an item is purchased, shipping costs, and so on. The data can be uploaded\nby a Floodlight tag on the advertiser's site or\n[by the Search Ads 360 API](/search-ads/v2/how-tos/conversions/custom-data),\nand you can use the API to download reports that contain the data.\n\n\n[Learn more](https://support.google.com/searchads/answer/4397154) about custom Floodlight\nvariables in Search Ads 360.\n\n### Metric or dimension\n\nAs part of setting up custom Floodlight variables, an advertiser uses the Search Ads 360\nUI to indicate how each variable can be used in reports:\n\n-\n **Metric** : In most reports, Search Ads 360 aggregates the values of\n variables that are defined as metrics. \n\n For example, an advertiser uses a custom Floodlight variable to track shipping costs.\n If a Search Ads 360 user defines this variable as a metric and you include the variable\n in an [`adGroup`](/search-ads/v2/report-types/adGroup) report,\n you'll see the total shipping costs associated with each ad group in the report's scope.\n\n\n In the [`conversion`](/search-ads/v2/report-types/conversion)\n report, Search Ads 360 provides raw data about individual conversions instead of aggregated data.\n\n Note: Custom metrics can also appear in\n [Floodlight reporting columns](https://support.google.com/searchads/answer/6024745). In the\n Search Ads 360 UI, users add custom metrics to Floodlight reporting columns and then include\n the Floodlight reporting columns in reports. You can also include these Floodlight columns\n in a report request, just as you can include any other type of\n [saved column](/search-ads/v2/how-tos/reporting/saved-columns).\n-\n **Dimension** : Variables that are defined as dimensions can be used to segment\n most reports. \n\n For example, an advertiser uses a custom Floodlight variable to track store names. After\n a Search Ads 360 user defines this variable as a dimension, you can use it to segment an\n [`adGroup`](/search-ads/v2/report-types/adGroup) report and\n see the number of purchases from each store that are attributed to ads in the ad group.\n\n\n In the [`conversion`](/search-ads/v2/report-types/conversion)\n report, Search Ads 360 provides raw data about individual conversions instead of\n aggregated data. So when you add a custom dimension to the `conversion` report,\n you'll see the dimension value. Continuing the example from the previous paragraph, if you\n segment a `conversion` report by the storeName custom dimension, you'll see\n the name of the store in which each specific purchase occurred.\n\n\n Note: When Search Ads 360 users define a\n [Floodlight reporting column](https://support.google.com/searchads/answer/6024721), they\n can use custom dimensions as a filter so the column reports only the conversions that\n recorded a specific dimension value.\n\n### Include custom metrics in a report request\n\nTo include custom metrics in a report request:\n\n-\n You'll need to know the **friendly** name that was\n specified when the\n [custom\n Floodlight variable was created in Campaign Manager](https://support.google.com/dcm/answer/2823222#customvar).\n The friendly name also appears in the Search Ads 360 UI when\n [setting up\n custom dimensions and metrics](https://support.google.com/searchads/answer/6024747#set-up).\n\n-\n The scope of the report needs to be a specific advertiser or lower.\n\nThen in a report request, include:\n\n-\n [`customMetricName`](/search-ads/v2/reference/reports#request.columns.customMetricName): Specifies the friendly name of the custom metric.\n\n The custom metric name is case sensitive.\n\n-\n [`platformSource`](/search-ads/v2/reference/reports#request.columns.platformSource): Always set this to **floodlight**.\n\n\nFor example if an advertiser created a custom metric named **shippingCost** ,\ninclude the shippingCost `customMetricName` in a report: \n\n```text\n{\n \"reportScope\": {\n \"agencyId\": \"12300000000000456\", // Replace with your ID\n \"advertiserId\": \"21700000000011523\", // Replace with your ID\n },\n ...\n \"columns\": [\n {\n \"customMetricName\": \"shippingCost\",\n \"platformSource\": \"floodlight\"\n }\n ],\n ...\n}\n \n```\n\n### Segment a report by a custom dimension\n\nTo segment a report by a custom dimension:\n\n-\n You'll need to know the **friendly** name that was\n specified when the [custom\n Floodlight variable was created in Campaign Manager](https://support.google.com/dcm/partners/answer/2823222#customvar).\n The friendly name also appears in the Search Ads 360 UI when setting up\n custom dimensions and metrics.\n\n- The scope of the report needs to be a specific advertiser\n or lower.\n\n- Each report request can only specify **one** custom dimension. But the\n request can include [additional non-custom segments](/search-ads/v2/how-tos/reporting/segmented-reports#multiple). \n\n For example, you can segment a report by the storeName custom dimension **and**\n by the quarter and device non-custom segments. Just be aware that the number of rows could\n increase exponentially with each additional segment.\n\nThen in a report request, include:\n\n-\n [`customDimensionName`](/search-ads/v2/reference/reports#request.columns.customDimensionName): Specifies the friendly name of the custom dimension.\n\n The custom dimension name is case sensitive.\n\n-\n [`platformSource`](/search-ads/v2/reference/reports#request.columns.platformSource): Always set this to **floodlight**.\n\n\nFor example if an advertiser created a custom dimension named **storeName** ,\ninclude the storeName `customDimensionName` in a report to segment metrics by store name: \n\n```text\n{\n \"reportScope\": {\n \"agencyId\": \"20700000000000123\", // Replace with your IDs\n \"advertiserId\": \"2170000012345\" // Replace with your IDs\n },\n \"reportType\": \"campaign\",\n\n \"columns\": [\n { \"columnName\": \"campaignId\" },\n { \"columnName\": \"clicks\" },\n { \"columnName\": \"cost\" },\n { \"columnName\": \"dfaRevenue\"},\n\n {\n \"customDimensionName\": \"storeName\",\n \"platformSource\": \"floodlight\"\n }\n ],\n ...\n}\n \n```"]]