Asignaciones de campo

Usa las asignaciones de las tablas para asignar los métodos y campos de administración de públicos de la Segmentación por clientes en la API de Display & Video 360 a su equivalente en la API de Data Manager.

Autenticación

La API de Data Manager requiere credenciales con un alcance diferente al de la API de Display & Video 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.

Asignación de métodos

En la siguiente tabla, se asignan los métodos de la API de Display & Video 360 a los métodos equivalentes de la API de Data Manager:

Métodos de la API de Display & Video 360 Métodos de la API de Data Manager Notas
firstPartyAndPartnerAudiences.get userLists.get La API de Data Manager solo puede recuperar públicos de Segmentación por clientes.
firstPartyAndPartnerAudiences.list userLists.list La API del Administrador de datos solo devolverá públicos de Segmentación por clientes.
firstPartyAndPartnerAudiences.create userLists.create Los datos del usuario se deben subir en una solicitud posterior en la API de Data Manager.
No hay equivalente userLists.delete No está disponible en la API de Display & Video 360.
firstPartyAndPartnerAudiences.patch userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.ingest Se utilizan métodos independientes de la API de Data Manager para agregar y quitar miembros de los públicos de Segmentación por clientes.
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.remove Se utilizan métodos independientes de la API de Data Manager para agregar y quitar miembros de los públicos de Segmentación por clientes.
No hay equivalente audienceMembers.removeAll La API de Data Manager admite la eliminación de todos los miembros de un público con una sola solicitud.

Asignación de solicitudes

En las siguientes tablas, se asignan los campos de solicitud de los métodos de la API de Display & Video 360 a sus equivalentes en la API de Data Manager.

userLists.get

firstPartyAndPartnerAudiences.get (API de Display & Video 360) userLists.get (API de Data Manager) Notas
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
 name El nombre de UserList contiene el ID del anunciante o socio superior, así como el ID del público. Consulta Nombres de recursos para obtener más detalles.

userLists.list

firstPartyAndPartnerAudiences.list (API de Display & Video 360) userLists.list (API de Data Manager) Notas
  • advertiserId
  • partnerId
 parent parent contiene el ID del anunciante o socio principal.
pageSize pageSize El tamaño máximo de página en la API de Data Manager es 1000.
pageToken pageToken
filter filter
orderBy No hay equivalente

userLists.create

firstPartyAndPartnerAudiences.create (API de Display & Video 360) userLists.create (API de Data Manager) Notas
  • advertiserId
  • partnerId
 parent parent contiene el ID del anunciante o socio superior del público nuevo.
No hay equivalente validateOnly
Cuerpo de la solicitud FirstPartyAndPartnerAudience Cuerpo de la solicitud de UserList Consulta UserList para ver la asignación del cuerpo de la solicitud.

userLists.update

firstPartyAndPartnerAudiences.patch (API de Display & Video 360) userLists.patch (API de Data Manager) Notas
  • advertiserId
  • firstPartyAndPartnerAudienceId
 Parámetro userList.name Es el nombre del recurso de UserList que se actualizará.
updateMask updateMask Este campo es recomendado, pero no obligatorio, en la API de Data Manager y, si se deja vacío, se reemplazarán por completo todos los campos incluidos.
No hay equivalente validateOnly
Cuerpo de la solicitud FirstPartyAndPartnerAudience Cuerpo de la solicitud UserList Consulta UserList para ver la asignación del cuerpo de la solicitud.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (API de Display & Video 360) audienceMembers.ingest (API de Data Manager) Notas
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations Consulta Cómo configurar destinos para obtener más detalles.
addedContactInfoList.contactInfos audienceMembers Los identificadores de usuario individuales se pueden establecer en el campo compositeData.userData dentro de los objetos AudienceMember. Consulta Identificadores de usuario para obtener más detalles.
addedContactInfoList.consent consent El consentimiento también se puede establecer en objetos AudienceMember individuales.
addedMobileDeviceIdList.mobileDeviceIds audienceMembers Los IDs de dispositivos móviles individuales se configuran en el campo mobileData dentro de los objetos AudienceMember.
addedMobileDeviceIdList.consent consent El consentimiento también se puede establecer en objetos AudienceMember individuales.
No hay equivalente validateOnly
No hay equivalente encoding Obligatorio. Se establece en el Encoding que se usa para los valores de UserIdentifier.
No hay equivalente encryptionInfo Se establece si la solicitud contiene valores encriptados. Consulta Encriptación para obtener más detalles.
No hay equivalente termsOfService Obligatorio. Se establece para indicar que el usuario aceptó o rechazó las Condiciones del Servicio de la Segmentación por clientes.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (API de Display & Video 360) audienceMembers.remove (API de Data Manager) Notas
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations
removedContactInfoList.contactInfos audienceMembers Los identificadores de usuario individuales se pueden establecer en el campo compositeData.userData dentro de los objetos AudienceMember. Consulta Identificadores de usuario para obtener más detalles.
removedMobileDeviceIdList.mobileDeviceIds audienceMembers Los IDs de dispositivos móviles individuales se configuran en el campo mobileData dentro de los objetos AudienceMember.
No hay equivalente validateOnly
No hay equivalente encoding Obligatorio. Se establece en el Encoding que se usa para los valores de UserIdentifier.
No hay equivalente encryptionInfo Se establece si la solicitud contiene valores encriptados. Consulta Encriptación para obtener más detalles.

