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 los métodos de este recurso, consulta el 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,
      "sessionAttributesEncoded": bytes
    }
  ]
}
Nombre de la propiedad Valor Descripción Notas
conversion[] list 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 básicos de plataforma (CPS) en la configuración. No hay un valor predeterminado. Los valores aceptables son: GRANTED: El estado de consentimiento deseado es otorgar. Lee las preferencias de CPS desde la configuración de GTE. RECHAZADO: El estado de consentimiento deseado es rechazar. La lista de CPS está vacía.

Los valores aceptables son los siguientes:
  • "DENIED"
  • "GRANTED"
  • "UNKNOWN"
conversion[].advertiserId long ID del anunciante de DS.
conversion[].agencyId long ID de la agencia de DS.
conversion[].attributionModel string Solo está disponible para los anunciantes después de que se comuniquen con el equipo de asistencia 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 los siguientes:
  • "local": Una tienda física
  • "online": Una tienda en línea
conversion[].clickId string ID de clic de DS de la conversión.
conversion[].conversionId string En el caso de las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que consideren pertinente. 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 del anunciante.
En el caso de las conversiones en línea, DS copia dsConversionId o floodlightOrderId en esta propiedad según las instrucciones de Floodlight del anunciante.
conversion[].conversionModifiedTimestamp unsigned long Es la hora en que se modificó la conversión por última vez, en milisegundos de época UTC.
conversion[].conversionTimestamp unsigned long Es la hora en la que se produjo la conversión, en milisegundos de época UTC.
conversion[].countMillis long Solo está disponible para los anunciantes después de que se comuniquen con el equipo de asistencia al cliente de DoubleClick Search.
conversion[].criterionId long ID del criterio (palabra clave) de DS.
conversion[].currencyCode string Es el código de la 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 Es el nombre de la dimensión personalizada.
conversion[].customDimension[].value string Es el valor de la dimensión personalizada.
conversion[].customMetric[] list Métricas personalizadas para la conversión.
conversion[].customMetric[].name string Es el 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 de la nueva experiencia de Search Ads 360. Debe ser una cuenta de cliente. Cuando se configura este campo, todos los demás campos de ID deben establecerse en los IDs de la nueva experiencia de Search Ads 360.
conversion[].deviceType string Es 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 Es el ID que genera la Búsqueda de DoubleClick para cada conversión.
conversion[].engineAccountId long ID de la cuenta del motor de DS.
conversion[].floodlightOrderId string Es el ID de pedido de Floodlight que proporciona el anunciante para la conversión.
conversion[].inventoryAccountId long Es el ID que genera y usa DS para identificar de forma inequívoca la cuenta de inventario que contiene el producto.
conversion[].productCountry string Es el país registrado para 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 El ID del producto (SKU).
conversion[].productLanguage string Es el idioma registrado para el feed de Merchant Center que contiene el producto. Usa un código ISO 639 para especificar un idioma.
conversion[].quantityMillis long Es la cantidad de esta conversión, en milisegundos. admite escritura
conversion[].revenueMicros long Es el importe de los ingresos de esta conversión de TRANSACTION, en micros (valor multiplicado por 1,000,000, sin decimales). Por ejemplo, para especificar un valor de ingresos de "10", ingresa "10000000" (10 millones) en tu solicitud. admite escritura
conversion[].segmentationId long El identificador de segmentación numérico (por ejemplo, el ID de la actividad de Floodlight de DoubleClick Search)
conversion[].segmentationName string El identificador de segmentación amigable (por ejemplo, el nombre de la actividad de Floodlight de la Búsqueda de DoubleClick)
conversion[].segmentationType string Es el tipo de segmentación de esta conversión (por ejemplo, FLOODLIGHT).

Los valores aceptables son los siguientes:
  • "FLOODLIGHT"
conversion[].sessionAttributesEncoded bytes Los atributos de sesión del evento, representados como una cadena JSON codificada en base64. La biblioteca proporcionada por Google debe generar el contenido.
conversion[].state string Es 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 promocionó el producto. Solo se aplica cuando el canal es "local".
conversion[].type string Es el tipo de conversión, es decir, ACTION o TRANSACTION. Una conversión ACTION es una acción del usuario que no tiene un valor cuantificable monetariamente, mientras que una conversión TRANSACTION es una acción que sí tiene un valor cuantificable monetariamente. 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 Identifica esto como un recurso de 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 nuevo ID de cliente 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 las disponibilidades de un lote de actividades de Floodlight en DoubleClick Search.