TextAd Data Object - Gestão de Campanhas

Artigo
12/21/2023

Define um anúncio de texto.

Importante

A partir de abril de 2020, a entrega de anúncios de texto em standart (STA) não é suportada.

Os Anúncios de Texto Padrão foram preteridos a favor de Anúncios de Texto Expandido (EXTAs). O suporte para adicionar e atualizar anúncios de texto padrão (STAs) terminou a 31 de julho de 2017. Agora, os anunciantes podem obter e eliminar, mas já não podem adicionar novas STAs ou atualizar anúncios de texto padrão existentes. Uma exceção à regra é que ainda pode atualizar o estado STA, por exemplo, de Ativo para Em Pausa. Caso contrário, as tentativas de adicionar ou atualizar STAs resultarão no erro CampaignServiceAdTypeInvalid .

Sintaxe

<xs:complexType name="TextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto TextAd tem os seguintes elementos: DestinationUrl, DisplayUrl, Text, Title.

Elemento	Descrição	Tipo de Dados
DestinationUrl	O URL da página Web para onde levar o utilizador quando clica no anúncio. O URL pode conter parâmetros dinâmicos, como {MatchType}. Para obter uma lista dos parâmetros suportados, veja o artigo ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?. O URL pode conter um máximo de 1024 carateres. Se o URL não especificar um protocolo, o sistema utiliza o protocolo HTTP quando um utilizador clica no anúncio. Se o URL especificar o protocolo HTTP ao adicionar um anúncio, o serviço removerá a cadeia de protocolo http:// (a cadeia de protocolo HTTP não conta com o limite de 1024 carateres); no entanto, o serviço não removerá uma cadeia de protocolo HTTPS (https://) do URL. Importante: Se estiver a utilizar atualmente URLs de Destino, tem de substituí-los por URLs Finais. Para obter mais informações, veja Controlo de URLs com URLs Atualizados. Este URL só é utilizado se a palavra-chave não especificar um URL de destino. Adicionar: Não suportado Atualização: Não suportado	cadeia
DisplayUrl	O URL a apresentar no anúncio. O subdiretório do URL de apresentação pode conter cadeias de texto dinâmicas, como {keyword}; no entanto, o nome do anfitrião do URL não pode conter texto dinâmico. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos. O comprimento máximo de entrada do URL é de 200 carateres e pode conter cadeias de texto dinâmicas. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 35 carateres após a substituição de texto dinâmico ocorrer. Adicionar: Não suportado Atualização: Não suportado	cadeia
Text	A cópia de anúncios. A cópia tem de conter, pelo menos, uma palavra. A cópia e o título combinados do anúncio têm de ter, pelo menos, três palavras. O texto pode conter cadeias de texto dinâmicas, como {keyword}. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos. O comprimento máximo de entrada da cópia é de 300 carateres e pode conter cadeias de texto dinâmicas. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 71 carateres após a substituição de texto dinâmico ocorrer. Tenha em atenção que, para grupos de anúncios que utilizam chinês tradicional, o texto está limitado a 38 carateres após a substituição. O texto não pode conter o caráter newline (\n). Adicionar: Não suportado Atualização: Não suportado	cadeia
Cargo	O título do anúncio. O título tem de conter, pelo menos, uma palavra. A cópia e o título combinados do anúncio têm de ter, pelo menos, três palavras. O título pode conter cadeias de texto dinâmicas, como {keyword}. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos. O comprimento máximo de entrada do título é de 80 carateres e pode conter cadeias de texto dinâmicas. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 25 carateres após a substituição de texto dinâmico ocorrer. Tenha em atenção que, para grupos de anúncios que utilizam chinês tradicional, o título está limitado a 15 carateres após a substituição. O título não pode conter o caráter newline (\n). Adicionar: Não suportado Atualização: Não suportado	cadeia

O objeto TextAd tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Ad

O objeto TextAd deriva do objeto Ad e herda os seguintes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. As descrições abaixo são específicas do TextAd e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Ad .

