Asignaciones de campo

Utiliza las asignaciones de las tablas para asignar un conversions.batchinsert en la API de Campaign Manager 360 a su equivalente IngestEventsRequest en la API de Data Manager.

Campos de la solicitud

conversions.batchinsert (API de Campaign Manager 360) IngestEventsRequest (API de Data Manager) Notas
Parámetro de ruta de URL profileId Sin equivalente
kind Sin equivalente Campo de metadatos; la API de Data Manager no lo usa.
conversions events Obligatorio. Es la lista de conversiones o eventos. Consulta la sección Campos de conversión para obtener más detalles.
encryptionInfo Se movió a events.adIdentifiers.encryptedUserIds Se define a nivel del evento. La información de encriptación de Campaign Manager 360 ahora se especifica en cada ID de usuario encriptado. Consulta la sección Campos de conversión.
Sin equivalente encryptionInfo El encryptionInfo a nivel de la solicitud es la información de encriptación para los identificadores de usuario UserData encriptados. Consulta Encriptación para obtener más detalles.
Sin equivalente destinations Obligatorio. Es una lista de objetos Destination que definen la cuenta de destino y la actividad de Floodlight para los eventos. Consulta la guía Destinos para obtener más detalles. Asigna campos individuales como se muestra en la sección Campos de conversión.
Sin equivalente consent Es la configuración de consentimiento predeterminada opcional para los eventos de la solicitud. Puedes anular este valor para un evento individual si configuras el campo consent de Event.
Sin equivalente encoding Obligatorio si se envían identificadores de usuario: Establece el Encoding que se usa para los valores UserIdentifier. Si no usas identificadores de usuario, se ignora este campo.
Sin equivalente validateOnly Si es verdadero, la solicitud se valida, pero no se ejecuta.

Campos de conversión

Conversion (API de Campaign Manager 360) Event (API de Data Manager) Notas
floodlightConfigurationId destinations[].operatingAccount.accountId Se define a nivel de la solicitud. Establece el ID de configuración de Floodlight.
Sin equivalente destinations[].operatingAccount.accountType Se define a nivel de la solicitud. Establece FLOODLIGHT_CONFIG.
floodlightActivityId destinations[].productDestinationId Se define a nivel de la solicitud. Establece el ID de actividad de Floodlight.
kind Sin equivalente Campo de metadatos; la API de Data Manager no lo usa.
Sin equivalente destinations[].reference Se define a nivel de la solicitud. Es un identificador definido por el usuario para el destino. Configura este campo si estás enviando eventos a varios destinos en una sola solicitud.
adUserDataConsent consent.adUserData Consulta Consent para obtener más detalles.
nonPersonalizedAd consent.adPersonalization Consulta Consent para obtener más detalles.
Sin equivalente destinationReferences Si envías eventos a varios destinos en una sola solicitud, establece este campo en la reference correspondiente del destino.
timestampMicros eventTimestamp
  • Si usas el formato JSON, establece un valor en formato RFC 3339, que difiere ligeramente de la API de Campaign Manager 360, que esperaba timestampMicros en microsegundos desde la época de Unix.
  • Si usas búferes de protocolo, usa un Timestamp y establece los campos seconds y (opcionalmente) los nanoseconds.

Consulta Formato de marca de tiempo para obtener más detalles.
value conversionValue
quantity conversionCount
ordinal Sin equivalente El campo ordinal de la API de Campaign Manager 360 no está presente en la API de Data Manager. En su lugar, la API de Data Manager usa transactionId para anular la duplicación de eventos enviados al mismo ID de actividad de Floodlight.

En la API de Campaign Manager 360, podías asegurarte de que los eventos no se duplicaran si establecías ordinal en un valor fijo y constante, como 1. En la API de Data Manager, transactionId debe establecerse en un identificador único para cada evento.
Sin equivalente transactionId La API de Data Manager usa una combinación del ID de actividad de Floodlight y transactionId para anular la duplicación del evento. El campo transactionId debe establecerse en un identificador único para cada evento.

