RemarketingList Data Object - Gestão de Campanhas

Artigo
11/13/2024

Define uma lista de remarketing.

Sugestão

Para obter uma descrição geral da implementação, veja o Guia técnico do Controlo de Eventos Universal .

Nota

O Microsoft Advertising irá gerar automaticamente audiências semelhantes para listas de remarketing se for um participante piloto. Não pode criar ou editar a audiência semelhante para uma lista de remarketing. Dito isto, pode adicionar e eliminar associações e exclusões de listas de remarketing semelhantes. Se eliminar a lista de remarketing de origem, a audiência semelhante também será eliminada. Se uma audiência semelhante estiver associada a uma campanha ou grupo de anúncios, não poderá eliminar a lista de remarketing de origem. Veja SimilarRemarketingList para obter mais detalhes.

<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>

{
  "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

O objeto RemarketingList tem os seguintes elementos: Rule, TagId.

Elemento	Descrição	Tipo de Dados
Regra	Uma regra inclui condições utilizadas para determinar quem adicionar à sua lista de remarketing. Pode escolher um dos quatro tipos de regras para direcionar diferentes audiências: CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule e PageVisitorsWhoVisitedAnotherPageRule. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se quiser manter qualquer um dos itens de regra anteriores, tem de defini-los explicitamente novamente durante a atualização. Pode optar por alterar o tipo de regra durante a atualização.	RemarketingRule
TagId	O identificador do Microsoft Advertising da etiqueta Deteção de Eventos Universais (UET) que é utilizada com a lista de remarketing. Antes de assumir uma dependência do ID da etiqueta, tenha em atenção que a etiqueta UET pode ser partilhada com ou a partir de outro cliente. As etiquetas e audiências UET partilhadas só estão disponíveis para clientes piloto. Para obter uma descrição geral da partilha de audiências e etiquetas UET numa hierarquia de clientes, consulte o guia técnico Partilhar Audiências e Etiquetas UET . Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Longo

O objeto RemarketingList tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da Audiência

O objeto RemarketingList deriva do objeto Audiência e herda os seguintes elementos: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. As descrições abaixo são específicas de RemarketingList e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Audiência .

Elemento	Descrição	Tipo de Dados
AudienceNetworkSize	O número total de pessoas que são membros ativos desta audiência na rede audiência. Isto dá-lhe uma ideia do número de utilizadores de rede de Audiência que pode direcionar. O público precisa de ter, pelo menos, 300 pessoas antes de o Microsoft Advertising o utilizar para otimizações. Adicionar: Só de leitura Atualização: Só de leitura	Longo
CustomerShare	Determina a lista de clientes e contas que partilham a audiência. Os detalhes incluem contagens de associação de audiências. As etiquetas e audiências UET partilhadas só estão disponíveis para clientes piloto. Para obter uma descrição geral da partilha de audiências e etiquetas UET numa hierarquia de clientes, consulte o guia técnico Partilhar Audiências e Etiquetas UET . Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Defina este elemento como nulo ou vazio para manter quaisquer partilhas de conta de cliente existentes. Para remover todas as partilhas de conta de cliente, defina o elemento CustomerAccountShares do objeto CustomerShare como nulo ou vazio. Para remover um subconjunto de partilhas de conta de cliente, especifique as partilhas de conta de cliente que pretende manter no elemento CustomerAccountShares do objeto CustomerShare .	CustomerShare
Descrição	A descrição da audiência. Utilize uma descrição para o ajudar a lembrar-se da audiência que está a direcionar. A descrição pode conter um máximo de 1024 carateres. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	cadeia
ForwardCompatibilityMap	A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API. As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para o objeto Audiência .	Matriz KeyValuePairOfstringstring
ID	O identificador do Microsoft Advertising da audiência. Adicionar: Só de leitura Atualização: Obrigatório e só de leitura	Longo
MembershipDuration	Quando cria uma audiência, pode especificar até que ponto o Microsoft Advertising deve procurar ações que correspondam à definição da sua audiência. A duração mínima é de 1 dia e a duração máxima permitida é de 180 dias. Adicionar: Opcional. Se não for especificado, a duração da associação será definida como 30 por predefinição. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	int
Nome	O nome da audiência. O nome pode conter um máximo de 128 carateres. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	cadeia
ParentId	O identificador do Microsoft Advertising da conta ou cliente. Se o Âmbito estiver definido como Conta, este é o ID da conta e, caso contrário, é o ID do cliente. Adicionar: Necessário Atualização: Só de leitura. Não pode alterar o ID principal.	Longo
Âmbito	O âmbito define que contas podem utilizar esta audiência. Se o âmbito estiver definido como Conta, a audiência só pode ser associada a campanhas e grupos de anúncios numa conta, ou seja, através do ParentId. Se o âmbito estiver definido como Cliente, a audiência pode ser associada a campanhas e grupos de anúncios em todas as contas do cliente. Adicionar: Necessário Atualização: Opcional. Pode alterar o âmbito de Conta para Cliente, mas não pode alterar o âmbito de Cliente para Conta.	EntityScope
SearchSize	O número total de pessoas que são membros ativos desta audiência na rede de Pesquisa. Isto dá-lhe uma ideia do número de utilizadores de pesquisa que pode direcionar. O público precisa de ter, pelo menos, 300 pessoas antes de o Microsoft Advertising o utilizar para otimizações. Esta propriedade ficará vazia até 24 horas enquanto a audiência estiver a ser criada, por exemplo, se adicionar ou atualizar a duração, regra ou identificador de etiquetas da lista de remarketing. Esta propriedade será nula ou vazia se a etiqueta UET associada à lista de remarketing tiver o estado Não Verificado ou Inativo, porque a lista de remarketing não pode receber as informações do cliente do seu site de que precisa para criar a lista. Adicionar: Só de leitura Atualização: Só de leitura	Longo
SupportedCampaignTypes	A lista de tipos de campanha que suportam esta audiência. Os valores suportados são Audience, DynamicSearchAds, Search e Shopping. Poderão ser adicionados novos tipos de campanha no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores. Adicionar: Só de leitura Atualização: Só de leitura	matriz de cadeia
Tipo	O tipo de audiência. Este valor é RemarketingList quando obtém uma audiência de lista de remarketing. Para obter mais informações sobre os tipos de audiência, veja Comentários sobre Objetos de Dados de Audiência. Adicionar: Só de leitura Atualização: Só de leitura	AudienceType

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Partilhar via