Elemento	Descrição	Tipo de Dados
AdFormatPreference	A Preferência de Formato de Anúncio é utilizada para indicar se prefere ou não que a cópia de anúncio seja apresentada aos utilizadores como um anúncio de pesquisa ou audiência. Os anúncios de pesquisa tendem a ser escritos como uma chamada à ação, enquanto os anúncios de audiência devem ser escritos num estilo mais informativo. Embora tenha a opção de utilizar anúncios de texto de pesquisa como anúncios de audiência, designar um anúncio como formato preferencial de anúncios de Audiência permite-lhe otimizar as mensagens para entrega nativa. IMPORTANTE: Tem de definir pelo menos um anúncio de texto por grupo de anúncios que não prefira anúncios de audiência. Caso contrário, a cópia de anúncios de todos os anúncios de texto será elegível para anúncios de pesquisa e audiência. Os valores possíveis são AudienceAd e All. Se estiver definido como Tudo, o anúncio será elegível para os formatos de anúncio de pesquisa e audiência. Se estiver definido como AudienceAd, o anúncio só será elegível para o formato de anúncio da audiência. Adicionar: Não suportado Atualização: Não suportado	cadeia
DevicePreference	Este elemento determina se a preferência é que os anúncios de texto sejam apresentados em dispositivos móveis ou em todos os dispositivos. Para especificar uma preferência para dispositivos móveis, defina este elemento como 30001. Para especificar todos os dispositivos, defina este elemento como 0 (zero) ou deixe o elemento nulo. Por predefinição, este elemento será nulo. Tem de definir pelo menos um anúncio de texto por grupo de anúncios que não seja preferencial para dispositivos móveis. Caso contrário, o anúncio será elegível para todos os dispositivos. Adicionar: Não suportado Atualização: Não suportado	long
EditorialStatus	O estado de revisão editorial do anúncio, que indica se o anúncio está pendente de revisão, foi aprovado ou foi desaprovado. Adicionar: Não suportado Atualização: Não suportado	AdEditorialStatus
FinalAppUrls	Não suportado para anúncios de texto.	Matriz appUrl
FinalMobileUrls	O URL da página de destino móvel. Este URL só é utilizado se a palavra-chave não especificar um URL móvel final. As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais. - O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres. - Pode especificar até 10 itens para FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento. - A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo {lpurl}. - Os URLs finais têm de ser um URL bem formado, começando com http:// ou https://. - Se especificar FinalMobileUrls, também tem de especificar FinalUrls. - Não pode especificar FinalMobileUrls se a preferência do dispositivo estiver definida como móvel. Tenha também em atenção que, para objetos TextAd, poderá não especificar FinalMobileUrls se o DevicePreference estiver definido como 30001 (móvel). Adicionar: Não suportado Atualização: Não suportado	matriz de cadeia
FinalUrls	O URL da página de destino. Este URL é utilizado apenas se a palavra-chave não especificar um URL final. As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais. - O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres. - Pode especificar até 10 itens para FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento. - A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo {lpurl}. - Os URLs finais têm de ser um URL bem formado, começando com http:// ou https://. - Se especificar FinalMobileUrls, também tem de especificar FinalUrls. - Não pode especificar FinalMobileUrls se a preferência do dispositivo estiver definida como móvel. Tenha também em atenção que, se o elemento TrackingUrlTemplate ou UrlCustomParameters deste anúncio estiver definido, é necessário, pelo menos, um URL final. Adicionar: Não suportado Atualização: Não suportado	matriz de cadeia
FinalUrlSuffix	Não suportado para anúncios de texto.	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 este objeto.	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising para o anúncio. Adicionar: Não suportado Atualização: Obrigatório e Só de Leitura	long
Estado	O estado do anúncio. Pode definir o estado do anúncio como Ativo ou Em Pausa. Adicionar: Não suportado Atualização: Opcional	AdStatus
TrackingUrlTemplate	O modelo de controlo a utilizar como predefinição para todos os URLs de página de destino. As seguintes regras de validação aplicam-se aos modelos de controlo. Para obter mais detalhes sobre os modelos e parâmetros suportados, consulte o artigo de ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar? - Modelos de controlo definidos para entidades de nível inferior, por exemplo, os anúncios substituem os conjuntos de 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}. - 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 da página de destino incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o seu modelo de controlo for `https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}` e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, critério, palavra-chave ou nível de anúncio, o URL da página de destino será o mesmo. Adicionar: Não suportado Atualização: Não suportado	cadeia
Tipo	O tipo do anúncio. Este valor é Texto quando obtém um anúncio de texto. Para obter mais informações sobre tipos de anúncios, veja Ad Data Object Remarks (Comentários de Objetos de Dados do Ad). Adicionar: Não suportado Atualização: Não suportado	AdType
UrlCustomParameters	A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs. O Microsoft Advertising aceitará os primeiros 8 objetos CustomParameter que incluir no objeto CustomParameters e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro. Cada CustomParameter inclui elementos Chave e Valor . Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Defina o elemento UrlCustomParameters como nulo ou vazio para manter quaisquer parâmetros personalizados existentes. Para remover todos os parâmetros personalizados, defina o elemento Parâmetros do objeto CustomParameters como nulo ou vazio. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter no elemento Parâmetros do objeto CustomParameters .	CustomParameters

Requisitos

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

Compartilhar via