Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Остальные функции API конверсий Search Ads 360 будут по-прежнему поддерживаться.
Conversion: getByCustomerId
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Получает список конверсий из аккаунта поисковой системы DoubleClick с использованием нового идентификатора клиента Search Ads 360. Попробуйте сейчас .
Запрос
HTTP-запрос
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
Параметры
| Имя параметра | Ценить | Описание |
|---|
| Параметры пути |
customerId | string | Новая строка идентификатора клиента Ads 360 для поиска. Должен быть аккаунт клиента. |
| Обязательные параметры запроса |
endDate | integer | Последняя дата (включительно), по которой можно получить данные о конверсиях. Формат: ггггммдд. Допустимые значения: 20091101 до 99991231 включительно. |
rowCount | integer | Количество возвращаемых конверсий за звонок. Допустимые значения: от 1 до 1000 включительно. |
startDate | integer | Первая дата (включительно), по которой необходимо получить данные о конверсиях. Формат: ггггммдд. Допустимые значения: 20091101 до 99991231 включительно. |
startRow | unsigned integer | Начальный индекс, отсчитываемый от 0, для получения результатов конверсий. |
| Необязательные параметры запроса |
adGroupId | long | Числовой идентификатор группы объявлений. |
adId | long | Числовой идентификатор объявления. |
campaignId | long | Числовой идентификатор кампании. |
criterionId | long | Числовой идентификатор критерия. |
Авторизация
Для этого запроса требуется авторизация со следующей областью действия:
| Объем |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
Дополнительную информацию см. на странице аутентификации и авторизации .
Тело запроса
Не предоставляйте тело запроса с помощью этого метода.
Попробуйте!
Используйте API-интерфейс ниже, чтобы вызвать этот метод для реальных данных и просмотреть ответ. Альтернативно попробуйте автономный Проводник .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-08 UTC.
[null,null,["Последнее обновление: 2024-11-08 UTC."],[[["\u003cp\u003eRetrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include specifying date ranges, result limits, and filtering by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe response, if successful, returns a Conversion resource.\u003c/p\u003e\n"],["\u003cp\u003eYou can try this method using the provided APIs Explorer or standalone Explorer.\u003c/p\u003e\n"]]],["This outlines how to retrieve conversion data from a Search Ads 360 account. A `GET` request to a specific URL is required, using the customer ID, start and end dates, number of rows, and a start row. Optional parameters allow filtering by ad group, ad, campaign, or criterion IDs. The request needs authorization using a specified scope. A successful request returns a conversion resource, with the response having no request body.\n"],null,["# Conversion: getByCustomerId\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `customerId` | `string` | New search Ads 360 Customer ID String. Must be a client account. |\n| **Required query parameters** |||\n| `endDate` | `integer` | Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `rowCount` | `integer` | The number of conversions to return per call. Acceptable values are `1` to `1000`, inclusive. |\n| `startDate` | `integer` | First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `startRow` | `unsigned integer` | The 0-based starting index for retrieving conversions results. |\n| **Optional query parameters** |||\n| `adGroupId` | `long` | Numeric ID of the ad group. |\n| `adId` | `long` | Numeric ID of the ad. |\n| `campaignId` | `long` | Numeric ID of the campaign. |\n| `criterionId` | `long` | Numeric ID of the criterion. |\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\nDo not supply a request body with this method.\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.getByCustomerId)."]]
