Objeto de datos ProductAudience: Administración de campañas

Artículo
08/06/2024

Define un público de productos que puede usar para los productos de remarket desde la tienda de Microsoft Merchant Center.

Nota:

Las listas dinámicas de remarketing se conocían anteriormente como audiencias de productos en Microsoft Advertising. Verá la "lista de remarketing dinámico" en la interfaz de usuario de Microsoft Advertising, pero para evitar cambios importantes, los objetos de API se siguen denominando "audiencia de productos".

Las listas dinámicas de remarketing emparejan a los clientes con productos específicos en función de lo que hayan visto, considerado o ya comprado en su sitio web. Puede usar listas dinámicas de remarketing tanto en campañas de búsqueda como en campañas de audiencia (aún no todos tienen campañas de audiencia).

Las listas dinámicas de remarketing funcionan mejor con las campañas de Shopping y las campañas de audiencia basadas en fuentes, es decir, aquellas campañas que aprovechan un identificador de tienda de Microsoft Merchant Center.

Importante

Asegúrese de editar el script correspondiente al identificador de etiqueta de UET en el sitio web para incluir los ecomm_prodid parámetros y ecomm_pagetype . El parámetro ecomm_prodid es el identificador de producto del producto en la página. Es único para cada elemento y debe coincidir con el identificador o el atributo item_group_id de la fuente de productos. Solo caracteres numéricos y alfanuméricos (incluidos guiones), con un máximo de 50 caracteres. El parámetro ecomm_pagetype identifica el tipo de página que ha visitado el usuario. Opciones válidas: home, searchresults, category, product, cart, purchase, other.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

Sintaxis

<xs:complexType name="ProductAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="ProductAudienceType" nillable="true" type="tns:ProductAudienceType" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto ProductAudience tiene los siguientes elementos: ProductAudienceType, TagId.

Elemento	Descripción	Tipo de datos
ProductAudienceType	Determina si se va a realizar el remarketing de sus productos a visitantes generales, buscadores de productos, visores de productos, abandonos de carros de la compra o compradores anteriores. Agregar: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	ProductAudienceType
TagId	Identificador de Microsoft Advertising de la etiqueta De seguimiento universal de eventos (UET) que se usa con la lista de remarketing. Antes de tomar una dependencia del identificador de etiqueta, tenga en cuenta que la etiqueta de UET se puede compartir con o desde otro cliente. Las etiquetas y audiencias de UET compartidas solo están disponibles para los clientes piloto. Para obtener información general sobre cómo compartir audiencias y etiquetas de UET en una jerarquía de clientes, consulte la guía técnica Compartir audiencias y etiquetas de UET . Agregar: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	largo

El objeto ProductAudience tiene elementos heredados.

Elementos heredados

Elementos heredados del público

El objeto ProductAudience deriva del objeto Audience y hereda los siguientes elementos: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Las descripciones siguientes son específicas de ProductAudience y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto Audience .

Elemento	Descripción	Tipo de datos
AudienceNetworkSize	El número total de personas que son miembros activos de esta audiencia en la red audience. Esto le da una idea del número de usuarios de red de audiencia a los que puede dirigirse. La audiencia debe tener al menos 300 personas antes de que Microsoft Advertising la use para las optimizaciones. Agregar: Solo lectura Actualizar: Solo lectura	largo
CustomerShare	Este elemento no es compatible con el público del producto. Puede usar un TagId compartido con audiencias de productos, pero no se puede compartir una audiencia de producto. Agregar: No compatible Actualizar: No compatible	CustomerShare
Descripción	Descripción de la audiencia. Use una descripción que le ayude a recordar el público al que se dirige. La descripción puede contener un máximo de 1024 caracteres. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
ForwardCompatibilityMap	Lista de cadenas de clave y valor para la compatibilidad con reenvíos para evitar cambios importantes en caso contrario cuando se agregan nuevos elementos en la versión actual de la API. Los cambios de compatibilidad de reenvío se anotarán aquí en futuras versiones. Actualmente no hay cambios de compatibilidad de reenvío para el objeto Audience .	Matriz KeyValuePairOfstringstring
Identificación	Identificador de Microsoft Advertising de la audiencia. Agregar: Solo lectura Actualizar: Obligatorio y de solo lectura	largo
MembershipDuration	Al crear una audiencia, puede especificar la distancia en el tiempo que Microsoft Advertising debe buscar acciones que coincidan con la definición de audiencia. La duración mínima es de 1 día y la duración máxima permitida es de 180 días. Agregar: Opcional. Si no se especifica, la duración de la pertenencia se establecerá en 30 de forma predeterminada. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	int
Nombre	Nombre de la audiencia. El nombre puede contener un máximo de 128 caracteres. Agregar: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
ParentId	Identificador de Microsoft Advertising de la cuenta o cliente. Si el ámbito se establece en Cuenta, este es el identificador de cuenta y, de lo contrario, es el identificador de cliente. Agregar: Obligatorio Actualizar: Solo lectura. No se puede cambiar el identificador primario.	largo
Ámbito	El ámbito define qué cuentas pueden usar esta audiencia. Si el ámbito está establecido en Cuenta, la audiencia solo se puede asociar a campañas y grupos de anuncios en una cuenta, es decir, a través del ParentId. Si el ámbito está establecido en Cliente, la audiencia se puede asociar a campañas y grupos de anuncios en todas las cuentas del cliente. Agregar: Obligatorio Actualizar: Opcional. Puede cambiar el ámbito de Cuenta a Cliente, pero no puede cambiar el ámbito de Cliente a Cuenta.	EntityScope
SearchSize	El número total de personas que son miembros activos de esta audiencia en la red de búsqueda. Esto le da una idea del número de usuarios de búsqueda a los que puede dirigirse. La audiencia debe tener al menos 300 personas antes de que Microsoft Advertising la use para las optimizaciones. Esta propiedad estará nula o vacía durante un máximo de 24 horas mientras se compila la audiencia, por ejemplo, si agrega o actualiza la duración de la pertenencia o el identificador de etiqueta. Agregar: Solo lectura Actualizar: Solo lectura	largo
SupportedCampaignTypes	Lista de tipos de campaña que admiten esta audiencia. Los valores admitidos son Audience, DynamicSearchAds, Search y Shopping. Es posible que en el futuro se agreguen nuevos tipos de campaña, por lo que no debe depender de un conjunto fijo de valores. Agregar: Solo lectura Actualizar: Solo lectura	matriz de cadenas
Tipo	Tipo de audiencia. Este valor es ProductAudience cuando se recupera una audiencia de producto. Para obtener más información sobre los tipos de audiencia, consulte comentarios sobre los objetos de datos de audiencia. Agregar: Solo lectura Actualizar: Solo lectura	AudienceType

Requisitos

Servicio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Compartir a través de