Objeto de Dados InMarketAudience - Gestão de Campanhas

Artigo
11/13/2024

Define uma audiência no mercado.

Nota

Não pode adicionar, atualizar ou eliminar uma audiência no mercado com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiências no mercado. A API de Anúncios do Bing devolverá sempre todas as audiências atualmente ativas no mercado. O serviço não devolve audiências eliminadas no mercado ou qualquer transferência delta para ver o que mudou. As audiências no mercado devolvidas através da API de Anúncios do Bing são uma união de todas as audiências disponíveis no mercado em todos os mercados, por exemplo, AU, CA, DE, FR, UK e EUA. AudienceNetworkSize e SearchSize são uma soma de tamanhos de listas em todos os mercados suportados para uma determinada audiência no mercado na rede correspondente. A API de Anúncios do Bing não fornece detalhes sobre os tamanhos de lista por mercado. Por exemplo, o tamanho da audiência no mercado "Publicidade e Marketing" na rede de pesquisa pode ser devolvido como 17070879 (17,1 M) através da API de Anúncios do Bing. A discriminação por mercado mostrada na aplicação Web Microsoft Advertising pode ser: 2,88M nos EUA; 474 K na UA; 13,7 M no Reino Unido.
Não deve assumir quaisquer dependências nas audiências do sandbox no mercado. Algumas audiências no mercado estão disponíveis no sandbox, mas não em produção. Os valores de propriedade de audiência no mercado também podem diferir entre sandbox e produção, por exemplo, o nome e o tamanho da audiência.

Nota

Esta funcionalidade está disponível na Austrália, Canadá, França, Alemanha, Reino Unido e Estados Unidos.

Sugestão

Para obter uma descrição geral das audiências no mercado, consulte o tópico de ajuda Sobre audiências no mercado .

<xs:complexType name="InMarketAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <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": "InMarket"
}

Elementos

O objeto InMarketAudience tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da Audiência

O objeto InMarketAudience 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 InMarketAudience 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. Adicionar: Não suportado Atualização: Não suportado	Longo
CustomerShare	Este elemento não é suportado para audiências no mercado. Adicionar: Não suportado Atualização: Não suportado	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: Não suportado Atualização: Não suportado	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: Não suportado Atualização: Não suportado	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: Não suportado Atualização: Não suportado	int
Nome	O nome da audiência. O nome pode conter um máximo de 128 carateres. Adicionar: Não suportado Atualização: Não suportado	cadeia
ParentId	O identificador do Microsoft Advertising do cliente que contém a audiência no mercado. Adicionar: Não suportado Atualização: Não suportado	Longo
Âmbito	O âmbito define que contas podem utilizar esta audiência. Para uma audiência no mercado, o único âmbito suportado é o Cliente e o público pode ser associado a campanhas e grupos de anúncios em todas as contas do cliente. Adicionar: Não suportado Atualização: Não suportado	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. Adicionar: Não suportado Atualização: Não suportado	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: Não suportado Atualização: Não suportado	matriz de cadeia
Tipo	O tipo de audiência. Este valor é InMarket quando obtém uma audiência no mercado. Para obter mais informações sobre os tipos de audiência, veja Comentários sobre Objetos de Dados de Audiência. Adicionar: Não suportado Atualização: Não suportado	AudienceType

Requisitos

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

Partilhar via