Asignaciones de campo

Usa las asignaciones de las tablas para correlacionar los métodos y campos de administración de públicos de la Segmentación por clientes en la API de Display & Video 360 con sus equivalentes en 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 de Data Manager solo devolverá públicos de la 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.
Sin equivalente userLists.delete No está disponible en la API de Display & Video 360.
firstPartyAndPartnerAudiences.patch userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.ingest Se usan métodos separados 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 usan métodos separados de la API de Data Manager para agregar y quitar miembros de los públicos de Segmentación por clientes.

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 socio o anunciante principal, 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 socio o anunciante principal.
pageSize pageSize El tamaño máximo de página en la API de Data Manager es de 1000.
pageToken pageToken
filter filter
orderBy Sin 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 socio o anunciante principal del público nuevo.
Sin equivalente validateOnly
Cuerpo de la solicitud de 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 El nombre del recurso del UserList que se actualizará.
updateMask updateMask Este campo se recomienda, pero no es obligatorio en la API de Data Manager, y generará un reemplazo completo de todos los campos incluidos si se deja vacío.
Sin equivalente validateOnly
Cuerpo de la solicitud de FirstPartyAndPartnerAudience Cuerpo de la solicitud de 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 Configura destinos para obtener más detalles.
addedContactInfoList.contactInfos audienceMembers Los identificadores de usuarios 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.
Sin equivalente validateOnly
Sin equivalente encoding Obligatorio. Se establece en el Encoding que se usa para los valores de UserIdentifier.
Sin equivalente encryptionInfo Indica si la solicitud contiene valores encriptados. Consulta Encriptación para obtener más detalles.
Sin equivalente termsOfService Obligatorio. Se configura 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 usuarios 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.
Sin equivalente validateOnly
Sin equivalente encoding Obligatorio. Se establece en el Encoding que se usa para los valores de UserIdentifier.
Sin equivalente encryptionInfo Indica si la solicitud contiene valores encriptados. Consulta Encriptación para obtener más detalles.

Asignaciones de campos de objetos

A continuación, 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
Sin equivalente readOnly
displayName displayName
description description
Sin equivalente membershipStatus
Sin equivalente integrationCode
membershipDurationDays membershipDuration
Sin equivalente closingReason
Sin equivalente accessReason
Sin equivalente accountAccessStatus
displayAudienceSize sizeInfo.displayNetworkMembersCount
Sin equivalente sizeInfo.searchNetworkMembersCount
Sin equivalente targetNetworkInfo
Sin equivalente ingestedUserListInfo
firstPartyAndPartnerAudienceType Sin equivalente
audienceType Sin equivalente
audienceSource Sin equivalente
activeDisplayAudienceSize Sin equivalente
youtubeAudienceSize Sin equivalente
gmailAudienceSize Sin equivalente
displayMobileAppAudienceSize Sin equivalente
displayMobileWebAudienceSize Sin equivalente
displayDesktopAudienceSize Sin equivalente
appId ingestedUserListInfo.mobileIdInfo.appId
contactInfoList Métodos audienceMembers En la API de Data Manager, agrega y quita miembros con los métodos ingest y remove de audienceMembers.
mobileDeviceIdList Métodos audienceMembers En la API de Data Manager, agrega y quita miembros con los métodos ingest y remove 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, el nombre de un 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, el nombre de un recurso UserList usa un formato que contiene el ID del público, así como el AccountType y el ID de la cuenta del socio o anunciante propietario del público:

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

Identificadores de usuario

Si bien userData aún es compatible, 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 hash. También puedes encriptar la dirección de correo electrónico hasheada. Se pueden usar varios correos electrónicos para hacer coincidir a un solo usuario con varios objetos UserIdentifier.
hashedPhoneNumbers userData.userIdentifiers.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. Se pueden usar varios números de teléfono para correlacionar a un solo usuario con varios objetos UserIdentifier.
hashedFirstName userData.userIdentifiers.address.givenName Se establece en el nombre proporcionado con formato y hash. También puedes encriptar el nombre proporcionado con hash.
hashedLastName userData.userIdentifiers.address.familyName Se establece en el nombre de familia con formato y hash. También puedes encriptar el nombre de la familia hasheado.
countryCode userData.userIdentifiers.address.regionCode
zipCodes userData.userIdentifiers.address.postalCode Se pueden usar varios códigos postales para hacer coincidir a 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 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 se le otorgó acceso al socio principal del anunciante al usuario de Display & Video 360 que accede. De lo contrario, se puede dejar sin configurar.
Es el ID del anunciante principal o socio del público. operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
Sin equivalente reference
Anterior
Pasos para la actualización