Usa 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 |
|---|---|---|
profileId Parámetro de ruta de URL |
Sin equivalente | |
kind |
Sin equivalente | Es un campo de metadatos que no usa la API de Data Manager. |
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 objetivo y la actividad de Floodlight para los eventos. Consulta la guía de 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 configurando el campo consent de Event. |
| Sin equivalente | encoding |
Obligatorio si se envían identificadores de usuario: Se debe establecer en el Encoding que se usa para los valores de UserIdentifier. Si no se usan 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. Se establece en el ID de configuración de Floodlight. |
| Sin equivalente | destinations[].operatingAccount.accountType |
Se define a nivel de la solicitud. Debes establecerlo en FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Se define a nivel de la solicitud. Se establece en el ID de actividad de Floodlight (anteriormente conocido como ID de actividad de Floodlight). |
kind |
Sin equivalente | Es un campo de metadatos que no usa la API de Data Manager. |
| Sin equivalente | destinations[].reference |
Se define a nivel de la solicitud. Es un identificador definido por el usuario para el destino. Establece este campo si envías 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 el reference correspondiente del destino. |
timestampMicros |
eventTimestamp |
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 del Administrador de datos.
En su lugar, se puede usar transactionId para controlar cómo se anulan las conversiones duplicadas del mismo usuario y día.
En la API de Campaign Manager 360, puedes asegurarte de que los eventos se anulen duplicados configurando ordinal en un valor constante y fijo, como 1. En la API de Data Manager, transactionId debe establecerse como un identificador único para cada evento.
|
| Sin equivalente | transactionId |
En la API de Data Manager, transactionId se usa para controlar cómo se anulan las conversiones duplicadas del mismo usuario y día. Este campo 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 objetos Event para obtener más detalles.
|
customVariables |
customVariables |
Es una lista de objetos CustomVariable. 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 objeto EncryptedUserId en la lista. |
encryptionInfo.kind |
Sin equivalente | Es un campo de metadatos que no usa la API de Data Manager. |
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 objeto UserData en el campo userData del objeto 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 |
Se establece en la dirección de correo electrónico con formato y hash. También puedes encriptar la dirección de correo electrónico hasheada. |
hashedPhoneNumber |
phoneNumber |
Se establece en el número de teléfono con formato y codificado con hash. También puedes encriptar el número de teléfono codificado con hash. |
addressInfo |
address |
Se establece en un objeto AddressInfo. Sigue los lineamientos de formato y codificación hash. También puedes encriptar los atributos 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 | Es un campo de metadatos que no usa la API de Data Manager. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Es una lista de objetos Item. Consulta Campos de artículos para obtener más detalles. |
Campos de artículos para los datos del carrito
Item (API de Campaign Manager 360) |
Item (API de Data Manager) |
Notas |
|---|---|---|
kind |
Sin equivalente | Es un campo de metadatos que no usa la API de Data Manager. |
| Sin equivalente | itemId |
Opcional. Es un identificador único del elemento. |
itemId |
merchantProductId |
Obligatorio. Se establece en el ID de producto de Merchant Center del artículo. |
quantity |
quantity |
Obligatorio. |
unitPrice |
unitPrice |
Obligatorio. |