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.

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.