Este campo es opcional cuando se envían conversiones sin conexión de Floodlight. Consulta Cómo convertir los datos en objetosEventpara obtener más detalles.
customVariables customVariables Es una lista de CustomVariable objetos. La API de Data Manager usa cadenas como claves en lugar de enumeraciones. Usa claves como U1 y U2 para el campo variable.
limitAdTracking consent.adPersonalization Consulta Consent para obtener más detalles.
childDirectedTreatment consent.adPersonalization Consulta Consent para obtener más detalles.
treatmentForUnderage consent.adPersonalization Consulta Consent para obtener más detalles.
gclid adIdentifiers.gclid Consulta AdIdentifiers para obtener más detalles.
dclid adIdentifiers.dclid Consulta AdIdentifiers para obtener más detalles.
matchId adIdentifiers.matchId Consulta AdIdentifiers para obtener más detalles.
mobileDeviceId adIdentifiers.mobileId Consulta AdIdentifiers para obtener más detalles.
impressionId adIdentifiers.impressionId Consulta AdIdentifiers para obtener más detalles.
encryptedUserId adIdentifiers.encryptedUserIds La API de Data Manager admite varios IDs de usuario encriptados. Consulta AdIdentifiers para obtener más detalles.
encryptedUserIdCandidates adIdentifiers.encryptedUserIds Cada ID de candidato se asigna a un EncryptedUserId objeto en la lista.
encryptionInfo.kind Sin equivalente Campo de metadatos; la API de Data Manager no lo usa.
encryptionInfo.encryptionEntityType adIdentifiers.encryptedUserIds[].entityType En lugar de especificar la información de encriptación una vez por solicitud, se especifica por ID de usuario encriptado.
encryptionInfo.encryptionEntityId adIdentifiers.encryptedUserIds[].entityId En lugar de especificar la información de encriptación una vez por solicitud, se especifica por ID de usuario encriptado.
encryptionInfo.encryptionSource adIdentifiers.encryptedUserIds[].source En lugar de especificar la información de encriptación una vez por solicitud, se especifica por ID de usuario encriptado.
sessionAttributesEncoded adIdentifiers.sessionAttributes Consulta AdIdentifiers para obtener más detalles.
cartData cartData Consulta Campos de datos del carrito para obtener más detalles.
userIdentifiers userData.userIdentifiers Consulta Campos de identificadores del usuario para obtener más detalles.

Campos de identificadores del usuario

En la API de Data Manager, los identificadores de usuario se agrupan dentro de un UserData objeto en el campo userData del Event. Esto difiere de la API de Campaign Manager 360, en la que los identificadores se adjuntan directamente al objeto Conversion.

UserIdentifier (API de Campaign Manager 360) UserIdentifier (API de Data Manager) Notas
hashedEmail emailAddress Establece la dirección de correo electrónico con formato y codificación hash. También puedes encriptar la dirección de correo electrónico con codificación hash.
hashedPhoneNumber phoneNumber Establece el número de teléfono con formato y codificación hash. También puedes encriptar el número de teléfono con codificación hash.
addressInfo address Establece un AddressInfo objeto. Sigue los lineamientos de formato y codificación hash. También puedes encriptar los atributos con codificación hash de una dirección.
addressInfo.hashedFirstName address.givenName
addressInfo.hashedLastName address.familyName
addressInfo.countryCode address.regionCode
addressInfo.postalCode address.postalCode
addressInfo.city Sin equivalente No se admite en la versión actual de la API de Data Manager.
addressInfo.state Sin equivalente No se admite en la versión actual de la API de Data Manager.
addressInfo.hashedStreetAddress Sin equivalente No se admite en la versión actual de la API de Data Manager.

Campos de datos del carrito

CartData (API de Campaign Manager 360) CartData (API de Data Manager) Notas
kind Sin equivalente Campo de metadatos; la API de Data Manager no lo usa.
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items Es una lista de Item objetos. Consulta Campos de artículos para obtener más detalles.

Campos de artículos para datos del carrito

Item (API de Campaign Manager 360) Item (API de Data Manager) Notas
kind Sin equivalente Campo de metadatos; la API de Data Manager no lo usa.
Sin equivalente itemId Es opcional. Un identificador único del artículo.
itemId merchantProductId Obligatorio. Establece el ID de producto de Merchant Center para el artículo.
quantity quantity Obligatorio.
unitPrice unitPrice Obligatorio.
Anterior
Pasos para la actualización