La API anterior de Search Ads 360 Reporting dejará de estar disponible y se retirará de servicio el 30 de junio de 2024. Tenga en cuenta que la API de conversiones de Search Ads 360 no se ve afectada y seguirá siendo compatible. Todo el desarrollo de informes nuevo debe usar la API de informes de Search Ads 360, que ahora está disponible en versión beta abierta. También le recomendamos que comience a migrar cualquier implementación existente de Search Ads 360 a la nueva API. Consulte la nueva API de informes de Search Ads 360 Cómo comenzar y la Guía de migración para obtener más información.

Se usó la API de Cloud Translation para traducir esta página.

Switch to English

Conversion

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

Si quieres obtener una lista de métodos para 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
    }
  ]
}

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[].advertiserId`	`long`	ID del anunciante de DS.
`conversion[].agencyId`	`long`	ID de agencia de DS.
`conversion[].attributionModel`	`string`	Solo está disponible para los anunciantes después de que se comunican con el servicio de atención al cliente de DoubleClick Search.
`conversion[].campaignId`	`long`	ID de campaña de DS.
`conversion[].channel`	`string`	Canal de ventas del producto. Los valores aceptables son: "`local`": una tienda física "`online`": una tienda en línea
`conversion[].clickId`	`string`	ID de clic de DS para la conversión.
`conversion[].conversionId`	`string`	Para las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que les resulte significativo. 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 épocas de milisegundos (UTC).
`conversion[].conversionTimestamp`	`unsigned long`	La hora a la que se realizó la conversión, en épocas en milisegundos (UTC).
`conversion[].countMillis`	`long`	Solo está disponible para los anunciantes después de que se comunican con el servicio de atención al cliente de DoubleClick Search.
`conversion[].criterionId`	`long`	ID del criterio de DS (palabra clave).
`conversion[].currencyCode`	`string`	Es el código de moneda correspondiente a los ingresos de la conversión. Debe tener el formato ISO 4217 en formato alfabético (3 caracteres).	admite escritura
`conversion[].customDimension[]`	`list`	Dimensiones personalizadas para la conversión, que se pueden utilizar para filtrar datos en un informe.
`conversion[].customDimension[].name`	`string`	Nombre de la dimensión personalizada.
`conversion[].customDimension[].value`	`string`	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`	Valor numérico de la métrica personalizada.
`conversion[].customerId`	`string`	Nuevo ID de cliente de Search Ads 360. Debe ser una cuenta cliente. Cuando se configura este campo, todos los demás campos ID se deben configurar en ID de Search Ads 360 nuevos.
`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 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 para 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 milisegundos.	admite escritura
`conversion[].revenueMicros`	`long`	El importe de los ingresos de esta conversión `TRANSACTION` en micros (valor multiplicado por 1000000, sin decimales) Por ejemplo, para especificar un valor de ingresos de "10", ingrese "10000000" (10 millones) en su solicitud.	admite escritura
`conversion[].segmentationId`	`long`	Es el identificador de segmentación numérica (por ejemplo, el ID de actividad de Floodlight de DoubleClick Search).
`conversion[].segmentationName`	`string`	Es el identificador de segmentación amigable (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`	Es el estado de la conversión, es decir, `ACTIVE` o `REMOVED`. Nota: El estado BORRADO es obsoleto. 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`	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 monetario cuantificable, mientras que una conversión `TRANSACTION` es una acción que tiene un valor monetario cuantificable. Algunos ejemplos son los registros en listas de direcciones de correo electrónico (`ACTION`) y las compras de comercio electrónico (`TRANSACTION`). Los valores aceptables son los siguientes: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	Se identifica como recurso de lista de conversiones. Valor: la string fijada `doubleclicksearch#conversionList`.

Métodos

obtener: 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.
actualizar: Actualiza un lote de conversiones en DoubleClick Search.
updateAvailability.: Actualiza la disponibilidad de un lote de actividades de Floodlight en DoubleClick Search.