Tieni presente che i metodi get e getByCustomerId nell'API Search Ads 360 Conversion verranno ritirati nel terzo trimestre del 2025. Per continuare ad accedere ai dati sulle conversioni, devi creare un report utilizzando la risorsa conversion con la nuova API Search Ads 360 Reporting. Scopri di più qui.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Quando un cliente completa un'azione predefinita sul sito web di un inserzionista, ad esempio
l'acquisto di un articolo o la richiesta di ulteriori informazioni, Search Ads 360 registra una conversione.
Le conversioni per alcuni inserzionisti iniziano online e terminano offline. Ad esempio, un
consumatore avvia la ricerca online per un acquisto, fa clic su un annuncio, poi telefona a un
call center per completare l'acquisto. Oppure, un consumatore che utilizza uno smartphone tocca il pulsante "Chiama ora" in un annuncio e acquista un articolo al telefono. Per queste conversioni,
Search Ads 360 riceve automaticamente i dati relativi alla parte online. Se vuoi
fornire dati relativi alla parte offline, per migliorare i report, utilizzarli nelle regole
automatizzate o ottimizzare una strategia di offerta, puoi caricarli su Search Ads 360.
In alcuni casi, potrebbe essere necessario modificare il valore di una conversione esistente. Ad esempio, puoi modificare un valore di conversione per tenere conto degli sconti applicati dopo un acquisto online (ad esempio un rimborso postale), dei resi avvenuti con una commissione di riassortimento o dei crediti applicati dopo l'acquisto.
Tutte le richieste di conversione sono sincrone. Puoi effettuare richieste sincrone parallele (fino al limite del tuo progetto) in un singolo client.
ID e conversioni di Search Ads 360
Poiché le conversioni devono essere attribuite a una campagna, un annuncio, una parola chiave e, facoltativamente, a una visita, ogni conversione specifica l'ID Search Ads 360 di un annuncio, una parola chiave e una campagna, insieme agli ID degli oggetti principali nella gerarchia di Search Ads 360.
Quando ricevi, aggiungi o aggiorni una conversione, devi specificare la maggior parte di questi ID nella
richiesta.
Ottenere gli ID Search Ads 360
Per trovare questi ID, procedi in uno dei seguenti modi:
Utilizza l'interfaccia utente di Search Ads 360 per scaricare
un report contenente gli ID di inserzionista, account motore, campagne, gruppi di annunci, parole chiave e annunci.
Aggiungi
macro di Search Ads 360 come CampaignID e TrackerID
agli URL pagina di destinazione. Quando un cliente fa clic su un annuncio, ogni macro indica
a Search Ads 360 di passare il proprio ID alla pagina di destinazione dell'inserzionista come parametro URL.
Puoi recuperare questi ID dai log web dell'inserzionista e utilizzarli nelle tue richieste Conversion.
Search Ads 360 fornisce diverse macro per l'invio degli ID parola chiave a una pagina di destinazione. Per attribuire le conversioni a una parola chiave, devi aggiungere la macro TrackerID
agli URL pagina di destinazione.
ID clic
Un ID clic monitora un clic su un annuncio e puoi utilizzarlo per attribuire una
conversione a una visita specifica anziché fornire l'intera gerarchia di ID per
gli oggetti Search Ads 360. Search Ads 360 utilizzerà l'ID clic per trovare e attribuire
l'annuncio e la parola chiave appropriati.
Gli ID clic sono sensibili alle maiuscole, quindi assicurati che i log web e il software di monitoraggio
non apportino modifiche alle maiuscole e alle minuscole degli ID clic.
Generare un ID clic
L'ID clic viene generato da Search Ads 360 o Google Ads.
Se il tagging automatico è attivato
in un account Google Ads, Google Ads genera un ID clic quando viene mostrato un annuncio. Di conseguenza, se un utente fa clic più volte su una determinata impressione dell'annuncio, questi clic verranno associati a un solo ID clic. Le visite alla pagina di destinazione relative alla stessa impressione condivideranno lo stesso ID clic.
Search Ads 360 può generare un ID clic se
attivi il servizio API Conversion. Se un clic viene reindirizzato da Google Ads e Google Ads ha
già generato un ID clic, Search Ads 360 utilizza l'ID Google Ads anziché generarne uno nuovo. Se un
clic viene reindirizzato da un altro tipo di motore supportato, Search Ads 360 genera l'ID.
Parametri ID clic
Ogni ID clic è composto da due parametri. Ad esempio:
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
Il parametro gclid contiene un ID sensibile alle maiuscole per il clic. Search Ads 360
mantiene le informazioni sull'attribuzione (ad esempio parola chiave, annuncio, campagna, gruppo di annunci) per
ogni ID clic generato.
Il parametro gclsrc indica l'origine dell'ID clic. Al momento, può avere uno dei seguenti valori:
gclsrc=ds: l'ID clic è stato generato da Search Ads 360. Inoltre, il
clic è stato effettuato su un motore diverso da Google oppure su Google, ma
l'account Google Ads non utilizza il tagging automatico.
gclsrc=aw.ds: l'ID clic è stato generato da Google Ads che utilizza
il tagging automatico e il clic è passato attraverso il server dei clic di Search Ads 360.
gclsrc=: il parametro è vuoto se l'ID clic è stato generato da Google Ads,
ma il servizio API Conversion non era attivato in Search Ads 360 quando si è verificato il clic.
[null,null,["Ultimo aggiornamento 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."]]
