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.
Đối với lượt chuyển đổi ngoại tuyến, nhà quảng cáo cung cấp mã này. Nhà quảng cáo có thể chỉ định bất kỳ mã nhận dạng nào có ý nghĩa đối với họ. Mỗi lượt chuyển đổi trong một yêu cầu phải chỉ định một mã nhận dạng duy nhất, đồng thời tổ hợp mã nhận dạng và dấu thời gian phải là duy nhất trong số tất cả lượt chuyển đổi của nhà quảng cáo đó. Đối với lượt chuyển đổi trực tuyến, DS sẽ sao chép dsConversionId hoặc floodlightOrderId vào tài sản này, tuỳ thuộc vào chỉ dẫn Floodlight của nhà quảng cáo.
conversion[].conversionTimestamp
unsigned long
Thời gian diễn ra lượt chuyển đổi, tính theo thời gian bắt đầu của hệ thống (mili giây) UTC.
conversion[].segmentationType
string
Loại phân đoạn của lượt chuyển đổi này (ví dụ: FLOODLIGHT).
Hãy sử dụng APIs Explorer (Trình khám phá API) bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.
Ngoài ra, hãy thử
độc lập
Trình khám phá.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2024-08-20 UTC."],[[["\u003cp\u003eInserts a batch of new conversions into DoubleClick Search using the provided Conversion resource and requires authorization with the \u003ccode\u003edoubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eEach conversion requires a unique ID, timestamp, and segmentation type (e.g., FLOODLIGHT).\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a Conversion resource in the response body.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows insertion of both offline and online conversions, with specific ID handling for each.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can test the method using the provided APIs Explorer or the standalone Explorer.\u003c/p\u003e\n"]]],["This outlines how to insert new conversions into DoubleClick Search using a POST request to the specified endpoint. Authorization with the `https://www.googleapis.com/auth/doubleclicksearch` scope is required. The request body should include a Conversion resource containing properties like `conversionId` (unique identifier), `conversionTimestamp` (time of conversion in UTC), and `segmentationType` (e.g., `FLOODLIGHT`). Successful requests return a Conversion resource in the response body.\n"],null,["# Conversion: insert\n\n| **Note:** Requires [authorization](#auth).\n\nInserts a batch of new conversions into DoubleClick Search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion\n```\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Conversion resource](/search-ads/v2/reference/conversion#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| **Required Properties** ||||\n| conversion[].`conversionId` | `string` | For offline conversions, advertisers provide this ID. Advertisers can specify any ID that is meaningful to them. Each conversion in a request must specify a unique ID, and the combination of ID and timestamp must be unique amongst all conversions within the advertiser. For online conversions, DS copies the `dsConversionId` or `floodlightOrderId` into this property depending on the advertiser's Floodlight instructions. | |\n| conversion[].`conversionTimestamp` | `unsigned long` | The time at which the conversion took place, in epoch millis UTC. | |\n| conversion[].`segmentationType` | `string` | The segmentation type of this conversion (for example, `FLOODLIGHT`). \u003cbr /\u003e Acceptable values are: - \"`FLOODLIGHT`\" | |\n\nResponse\n--------\n\nIf successful, this method returns a [Conversion resource](/search-ads/v2/reference/conversion#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.conversion.insert)."]]
