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

Define una lista de remarketing.

Sugerencia

Para obtener información general sobre la implementación, consulte la guía técnica de Seguimiento universal de eventos .

Nota:

Microsoft Advertising generará automáticamente audiencias similares para las listas de remarketing si es un participante piloto. No puede crear ni editar la audiencia similar para una lista de remarketing. Dicho esto, puede agregar y eliminar asociaciones y exclusiones de listas de remarketing similares. Si elimina la lista de remarketing de origen, también se eliminará la audiencia similar. Si una audiencia similar está asociada a una campaña o grupo de anuncios, no puede eliminar la lista de remarketing de origen. Consulta SimilarRemarketingList para obtener más detalles.

XML

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

JSON

{
  "AudienceNetworkSize": "LongValueHere",
  "CustomerShare": {
    "CustomerAccountShares": [
      {
        "AccountId": "LongValueHere",
        "Associations": [
          {
            "AssociationCount": "LongValueHere",
            "UsageType": "ValueHere"
          }
        ],
        "CustomerId": "LongValueHere"
      }
    ],
    "OwnerCustomerId": "LongValueHere"
  },
  "Description": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "MembershipDuration": IntValueHere,
  "Name": "ValueHere",
  "ParentId": "LongValueHere",
  "Scope": "ValueHere",
  "SearchSize": "LongValueHere",
  "SupportedCampaignTypes": [
    "ValueHere"
  ],
  "Type": "RemarketingList",
  "Rule": {
    "Type": "CustomEvents",
    "Action": "ValueHere",
    "ActionOperator": "ValueHere",
    "Category": "ValueHere",
    "CategoryOperator": "ValueHere",
    "Label": "ValueHere",
    "LabelOperator": "ValueHere",
    "Value": DecimalValueHere,
    "ValueOperator": "ValueHere"
  },
  "TagId": "LongValueHere"
}

Elementos

El objeto RemarketingList tiene los siguientes elementos: Rule, TagId.

Elemento	Descripción	Tipo de datos
Rule	Una regla incluye las condiciones que se usan para determinar a quién agregar a la lista de remarketing. Puede elegir uno de los cuatro tipos de reglas para dirigirse a audiencias diferentes: CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule y PageVisitorsWhoVisitedAnotherPageRule. Agregar: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si desea conservar cualquiera de los elementos de regla anteriores, debe volver a establecerlos explícitamente durante la actualización. Puede elegir cambiar el tipo de regla durante la actualización.	RemarketingRule
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 RemarketingList tiene elementos heredados.

Elementos heredados

Elementos heredados del público

El objeto RemarketingList 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 RemarketingList 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	Determina la lista de clientes y cuentas que comparten la audiencia. Entre los detalles se incluyen los recuentos de asociaciones de audiencias. 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: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Establezca este elemento en null o vacío para conservar los recursos compartidos de cuenta de cliente existentes. Para quitar todos los recursos compartidos de cuentas de cliente, establezca el elemento CustomerAccountShares del objeto CustomerShare en null o vacío. Para quitar un subconjunto de recursos compartidos de cuentas de cliente, especifique los recursos compartidos de cuenta de cliente que desea conservar en el elemento CustomerAccountShares del objeto CustomerShare .	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á vacía o nula durante un máximo de 24 horas mientras se compila la audiencia, por ejemplo, si agrega o actualiza la duración, la regla o el identificador de etiqueta de la lista de remarketing. Esta propiedad será nula o vacía si la etiqueta de UET asociada a la lista de remarketing tiene un estado Desverificado o Inactivo, ya que la lista de remarketing no puede recibir la información del cliente de su sitio web que necesita para crear la lista. 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 RemarketingList cuando se recupera una audiencia de lista de remarketing. 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