Usa las asignaciones de las tablas para asignar un
conversions.batchinsert de la API de Campaign Manager 360 a su
equivalente de IngestEventsRequest en la API de Data Manager.
Autenticación
La API de Data Manager requiere credenciales con un alcance diferente al de la API de Campaign Manager 360. Sigue los pasos que se indican en Configura el acceso a la API para generar credenciales nuevas que incluyan el permiso de la API de Data Manager.
Campos de solicitud
conversions.batchinsert (API de Campaign Manager 360) |
IngestEventsRequest (API de Data Manager) |
Notas |
|---|---|---|
Parámetro de ruta de URL de profileId |
No hay equivalente | |
kind |
No hay 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. |
| No hay 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. |
| No hay 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 de destinos para obtener más detalles. Asigna campos individuales como se muestra en la sección Campos de conversión. |
| No hay 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. |
| No hay equivalente | encoding |
Obligatorio si se envían identificadores de usuario: Se establece en el Encoding que se usa para los valores de UserIdentifier. Si no se usan identificadores de usuario, se ignora este campo. |
| No hay 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. |
| No hay 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 la actividad de Floodlight. |
kind |
No hay equivalente | Es un campo de metadatos que no usa la API de Data Manager. |
| No hay 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 información. |
nonPersonalizedAd |
consent.adPersonalization |
Consulta Consent para obtener más información. |
| No hay 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 |
No hay equivalente |
El campo ordinal de la API de Campaign Manager 360 no está presente en la API del Administrador de datos.
En su lugar, la API de Data Manager usa transactionId para
anular la duplicación de los eventos enviados al mismo ID de actividad de Floodlight.
En la API de Campaign Manager 360, puedes asegurarte de que se quiten los eventos duplicados estableciendo ordinal en un valor fijo y constante, como 1. En la API de Data Manager,
transactionId se debe establecer en un identificador único para cada evento.
|
| No hay equivalente | transactionId |
La API de Data Manager usa una combinación del ID de la actividad de Floodlight y
transactionId para anular la duplicación del evento. El campo transactionId debe
establecerse en un identificador único para cada evento.
Obligatorio si se envían eventos para conversiones desde varias fuentes. Consulta Convierte 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 información. |
childDirectedTreatment |
consent.adPersonalization |
Consulta Consent para obtener más información. |
treatmentForUnderage |
consent.adPersonalization |
Consulta Consent para obtener más información. |
gclid |
adIdentifiers.gclid |
Consulta AdIdentifiers para obtener más información. |
dclid |
adIdentifiers.dclid |
Consulta AdIdentifiers para obtener más información. |
matchId |
adIdentifiers.matchId |
Consulta AdIdentifiers para obtener más información. |
mobileDeviceId |
adIdentifiers.mobileId |
Consulta AdIdentifiers para obtener más información. |
impressionId |
adIdentifiers.impressionId |
Consulta AdIdentifiers para obtener más información. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
La API de Data Manager admite varios IDs de usuario encriptados. Consulta AdIdentifiers para obtener más información. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Cada ID de candidato se asigna a un objeto EncryptedUserId de la lista. |
encryptionInfo.kind |
No hay 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 información. |
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 en un objeto UserData en el campo userData de 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 con codificación hash. También puedes encriptar la dirección de correo electrónico con codificación hash. |
hashedPhoneNumber |
phoneNumber |
Se establece en el número de teléfono con formato y con codificación hash. También puedes encriptar el número de teléfono con codificación hash. |
addressInfo |
address |
Se establece en un objeto AddressInfo. 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 |
No hay equivalente | No se admite para los destinos de Campaign Manager 360. |
addressInfo.state |
No hay equivalente | No se admite para los destinos de Campaign Manager 360. |
addressInfo.hashedStreetAddress |
No hay equivalente | No se admite para los destinos de Campaign Manager 360. |
Campos de datos del carrito
CartData (API de Campaign Manager 360) |
CartData (API de Data Manager) |
Notas |
|---|---|---|
kind |
No hay 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 elementos 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 |
No hay equivalente | Es un campo de metadatos que no usa la API de Data Manager. |
| No hay equivalente | itemId |
Opcional. Es un identificador único para el artículo. |
itemId |
merchantProductId |
Obligatorio. Se establece en el ID del producto de Merchant Center para el artículo. |
quantity |
quantity |
Obligatorio. |
unitPrice |
unitPrice |
Obligatorio. |