Ten en cuenta que los métodos get y getByCustomerId de la API de conversiones de Search Ads 360 dejarán de estar disponibles en el tercer trimestre de 2025. Para seguir accediendo a los datos de conversiones, debes crear un informe con el recurso de conversión mediante la nueva API de Search Ads 360 Reporting. Obtén más detalles aquí.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recupera una lista de conversiones de una cuenta de motor de DoubleClick Search con un ID de cliente nuevo de Search Ads 360.
Pruébalo ahora.
Solicitud
Solicitud HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
Parámetros
Nombre del parámetro
Valor
Descripción
Parámetros de ruta de acceso
customerId
string
Nueva cadena de ID de cliente de Search Ads 360 Debe ser una cuenta de cliente.
Parámetros de consulta obligatorios
endDate
integer
Es la fecha más reciente (incluida) en la que se recuperarán las conversiones. El formato es aaaammdd.
Los valores aceptables son 20091101 a 99991231, ambos inclusive.
rowCount
integer
Es la cantidad de conversiones que se generan por llamada.
Los valores aceptables son 1 a 1000, ambos inclusive.
startDate
integer
Primera fecha (incluida) en la que se recuperarán las conversiones. El formato es aaaammdd.
Los valores aceptables son 20091101 a 99991231, ambos inclusive.
startRow
unsigned integer
El índice de inicio basado en 0 para recuperar resultados de conversiones.
Parámetros de consulta opcionales
adGroupId
long
Es el ID numérico del grupo de anuncios.
adId
long
Es el ID numérico del anuncio.
campaignId
long
Es el ID numérico de la campaña.
criterionId
long
Es el ID numérico del criterio.
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
No proporciones un cuerpo de la solicitud con este método.
Respuesta
Si se aplica correctamente, este método muestra un recurso de conversión en el cuerpo de la respuesta.
Pruébalo
Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.
También puedes probar la
independiente
Explorador de aplicaciones.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-08-20 (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)."]]
