Conversion

El recurso de conversión tiene métodos que permiten a los usuarios crear, modificar y recuperar conversiones de Floodlight de forma masiva.

Para obtener una lista de métodos para este recurso, consulta al final de esta página.

Representaciones de recursos

Una lista de conversiones

{
  "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
    }
  ]
}
Nombre de la propiedad Valor Descripción Notas
conversion[] list Son las conversiones que se solicitan.
conversion[].adGroupId long ID del grupo de anuncios de DS.
conversion[].adId long ID del anuncio de DS.
conversion[].adUserDataConsent string Representa el consentimiento para las preferencias de los servicios principales de plataforma (CPS) en la configuración. Sin valor predeterminado. Los valores aceptables son los siguientes: GRANTED: El estado de consentimiento deseado es otorgar. Lee las preferencias de CPS en la configuración de GTE. DENIED: El estado de consentimiento deseado es Rechazar. La lista de CPS está vacía.
conversion[].advertiserId long ID del anunciante de DS.
conversion[].agencyId long Es el ID de la agencia de DS.
conversion[].attributionModel string Está disponible para los anunciantes únicamente después de comunicarse con el servicio de atención al cliente de DoubleClick Search.
conversion[].campaignId long ID de la campaña de DS.
conversion[].channel string Es el canal de ventas del producto. Los valores aceptables son:
  • "local": una tienda física
  • “online”: una tienda en línea
conversion[].clickId string Es el ID de clic de DS de la conversión.
conversion[].conversionId string Para las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que sea significativo para ellos. Cada conversión en una solicitud debe especificar un ID único, y la combinación de ID y marca de tiempo debe ser única entre todas las conversiones dentro del anunciante.
Para las conversiones en línea, DS copia el dsConversionId o el floodlightOrderId en esta propiedad según las instrucciones de Floodlight del anunciante.
conversion[].conversionModifiedTimestamp unsigned long La hora a la que se modificó la conversión por última vez, en milisegundos de época UTC.
conversion[].conversionTimestamp unsigned long La hora en la que se realizó la conversión, en milisegundos (UTC)
conversion[].countMillis long Está disponible para los anunciantes únicamente después de comunicarse con el servicio de atención al cliente de DoubleClick Search.
conversion[].criterionId long ID del criterio de DS (palabra clave).
conversion[].currencyCode string El código de moneda de los ingresos de la conversión. Debe estar en formato alfabético ISO 4217 (3 caracteres). admite escritura
conversion[].customDimension[] list Dimensiones personalizadas para la conversión, que se pueden usar para filtrar datos en un informe.
conversion[].customDimension[].name string Nombre de la dimensión personalizada.
conversion[].customDimension[].value string Es el valor de dimensión personalizada.
conversion[].customMetric[] list Métricas personalizadas para la conversión.
conversion[].customMetric[].name string Nombre de la métrica personalizada.
conversion[].customMetric[].value double Es el valor numérico de la métrica personalizada.
conversion[].customerId string ID de cliente nuevo de Search Ads 360 Debe ser una cuenta de cliente. Cuando se establece este campo, todos los demás campos de ID deben establecerse con los IDs de la nueva experiencia de Search Ads 360.
conversion[].deviceType string Indica el tipo de dispositivo en el que se generó la conversión.

Los valores aceptables son los siguientes:
  • "DESKTOP"
  • "HIGH_END_MOBILE"
  • "OTHER_DEVICE"
  • "TABLET"
conversion[].dsConversionId long ID que DoubleClick Search genera para cada conversión.
conversion[].engineAccountId long ID de la cuenta de motor de DS.
conversion[].floodlightOrderId string Es el ID de pedido de Floodlight que proporciona el anunciante para la conversión.
conversion[].inventoryAccountId long ID que DS genera y utiliza para identificar de forma exclusiva la cuenta de inventario que contiene el producto.
conversion[].productCountry string El país registrado en el feed de Merchant Center que contiene el producto. Usa un código ISO 3166 para especificar un país.
conversion[].productGroupId long ID del grupo de productos de DS.
conversion[].productId string Es el ID del producto (SKU).
conversion[].productLanguage string El idioma registrado en el feed de Merchant Center que contiene el producto. Usa un código ISO 639 para especificar un idioma.
conversion[].quantityMillis long La cantidad de esta conversión, en milésimas de segundo. admite escritura
conversion[].revenueMicros long El importe de los ingresos de esta conversión de TRANSACTION, en micros (valor multiplicado por 1,000,000, sin decimal). Por ejemplo, para especificar un valor de ingresos de "10" ingresa "10,000,000" (diez millones) en la solicitud. admite escritura
conversion[].segmentationId long Es el identificador de segmentación numérico (por ejemplo, el ID de actividad de Floodlight de DoubleClick Search).
conversion[].segmentationName string Es el identificador de segmentación simple (por ejemplo, el nombre de la actividad de Floodlight de DoubleClick Search).
conversion[].segmentationType string Es el tipo de segmentación de esta conversión (por ejemplo, FLOODLIGHT).

Los valores aceptables son los siguientes:
  • "FLOODLIGHT"
conversion[].state string El estado de la conversión, es decir, ACTIVE o REMOVED Nota: El estado DELETED dejó de estar disponible.

Los valores aceptables son los siguientes:
  • "ACTIVE"
  • "DELETED":  (obsoleto)
  • "REMOVED"
 admite escritura
conversion[].storeId string Es el ID de la tienda local para la que se anunció el producto. Se aplica solo cuando el canal es “local”.
conversion[].type string Indica el tipo de conversión, es decir, ACTION o TRANSACTION. Una conversión de ACTION es una acción del usuario que no tiene un valor cuantificable monetariamente, mientras que una conversión de TRANSACTION es una acción que tiene un valor cuantificable. Algunos ejemplos son los registros en listas de direcciones de correo electrónico (ACTION) en comparación con las compras de comercio electrónico (TRANSACTION).

Los valores aceptables son los siguientes:
  • "ACTION"
  • "TRANSACTION"
kind string Lo identifica como un recurso ConversionList. Valor: la cadena fija doubleclicksearch#conversionList

Métodos

get
Recupera una lista de conversiones de una cuenta de motor de DoubleClick Search.
getByCustomerId
Recupera una lista de conversiones de una cuenta de motor de DoubleClick Search con un ID de cliente nuevo de Search Ads 360.
insertar
Inserta un lote de conversiones nuevas en DoubleClick Search.
actualización
Actualiza un lote de conversiones en DoubleClick Search.
updateAvailability
Actualiza la disponibilidad de un lote de actividades de Floodlight en DoubleClick Search.