Conversion

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

Per un elenco di metodi per questa risorsa, vai alla 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 deve essere concesso. Leggi le preferenze CPS dalle impostazioni GTE. DENIED: lo stato del consenso desiderato è negare; 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 L'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 in una richiesta deve specificare un ID univoco e la combinazione di ID e timestamp deve essere univoca tra tutte le conversioni all'interno dell'inserzionista.
Per le conversioni online, DS copia dsConversionId o floodlightOrderId in questa proprietà a seconda delle istruzioni 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 delle entrate della conversione. Deve essere in formato alfabetico ISO 4217 a tre caratteri. accessibile in scrittura
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. Se 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 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 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[].segmentationId long L'identificatore numerico di segmentazione (ad esempio, ID attività Floodlight di DoubleClick Search).
conversion[].segmentationName string L'identificatore di segmentazione semplice (ad esempio, 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 è obsoleto.

I valori accettati sono:
  • "ACTIVE"
  • "DELETED":  (deprecato)
  • "REMOVED"
 accessibile in scrittura
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 senza un valore quantificabile 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) e gli acquisti e-commerce (TRANSACTION).

I valori accettati sono:
  • "ACTION"
  • "TRANSACTION"
kind string Identifica come risorsa ConversionList. Valore: la stringa fissa doubleclicksearch#conversionList.

Metodi

trova
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.
inserisci
Inserisce un gruppo di nuove conversioni in DoubleClick Search.
aggiorna
Aggiorna un gruppo di conversioni in DoubleClick Search.
updateAvailability
Aggiorna le disponibilità di un gruppo di attività Floodlight in DoubleClick Search.