L'API Search Ads 360 Reporting precedente è stata ritirata. Ora puoi creare i report utilizzando la nuova API Search Ads 360 Reporting.
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.
Le restanti funzioni dell'API Search Ads 360 Conversion continueranno a essere supportate.
Conversion: update
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Aggiorna un gruppo di conversioni in DoubleClick Search.
Prova subito.
Richiesta
Richiesta HTTP
PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito:
| Ambito |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Nel corpo della richiesta, fornisci una risorsa di conversione con le seguenti proprietà:
| Nome proprietà |
Valore |
Descrizione |
Note |
| Proprietà facoltative |
conversion[].currencyCode |
string |
Il codice valuta delle entrate della conversione. Deve essere in formato alfabetico ISO 4217 a tre caratteri. |
accessibile in scrittura
|
conversion[].quantityMillis |
long |
La quantità di questa conversione, in millisecondi. |
accessibile in scrittura
|
conversion[].revenueMicros |
long |
L'importo delle entrate di questa conversione di TRANSACTION, in micro (valore moltiplicato per 1000000, senza decimali). Ad esempio, per specificare un valore delle entrate pari a "10" inserisci "10000000" (10 milioni) nella tua richiesta. |
accessibile in scrittura
|
conversion[].state |
string |
Lo stato della conversione, ovvero ACTIVE o REMOVED. Nota: lo stato DELETED è obsoleto.
I valori accettati sono:
- "
ACTIVE"
- "
DELETED": (deprecato)
- "
REMOVED"
|
accessibile in scrittura
|
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa di conversione nel corpo della risposta.
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
In alternativa, prova la
autonomo
Spazio di esplorazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-08-20 UTC.
[null,null,["Ultimo aggiornamento 2024-08-20 UTC."],[[["\u003cp\u003eUpdates a batch of conversions in DoubleClick Search using the \u003ccode\u003ePUT\u003c/code\u003e method.\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\u003eThe request body should contain a Conversion resource with properties like \u003ccode\u003ecurrencyCode\u003c/code\u003e, \u003ccode\u003equantityMillis\u003c/code\u003e, \u003ccode\u003erevenueMicros\u003c/code\u003e, and \u003ccode\u003estate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a Conversion resource in the response body.\u003c/p\u003e\n"]]],["This outlines how to update conversions in DoubleClick Search via a PUT request to `https://www.googleapis.com/doubleclicksearch/v2/conversion`, requiring `https://www.googleapis.com/auth/doubleclicksearch` authorization. The request body should include a Conversion resource with optional properties like `currencyCode`, `quantityMillis`, `revenueMicros`, and `state` (either `ACTIVE` or `REMOVED`). Successful requests return a Conversion resource.\n"],null,["# Conversion: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates a batch of conversions in DoubleClick Search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/doubleclicksearch/v2/conversion\n```\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\nIn the request body, supply a [Conversion resource](/search-ads/v2/reference/conversion#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|-------------------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Optional Properties** ||||\n| conversion[].`currencyCode` | `string` | The currency code for the conversion's revenue. Should be in ISO 4217 alphabetic (3-char) format. | writable |\n| conversion[].`quantityMillis` | `long` | The quantity of this conversion, in millis. | writable |\n| conversion[].`revenueMicros` | `long` | The revenue amount of this `TRANSACTION` conversion, in micros (value multiplied by 1000000, no decimal). For example, to specify a revenue value of \"10\" enter \"10000000\" (10 million) in your request. | writable |\n| conversion[].`state` | `string` | The state of the conversion, that is, either `ACTIVE` or `REMOVED`. Note: state DELETED is deprecated. \u003cbr /\u003e Acceptable values are: - \"`ACTIVE`\" - \"`DELETED`\": (Deprecated) - \"`REMOVED`\" | writable |\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.update)."]]
