Objeto de Dados AccountProperty - Gestão de Campanhas

Mapeia um nome de propriedade ao nível da conta para um valor de cadeia.

Sintaxe

<xs:complexType name="AccountProperty" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Name" type="tns:AccountPropertyName" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elementos

O objeto AccountProperty tem os seguintes elementos: Nome, Valor.

Observações

Valores de Propriedade da Conta

AdClickParallelTracking

Determina se o controlo paralelo está ativado.

Se utilizar o controlo de URLs, quando os clientes clicam no seu anúncio, normalmente têm de percorrer vários redirecionamentos antes de chegarem à sua página. Isto é conhecido como controlo sequencial.

Com o controlo paralelo, quando os clientes clicam no seu anúncio, veem imediatamente a sua página de destino. Simultaneamente, o Microsoft Advertising executa os URLs de controlo em segundo plano. Assim, a experiência de utilizador dos seus clientes é melhorada e continua a ter o mesmo controlo de medição excelente.

Tem de ter {lpurl} ou uma das respetivas variantes no modelo de controlo do URL para que o controlo paralelo funcione. Para obter mais informações, veja O controlo paralelo leva os clientes à sua página de destino mais rapidamente e Que parâmetros de controlo ou URL posso utilizar?.

Se o elemento Nome estiver definido como AdClickParallelTracking, o Valor devolvido pode ser verdadeiro ou falso. Se o valor for verdadeiro, o controlo paralelo é ativado.

AllowImageAutoRetrieve

Determina se o Microsoft Advertising tem permissão para utilizar imagens do seu domínio para melhorar os seus anúncios na Rede de Audiências da Microsoft.

Se o elemento Nome estiver definido como AllowImageAutoRetrieve, o Valor pode ser definido como verdadeiro ou falso. Se o valor for verdadeiro, a funcionalidade de obtenção automática da imagem está ativada.

AutoApplyRecommendations

Determina se o Microsoft Advertising tem permissão para aplicar automaticamente recomendações de anúncios destinadas a ajudá-lo a aumentar o desempenho de anúncios.

Informá-lo-emos quando os anúncios sugeridos estiverem prontos para serem revistos. Pode encontrar recomendações de anúncios na página Recomendações. Se não tomar medidas, iremos aplicá-las automaticamente após o período de revisão:

• Anúncios multimédia: 7 dias
• Todos os outros: 14 dias

Pode alterar as opções de aplicação automática em qualquer altura. Se optar por não aplicar automaticamente recomendações de anúncios, continuará a poder aplicar recomendações manualmente.

Se o elemento Nome estiver definido como AutoApplyRecommendations, o Valor pode incluir uma lista de tipos de recomendação.

No elemento Valor , a lista de pares chave e valor é delimitada com um ponto e vírgula (;). Neste exemplo, a aplicação automática de recomendações de anúncios está ativada para anúncios multimédia, mas não para anúncios de pesquisa reativos ou anúncios de texto expandido.

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>AutoApplyRecommendations</Name>
      <Value>MultimediaAdsAutoApply=true;ResponsiveSearchAdsAutoApply=false;ExpandedTextAdsAutoApply=false</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

Os pares chave e valor predefinidos são:

• MultimediaAdsAutoApply=true;
• ResponsiveSearchAdsAutoApply=false;
• ExpandedTextAdsAutoApply=false;

Se o valor de uma chave estiver definido como verdadeiro, a funcionalidade de aplicação automática está ativada para o tipo de recomendação.

Pode optar por definir apenas os pares chave e valor que pretende atualizar. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.

EmpresasAttributes

Permite-lhe realçar os principais valores empresariais destinados a ajudá-lo a aumentar o desempenho dos anúncios.

Os atributos empresariais são opcionais e pode escolher um ou mais atributos que se aplicam à sua empresa.

Se o elemento Nome estiver definido como BusinessAttributes, o Valor pode incluir uma lista de tipos de atributos.

No elemento Valor , a lista de atributos empresariais é delimitada com um ponto e vírgula (;). Os valores possíveis incluem: AlcoholFree, AllergyFriendly, AsianOwned, BlackOwned, CarbonNegative, CarbonNeutral, CrueltyFree, DiabéticoFriendly, EcoFriendly, FamilyFriendly, FamilyOwned, GlutenFree, Halal, HearingAssistance, Kosher, LatinOwned, LocalBusiness, LGBTQIFriendly, LGBTQIOwned, MinorityOwned, MobilityAssistance, NoContactDelivery, Nonprofit, PetFriendly, SmallBusiness, SupportACure, SupportDiseaseResearch, Sustainable, Vegan, VisualAssistance, TouchlessPickup, Unisex, WebAccessibility, WheelchairAccessible e WomenOwned.

Neste exemplo, Sem álcool, Propriedade da família e Vegan são os atributos empresariais selecionados.

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>BusinessAttributes</Name>
      <Value>AlcoholFree;FamilyOwned;Vegan</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

