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.
Cuando un cliente completa una acción predefinida en el sitio web de un anunciante, como comprar un artículo o solicitar más información, Search Ads 360 registra una conversión.
Las conversiones de algunos anunciantes comienzan en línea y finalizan sin conexión. Por ejemplo, un consumidor inicia una investigación en línea para efectuar una compra, hace clic en un anuncio y, a continuación, llama por teléfono a un centro de atención telefónica para completar la compra. O bien un consumidor con un smartphone presiona el botón "Llamar ahora" de un anuncio y compra un artículo por teléfono. Para estas conversiones,
Search Ads 360 obtendrá datos automáticamente sobre la parte en línea. Si deseas proporcionar datos sobre la parte sin conexión para mejorar los informes, usarlos en reglas automáticas o para la optimización en una estrategia de ofertas, puedes subirlos a Search Ads 360.
En algunos casos, es posible que debas modificar el valor de una conversión existente. Por ejemplo, puedes editar un valor de conversión para tener en cuenta los descuentos que se aplicaron después de que se realizó una compra en línea (como un reembolso por correo), las devoluciones que se produjeron con una tarifa de reposición o los créditos que se aplicaron después de la compra.
Después de configurar tu app cliente como se describe en Mi primera app (incluida la activación del servicio de conversiones), puedes enviar las siguientes solicitudes relacionadas con las conversiones a la API de Search Ads 360:
Todas las solicitudes de conversión son síncronas. Puedes realizar solicitudes síncronas paralelas (hasta el límite de tu proyecto) en un solo cliente.
IDs y conversiones de Search Ads 360
Dado que las conversiones deben atribuirse a una campaña, un anuncio, una palabra clave y, de forma opcional, a una visita específicos, cada conversión especifica el ID de Search Ads 360 de un anuncio, una palabra clave y una campaña, junto con los IDs de los objetos principales en la jerarquía de Search Ads 360.
Cuando obtengas, agregues o actualices una conversión, deberás especificar la mayoría de estos IDs en la solicitud.
Cómo obtener IDs de Search Ads 360
Para encontrar estos IDs, haz lo siguiente:
Usa la IU de Search Ads 360 para descargar un informe que contenga los IDs del anunciante, las cuentas de motor, las campañas, los grupos de anuncios, las palabras clave y los anuncios.
Agrega macros de Search Ads 360, como CampaignID y TrackerID, a las URLs de tus páginas de destino. Cuando un cliente haga clic en un anuncio, cada macro le indicará a Search Ads 360 que pase su ID a la página de destino del anunciante como parámetro de URL.
Puedes recuperar estos IDs de los registros web del anunciante y usarlos en tus solicitudes de Conversion.
Search Ads 360 proporciona algunas macros diferentes para enviar IDs de palabras clave a una página de destino. Para atribuir conversiones a una palabra clave, deberás agregar la macro TrackerID a las URLs de la página de destino.
IDs de clic
Un ID de clic hace un seguimiento de un clic en un anuncio y puedes usarlo para atribuir una conversión a una visita específica en lugar de proporcionar toda la jerarquía de IDs para los objetos de Search Ads 360. Search Ads 360 usará el ID de clic para encontrar y atribuir la palabra clave y el anuncio adecuados.
Los IDs de clic distinguen mayúsculas de minúsculas, por lo que debes asegurarte de que tus registros web y el software de seguimiento no cambien las mayúsculas y minúsculas de los IDs de clic.
Cómo generar un ID de clic
Search Ads 360 o Google Ads generan el ID de clic.
Si el etiquetado automático está habilitado en una cuenta de Google Ads, Google Ads genera un ID de clic cuando se muestra un anuncio. En consecuencia, si un
usuario hace clic varias veces en una impresión de anuncio en particular, esos clics se asociarán
con un solo ID de clic. Las visitas a la página de destino para exactamente la misma impresión compartirán el mismo ID de clic.
Search Ads 360 puede generar un ID de clic si
activas el servicio de la API de conversiones. Si se redirecciona un clic desde Google Ads y Google Ads ya generó un ID de clic, Search Ads 360 usará el ID de Google Ads en lugar de generar uno nuevo. Si se redirecciona un clic desde otro tipo de motor compatible, Search Ads 360 genera el ID.
Parámetros de ID de clic
Cada ID de clic consta de dos parámetros. Por ejemplo:
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
El parámetro gclid contiene un ID que distingue mayúsculas de minúsculas para el clic. Search Ads 360 mantiene la información de atribución (como la palabra clave, el anuncio, la campaña y el grupo de anuncios) para cada ID de clic generado.
El parámetro gclsrc indica la fuente del ID de clic. Actualmente, puede tener uno de los siguientes valores:
gclsrc=ds: El ID de clic fue generado por Search Ads 360. Además, el clic se realizó en un motor de búsqueda que no es Google o se realizó en Google, pero la cuenta de Google Ads no utiliza el etiquetado automático.
gclsrc=aw.ds: Google Ads generó el ID de clic con el etiquetado automático, y el clic pasó por el servidor de clics de Search Ads 360.
gclsrc=: El parámetro está vacío si Google Ads generó el ID de clic, pero el servicio de la API de conversiones no estaba habilitado en Search Ads 360 cuando se produjo el clic.
[null,null,["Última actualización: 2025-08-29 (UTC)"],[[["\u003cp\u003eSearch Ads 360 reports a conversion when a customer completes a pre-defined action on an advertiser's website, such as purchasing an item or requesting information.\u003c/p\u003e\n"],["\u003cp\u003eYou can upload offline conversion data to Search Ads 360 to enhance reports, use in automated rules, or for bid strategy optimization.\u003c/p\u003e\n"],["\u003cp\u003eConversion values can be modified to account for factors like discounts, returns, or credits applied after a purchase.\u003c/p\u003e\n"],["\u003cp\u003eThe Search Ads 360 API allows you to get, insert, and update conversions, but it cannot be used to send personally identifiable information or for advertising targeting.\u003c/p\u003e\n"],["\u003cp\u003eTo attribute conversions, each conversion needs to specify the Search Ads 360 ID of an ad, keyword, and campaign, or utilize a click ID to track the click and attribute accordingly.\u003c/p\u003e\n"]]],["Search Ads 360 reports a conversion when a customer completes a specified action. Advertisers can upload offline conversion data to enhance reports and optimize bid strategies. The Search Ads 360 API allows getting, adding, and updating conversions. Conversions require Search Ads 360 IDs of relevant entities or a click ID to attribute to specific ads. Click IDs, generated by either Search Ads 360 or Google Ads, track ad clicks. Advertisers should maintain the click ID case from the landing page.\n"],null,["# Upload Data About Conversions\n\nWhen a customer completes a pre-defined action on an advertiser's website, such as\npurchasing an item or requesting more information, Search Ads 360 reports a **conversion**.\n\nConversions for some advertisers start online and finish offline. For example, a\nconsumer initiates research online for a purchase, clicks on an ad, and then telephones a\ncall center to complete the purchase. Or a consumer with a smartphone taps a \"call now\"\nbutton in an ad and purchases an item over the telephone. For these conversions,\nSearch Ads 360 will automatically have data about the online portion. If you want to\nprovide data about the offline portion---to enhance reports, for use in automated\nrules, or for optimization in a bid strategy---you can upload it to Search Ads 360.\n\nIn some cases, you might need to modify the value of an existing conversion. For\nexample, you might edit a conversion value to account for discounts that were applied\nafter an online purchase was made (such as a mail-in-rebate), returns that occurred with\na restocking fee, or credits that were applied after the purchase.\n\n\nAfter you've set up your client app as described in [My First App](/search-ads/v2/first-app) (including [activating the\nconversion service](/search-ads/v2/prereqs#activate-conversion-service)), you can send the following conversion-related requests to the\nSearch Ads 360 API:\n\n\n[Insert](/search-ads/v2/how-tos/conversions/insert)\n\n:\n Adds new conversions.\n\n\n[Update](/search-ads/v2/how-tos/conversions/update)\n\n: Modifies existing conversions.\n\n| **Advertisers are prohibited** from using the Search Ads 360 API to send personally identifiable information, as outlined by the [Terms of Service](/search-ads/terms) for the API. Further, this API provides no ability to target advertising. The conversion data is used by advertisers to better manage and report on the amount they pay for advertising and the ROI they get from it.\n\n### Synchronous Requests\n\nAll conversion requests are synchronous. You can make parallel synchronous requests (up to your project's limit) in a single client.\n\nSearch Ads 360 IDs and Conversions\n----------------------------------\n\n\nBecause conversions need to be attributed to a specific campaign, ad, keyword, and\noptionally to a visit, each conversion specifies the Search Ads 360 ID of an ad,\nkeyword, and campaign, along with the IDs of the parent objects in the [Search Ads 360 hierarchy](https://support.google.com/searchads/answer/2491240).\nWhen you get, add, or update a conversion, you'll need to specify most of these IDs in\nthe request.\n\n### Obtaining Search Ads 360 IDs\n\nTo find these IDs, do any of the following:\n\n-\n Use the Search Ads 360 UI to [download\n a report](https://support.google.com/searchads/answer/1184146) that contains IDs for the advertiser, engine accounts, campaigns, ad\n groups, keywords, and ads.\n\n-\n [Add\n Search Ads 360 macros](https://support.google.com/searchads/answer/1649566#macros) such as `CampaignID` and `TrackerID`\n to your landing page URLs. When a customer clicks an ad, each macro will instruct\n Search Ads 360 to pass its ID to the advertiser's landing page as URL parameter.\n You can retrieve these IDs from the advertiser's web logs and use them in your `Conversion`\n requests.\n\n\n Search Ads 360 provides a few different macros for sending keyword IDs to a landing\n page. To attribute conversions to a keyword, you'll need to add the **TrackerID**\n macro to the landing page URLs.\n\n### Click IDs\n\nA **click ID** tracks a click on an ad, and you can use it to attribute a\nconversion to a specific visit instead of providing the entire hierarchy of IDs for\nSearch Ads 360 objects. Search Ads 360 will use the click ID to find and attribute the\nappropriate keyword and ad.\n\nClick IDs are case-sensitive, so **make sure your web logs and tracking software\ndo not change the case of the click ID**.\n\n#### Generating a Click ID\n\nEither Search Ads 360 or Google Ads generates the click ID.\n\nIf [auto-tagging](https://support.google.com/google-ads/answer/3095550) is enabled\nin an Google Ads account, Google Ads generates a click ID when an ad is shown. As a result, if a\nuser clicks on a particular ad impression multiple times, those clicks will be associated\nwith only one click ID. Landing page visits for the exact same impression will share the\nsame click ID.\n\nSearch Ads 360 can generate a click ID if you [activate the conversion API service](https://support.google.com/searchads/answer/2604604#activate). If a click is redirected from Google Ads and Google Ads has\nalready generated a click ID, Search Ads 360 uses the Google Ads ID instead of generating a new one. If a\nclick is redirected from another type of supported engine, Search Ads 360 generates the ID.\n\n#### Click ID Parameters\n\nEach click ID consists of two parameters. For example: \n\n```\ngclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds\n```\n\n\nThe `gclid` parameter contains a case-sensitive ID for the click. Search Ads 360\nmaintains the attribution information (such as keyword, ad, campaign, ad group) for\neach click ID generated.\n\n\nThe `gclsrc` parameter indicates the source of the click ID. Currently, it\ncan have one of the following values:\n\n-\n `gclsrc=ds`: the click ID was generated by Search Ads 360. In addition, the\n click was either on an engine other than Google, or the click was on Google but the\n Google Ads account is not using auto-tagging.\n\n-\n `gclsrc=aw.ds`: the click ID was generated by Google Ads that is using\n auto-tagging, and the click went through the Search Ads 360 clickserver.\n\n-\n `gclsrc=`: the parameter is empty if the click ID was generated by Google Ads,\n but the conversion API service was not enabled in Search Ads 360 when the click occurred.\n\n| **Tip**: We recommend you use the landing page of the website to keep track of the customer's offline contact information (such as phone number called) together with the click ID. When an offline conversion happens, the click ID can then be used to report the conversion back to Search Ads 360."]]
