L'API Search Ads 360 Reporting precedente non sarà più disponibile a partire dal 30 giugno 2024. Tieni presente che l'API Search Ads 360 Conversion non è interessata e continuerà a essere supportata. Tutte le nuove implementazioni di reporting devono utilizzare la nuova API Search Ads 360 Reporting.

A partire da aprile 2024, verrà restituito un errore non supportatoApiVersion quando si richiede un report. Consulta i dettagli qui.

Ti consigliamo inoltre di eseguire la migrazione delle implementazioni esistenti di Search Ads 360 alla nuova API. Per saperne di più, consulta la guida introduttiva e la guida alla migrazione della nuova API Search Ads 360 Reporting.

Questa pagina è stata tradotta dall'API Cloud Translation.

Conversion

La risorsa di conversione offre metodi che consentono agli utenti di creare, modificare e recuperare collettivamente le conversioni Floodlight.

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Un elenco di conversioni.

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

Nome proprietà	Valore	Descrizione	Note
`conversion[]`	`list`	Le conversioni richieste.
`conversion[].adGroupId`	`long`	ID gruppo di annunci DS.
`conversion[].adId`	`long`	ID annuncio DS.
`conversion[].adUserDataConsent`	`string`	Rappresenta il consenso per le preferenze dei servizi di piattaforma di base (CPS) nelle impostazioni. Nessun valore predefinito. I valori accettati sono: GRANTED: lo stato del consenso desiderato è "concesso". Leggi le preferenze CPS dalle impostazioni GTE. DENIED: lo stato del consenso desiderato è Negativo; l'elenco CPS è vuoto.
`conversion[].advertiserId`	`long`	ID inserzionista DS.
`conversion[].agencyId`	`long`	ID agenzia DS.
`conversion[].attributionModel`	`string`	Disponibile per gli inserzionisti solo dopo aver contattato l'assistenza clienti di DoubleClick Search.
`conversion[].campaignId`	`long`	ID campagna DS.
`conversion[].channel`	`string`	Canale di vendita del prodotto. I valori accettati sono: "`local`": un negozio fisico "`online`": un negozio online
`conversion[].clickId`	`string`	ID clic DS per la conversione.
`conversion[].conversionId`	`string`	Per le conversioni offline, gli inserzionisti forniscono questo ID. Gli inserzionisti possono specificare qualsiasi ID per loro significativo. Ogni conversione di una richiesta deve specificare un ID univoco e la combinazione di ID e timestamp deve essere univoca rispetto a tutte le conversioni all'interno dell'inserzionista. Per le conversioni online, DS copia `dsConversionId` o `floodlightOrderId` in questa proprietà a seconda delle istruzioni di Floodlight dell'inserzionista.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	L'ora in cui la conversione è stata modificata per l'ultima volta, in millisecondi UTC.
`conversion[].conversionTimestamp`	`unsigned long`	L'ora in cui è avvenuta la conversione, in millisecondi UTC.
`conversion[].countMillis`	`long`	Disponibile per gli inserzionisti solo dopo aver contattato l'assistenza clienti di DoubleClick Search.
`conversion[].criterionId`	`long`	ID criterio DS (parola chiave).
`conversion[].currencyCode`	`string`	Il codice valuta per le entrate della conversione. Deve essere in formato alfabetico ISO 4217 a tre caratteri.	scrivibile
`conversion[].customDimension[]`	`list`	Dimensioni personalizzate per la conversione, che possono essere utilizzate per filtrare i dati in un report.
`conversion[].customDimension[].name`	`string`	Nome della dimensione personalizzata.
`conversion[].customDimension[].value`	`string`	Valore della dimensione personalizzata.
`conversion[].customMetric[]`	`list`	Metriche personalizzate per la conversione.
`conversion[].customMetric[].name`	`string`	Nome della metrica personalizzata.
`conversion[].customMetric[].value`	`double`	Valore numerico della metrica personalizzata.
`conversion[].customerId`	`string`	ID cliente del nuovo Search Ads 360. Deve essere un account cliente. Quando questo campo è impostato, tutti gli altri campi ID devono essere impostati sugli ID del nuovo Search Ads 360.
`conversion[].deviceType`	`string`	Il tipo di dispositivo su cui è avvenuta la conversione. I valori accettati sono: "`DESKTOP`" "`HIGH_END_MOBILE`" "`OTHER_DEVICE`" "`TABLET`"
`conversion[].dsConversionId`	`long`	ID generato da DoubleClick Search per ogni conversione.
`conversion[].engineAccountId`	`long`	ID account motore DS.
`conversion[].floodlightOrderId`	`string`	L'ID ordine Floodlight fornito dall'inserzionista per la conversione.
`conversion[].inventoryAccountId`	`long`	L'ID generato e utilizzato da DS per identificare in modo univoco l'account inventario contenente il prodotto.
`conversion[].productCountry`	`string`	Il paese registrato per il feed di Merchant Center che contiene il prodotto. Utilizza un codice ISO 3166 per specificare un paese.
`conversion[].productGroupId`	`long`	ID gruppo di prodotti DS.
`conversion[].productId`	`string`	L'ID prodotto (SKU).
`conversion[].productLanguage`	`string`	La lingua registrata per il feed di Merchant Center che contiene il prodotto. Utilizza un codice ISO 639 per specificare una lingua.
`conversion[].quantityMillis`	`long`	La quantità di questa conversione, in migliaia.	scrivibile
`conversion[].revenueMicros`	`long`	L'importo delle entrate di questa conversione `TRANSACTION`, in micro (valore moltiplicato per 1000000, senza decimali). Ad esempio, per specificare il valore delle entrate "10", inserisci "10000000" (10 milioni) nella richiesta.	scrivibile
`conversion[].segmentationId`	`long`	L'identificatore di segmentazione numerico (ad esempio l'ID attività Floodlight di DoubleClick Search).
`conversion[].segmentationName`	`string`	L'identificatore di segmentazione semplice, ad esempio il nome dell'attività Floodlight di DoubleClick Search.
`conversion[].segmentationType`	`string`	Il tipo di segmentazione di questa conversione (ad es. `FLOODLIGHT`). I valori accettati sono: "`FLOODLIGHT`"
`conversion[].state`	`string`	Lo stato della conversione, ovvero `ACTIVE` o `REMOVED`. Nota: lo stato DELETED (Eliminato) è obsoleto. I valori accettati sono: "`ACTIVE`" "`DELETED`": (deprecato) "`REMOVED`"	scrivibile
`conversion[].storeId`	`string`	L'ID del negozio locale per il quale il prodotto è stato pubblicizzato. Applicabile solo quando il canale è "`local`".
`conversion[].type`	`string`	Il tipo di conversione, ovvero `ACTION` o `TRANSACTION`. Una conversione `ACTION` è un'azione compiuta dall'utente che non ha un valore misurabile a livello monetario, mentre una conversione `TRANSACTION` è un'azione con un valore quantificabile a livello monetario. Alcuni esempi sono le registrazioni alla mailing list (`ACTION`) rispetto agli acquisti e-commerce (`TRANSACTION`). I valori accettati sono: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	Identifica questa risorsa come una risorsa ConversionList. Valore: la stringa fissa `doubleclicksearch#conversionList`.

Metodi

recupero: Recupera un elenco di conversioni da un account motore DoubleClick Search.
getByCustomerId: Recupera un elenco di conversioni da un account motore DoubleClick Search utilizzando un ID cliente del nuovo Search Ads 360.
inserire: Inserisci un gruppo di nuove conversioni in DoubleClick Search.
aggiornamento: Aggiorna un gruppo di conversioni in DoubleClick Search.
updateAvailability: Aggiorna le disponibilità di un gruppo di attività Floodlight in DoubleClick Search.