Asociaciones de campos de objetos

Aquí se muestran las asignaciones de los objetos de la API de Display & Video 360 a los objetos equivalentes en la API de Data Manager.

UserList

FirstPartyAndPartnerAudience (API de Display & Video 360) UserList (API de Data Manager) Notas
name name Usa un formato de nombre de recurso diferente. Consulta Nombres de recursos para obtener más detalles.
firstPartyAndPartnerAudienceId id
No hay equivalente readOnly
displayName displayName
description description
No hay equivalente membershipStatus
No hay equivalente integrationCode
membershipDurationDays membershipDuration
No hay equivalente closingReason
No hay equivalente accessReason
No hay equivalente accountAccessStatus
displayAudienceSize sizeInfo.displayNetworkMembersCount
No hay equivalente sizeInfo.searchNetworkMembersCount
No hay equivalente targetNetworkInfo
No hay equivalente ingestedUserListInfo
firstPartyAndPartnerAudienceType No hay equivalente
audienceType No hay equivalente
audienceSource No hay equivalente
activeDisplayAudienceSize No hay equivalente
youtubeAudienceSize No hay equivalente
gmailAudienceSize No hay equivalente
displayMobileAppAudienceSize No hay equivalente
displayMobileWebAudienceSize No hay equivalente
displayDesktopAudienceSize No hay equivalente
appId ingestedUserListInfo.mobileIdInfo.appId
contactInfoList Métodos audienceMembers En la API de Data Manager, agrega y quita miembros con los métodos ingest, remove y removeAll de audienceMembers.
mobileDeviceIdList Métodos audienceMembers En la API de Data Manager, agrega y quita miembros con los métodos ingest, remove y removeAll de audienceMembers.

Nombres de recursos

La API de Data Manager usa un formato de nombre de recurso diferente al de la API de Display & Video 360.

API de Display & Video 360

En la API de Display & Video 360, un nombre de recurso UserList usa un formato que solo contiene el ID del público:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

API de Data Manager

En la API de Data Manager, un nombre de recurso UserList usa un formato que contiene el ID del público, así como el AccountType y el ID de cuenta del socio o anunciante propietario del público:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

Identificadores de usuario

Si bien userData todavía se admite, te recomendamos que uses compositeData para asegurarte de que tu integración esté preparada para futuras mejoras. Consulta Datos compuestos para obtener más detalles.

ContactInfo (API de Display & Video 360) CompositeData (API de Data Manager) Notas
hashedEmails userData.userIdentifiers.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. Se pueden usar varios correos electrónicos para que coincidan con un solo usuario con varios objetos UserIdentifier.
hashedPhoneNumbers userData.userIdentifiers.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. Se pueden usar varios números de teléfono para que coincidan con un solo usuario con varios objetos UserIdentifier.
hashedFirstName userData.userIdentifiers.address.givenName Se establece en el nombre de pila con formato y codificación hash. También puedes encriptar el nombre con codificación hash.
hashedLastName userData.userIdentifiers.address.familyName Se establece en el apellido con formato y con codificación hash. También puedes encriptar el apellido con codificación hash.
countryCode userData.userIdentifiers.address.regionCode
zipCodes userData.userIdentifiers.address.postalCode Se pueden usar varios códigos postales para que coincidan con un solo usuario con varios objetos UserIdentifier.

Destino

API de Display & Video 360 Destination (API de Data Manager) Notas
Es el ID del anunciante o socio al que se le otorgó acceso al usuario de Display & Video 360. loginAccount Esto solo se debe configurar en una situación de acceso de socio de Display & Video 360, en la que el público se encuentra en un anunciante, pero al usuario de Display & Video 360 que accede se le otorgó acceso al socio superior del anunciante. De lo contrario, se puede dejar sin configurar.
Es el ID del anunciante o socio principal del público. operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
No hay equivalente reference
Anterior
Pasos para la actualización