La API anterior de Search Ads 360 Reporting dejará de estar disponible y se retirará el 30 de junio de 2024. Ten 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 nueva API de Search Ads 360 Reporting.

A partir de abril de 2024, se mostrará un error supportedApiVersion cuando se solicite un informe. Consulte los detalles aquí.

También te recomendamos que migres todas las implementaciones existentes de Search Ads 360 a la nueva API. Consulta la introducción y la guía de migración de la nueva API de Search Ads 360 Reporting para obtener más información.

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

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 ver una lista de los métodos para este recurso, consulta la sección 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. No hay un valor predeterminado. Los valores aceptables son: 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`	ID de la agencia de DS.
`conversion[].attributionModel`	`string`	Está disponible para los anunciantes solo 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`	En el caso de las conversiones sin conexión, los anunciantes deben proporcionar 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 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, expresada en milisegundos, UTC.
`conversion[].conversionTimestamp`	`unsigned long`	La hora a la que se realizó la conversión, expresada en milisegundos (UTC)
`conversion[].countMillis`	`long`	Está disponible para los anunciantes solo 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`	Es 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 de 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`	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`	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 se deben configurar con los IDs de la nueva experiencia de Search Ads 360.
`conversion[].deviceType`	`string`	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`	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`	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 de `TRANSACTION`, en micros (valor multiplicado por 1,000,000, sin decimal). Por ejemplo, para especificar el valor de ingresos de "10", ingresa "10,000,000" (10 millones) en tu solicitud.	admite escritura
`conversion[].segmentationId`	`long`	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 fácil de usar (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. Aplicable solo cuando el canal es "`local`".
`conversion[].type`	`string`	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 monetario cuantificable, mientras que una conversión de `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`) 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.
actualizar: Actualiza un lote de conversiones en DoubleClick Search.
updateAvailability: Actualiza la disponibilidad de un lote de actividades de Floodlight en DoubleClick Search.