A API Search Ads 360 Reporting anterior foi desativada. Agora você pode criar seus relatórios usando a nova API Search Ads 360 Reporting.
Os métodos get e getByCustomerId na API Search Ads 360 Conversion serão descontinuados no terceiro trimestre de 2025. Para continuar acessando os dados de conversão, crie um relatório usando o recurso de conversão com a nova API Search Ads 360 Reporting. Confira mais detalhes aqui.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Quando um cliente conclui uma ação predefinida no site de um anunciante, como
comprar um item ou solicitar mais informações, o Search Ads 360 informa uma conversão.
As conversões de alguns anunciantes começam on-line e terminam off-line. Por exemplo, um
consumidor inicia uma pesquisa on-line para comprar um produto, clica em um anúncio e liga para uma
central de atendimento para concluir a compra. Ou um consumidor com um smartphone toca no botão "ligar agora" de um anúncio e compra um item por telefone. Para essas conversões, o Search Ads 360 vai coletar dados sobre a parte on-line de maneira automática. Se você quiser fornecer dados sobre a parte off-line para melhorar os relatórios, usar em regras automatizadas ou otimizar em uma estratégia de lances, faça o upload no Search Ads 360.
Em alguns casos, talvez seja necessário modificar o valor de uma conversão. Por exemplo, você pode editar um valor de conversão para considerar descontos aplicados após uma compra on-line (como um reembolso por correio), devoluções com uma taxa de reposição ou créditos aplicados após a compra.
Depois de configurar o app cliente conforme descrito em Meu primeiro app (incluindo a ativação do
serviço de conversão), é possível enviar as seguintes solicitações relacionadas à conversão para a
API Search Ads 360:
Todas as solicitações de conversão são síncronas. É possível fazer solicitações síncronas paralelas (até o limite do seu projeto) em um único cliente.
IDs e conversões do Search Ads 360
Como as conversões precisam ser atribuídas a uma campanha, um anúncio, uma palavra-chave e, opcionalmente, a uma visita específica, cada conversão especifica o ID do Search Ads 360 de um anúncio, uma palavra-chave e uma campanha, além dos IDs dos objetos principais na hierarquia do Search Ads 360.
Ao receber, adicionar ou atualizar uma conversão, você precisará especificar a maioria desses IDs na solicitação.
Como conseguir IDs do Search Ads 360
Para encontrar esses IDs, faça o seguinte:
Use a interface do Search Ads 360 para baixar um relatório que contenha IDs do anunciante, contas de mecanismo, campanhas, grupos de anúncios, palavras-chave e anúncios.
Adicione macros do Search Ads 360, como CampaignID e TrackerID, aos URLs da página de destino. Quando um cliente clica em um anúncio, cada macro instrui o Search Ads 360 a transmitir o ID dela para a página de destino do anunciante como um parâmetro de URL.
É possível recuperar esses IDs dos registros da Web do anunciante e usá-los nas solicitações Conversion.
O Search Ads 360 oferece algumas macros diferentes para enviar IDs de palavras-chave a uma página de destino. Para atribuir conversões a uma palavra-chave, adicione a macro TrackerID aos URLs da página de destino.
IDs de clique
Um ID de clique rastreia um clique em um anúncio e pode ser usado para atribuir uma conversão a uma visita específica em vez de fornecer toda a hierarquia de IDs para objetos do Search Ads 360. O Search Ads 360 usa o ID de clique para encontrar e atribuir a palavra-chave e o anúncio adequados.
Os IDs de clique diferenciam maiúsculas de minúsculas. Por isso, verifique se os registros da Web e o software de rastreamento não mudam a formatação do ID de clique.
Como gerar um ID de clique
O ID de clique é gerado pelo Search Ads 360 ou pelo Google Ads.
Se a codificação automática estiver ativada em uma conta do Google Ads, o Google Ads vai gerar um ID de clique quando um anúncio for exibido. Dessa forma, se um usuário clicar em uma determinada impressão de anúncio várias vezes, esses cliques vão ser associados a apenas um ID de clique. As visitas à página de destino relativas a essa mesma impressão vão compartilhar o mesmo ID de clique.
O Search Ads 360 pode gerar um ID de clique se você
ativar o serviço da API Conversion. Se um clique for redirecionado do Google Ads e o Google Ads já tiver gerado um ID de clique, o Search Ads 360 usará o ID do Google Ads em vez de gerar um novo. Se um clique for redirecionado de outro tipo de mecanismo compatível, o Search Ads 360 vai gerar o ID.
Parâmetros de ID de clique
Cada ID de clique consiste em dois parâmetros. Exemplo:
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
O parâmetro gclid contém um ID que diferencia maiúsculas de minúsculas para o clique. O Search Ads 360 mantém as informações de atribuição (como palavra-chave, anúncio, campanha, grupo de anúncios) para cada ID de clique gerado.
O parâmetro gclsrc indica a origem do ID de clique. No momento, ele pode ter um dos seguintes valores:
gclsrc=ds: o ID do clique foi gerado pelo Search Ads 360. Além disso, o clique foi em um mecanismo que não é o Google ou foi no Google, mas a conta do Google Ads não usa a codificação automática.
gclsrc=aw.ds: o ID de clique foi gerado pelo Google Ads usando a
codificação automática, e o clique passou pelo servidor de cliques do Search Ads 360.
gclsrc=: o parâmetro fica vazio se o ID de clique foi gerado pelo Google Ads, mas o serviço da API Conversion não estava ativado no Search Ads 360 quando o clique ocorreu.
[null,null,["Última atualização 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."]]