Se o atributo aparecer na propriedade value, é selecionado; se o atributo não aparecer na propriedade value, não está selecionado.

Para eliminar os atributos empresariais da conta, defina o Nome como BusinessAttributes e o Valor como "" (cadeia vazia).

Pode optar por definir apenas os atributos empresariais que pretende atualizar. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.

FinalUrlSuffix

Se o elemento Nome estiver definido como FinalUrlSuffix, o Valor representa o Sufixo de URL Final da sua conta.

O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos.

Para eliminar o Sufixo de URL Final da conta, defina o Nome como FinalUrlSuffix e o Valor como "" (cadeia vazia).

IncludeViewThroughConversions

Determina se pretende incluir conversões de visualização para campanhas na conta.

As conversões view-through são conversões que as pessoas fazem depois de verem o seu anúncio, apesar de não terem clicado no anúncio.

Se o elemento Nome estiver definido como IncludeViewThroughConversions, o Valor pode ser definido como verdadeiro ou falso. Se o valor for verdadeiro, as conversões view-through serão incluídas. Por predefinição, se estiver no piloto de funcionalidades (GetCustomerPilotFeatures devolve 616), esta propriedade é definida como verdadeira, o que significa que os valores nas colunas de conversões "Todos" dos seus relatórios de desempenho incluirão conversões de visualização. Pode optar por desativá-la se não quiser incluir conversões de visualização.

MSCLKIDAutoTaggingEnabled

Determina se a identificação automática do parâmetro de cadeia de consulta MSCLKID está ativada. O MSCLKID é um GUID de 32 carateres exclusivo para cada clique de anúncio.

Se o elemento Nome estiver definido como MSCLKIDAutoTaggingEnabled, o Valor pode ser definido como verdadeiro ou falso. Se o valor for verdadeiro, a funcionalidade de etiquetagem automática MSCLKID está ativada. Poderá querer ativar a identificação automática de MSCLKID para controlar oportunidades potenciais através de objetivos de conversão offline. Se a marcação automática de MSCLKID estiver ativada, o MSCLKID é automaticamente anexado ao URL da página de destino quando um cliente clica no seu anúncio. Por exemplo, www.contoso.com/?msclkid={msclkid}. O ID de clique é exclusivo para cada clique de anúncio e múltiplos cliques no mesmo anúncio do mesmo utilizador resultarão em vários IDs de clique.

ProfileExpansionEnabled

Determina se pretende expandir a segmentação de perfis do LinkedIn na sua conta para alcançar clientes adicionais semelhantes aos que tem atualmente como destino.

Ativar a expansão de filtragem de perfis permite que o Microsoft Advertising mostre os seus anúncios a clientes adicionais semelhantes aos que tem atualmente como destino. Por exemplo, se segmentar um segmento de audiência específico do LinkedIn, também iremos direcionar os utilizadores do Bing que não têm uma conta do LinkedIn confirmada, mas que partilham as mesmas características que os utilizadores do LinkedIn nesse segmento.

Se o elemento Nome estiver definido como ProfileExpansionEnabled, o Valor pode ser definido como verdadeiro ou falso. Se o valor for verdadeiro, a funcionalidade de expansão de filtragem do perfil do LinkedIn está ativada.

TrackingUrlTemplate

Se o elemento Nome estiver definido como TrackingUrlTemplate, o Valor representa o modelo de controlo da sua conta a utilizar como predefinição para todos os URLs na sua conta. O valor da chave TrackingUrlTemplate pode ser definido como qualquer cadeia válida, conforme descrito abaixo.

• Modelos de controlo definidos para entidades de nível inferior, por exemplo, a palavra-chave substitui os conjuntos para entidades de nível superior, por exemplo, campanha. Para obter mais informações, veja Limites de Entidades.

• O comprimento do modelo de controlo está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.

• O modelo de controlo tem de ser um URL bem formado, começando por um dos seguintes: http://, https://, {lpurl} ou {unescapedlpurl}.

• Tem de incluir, pelo menos, um dos seguintes parâmetros de URL da página de destino: {lpurl}, {lpurl+2}, {lpurl+3}, {unescapedlpurl}, {escapeedlpurl}. Além disso, pode utilizar qualquer parâmetro dinâmico suportado pelo Microsoft Advertising. Para obter uma lista dos parâmetros suportados, consulte as secções Parâmetros disponíveis no artigo de ajuda do Microsoft Advertising Configurar um modelo de controlo.

• O Microsoft Advertising não valida se existem parâmetros personalizados. Se utilizar parâmetros personalizados no seu modelo de controlo e estes não existirem, o URL final incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o modelo de controlo for, por exemplo https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, palavra-chave ou nível de anúncio, o URL final será o mesmo.

Para eliminar o modelo de controlo da conta, defina o Nome como TrackingUrlTemplate e o Valor como "" (cadeia vazia).

Requisitos

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

Utilizado Por

GetAccountProperties
SetAccountProperties