Objeto de Dados ActionAdExtension - Gestão de Campanhas

Artigo
12/21/2023

Define uma extensão de anúncio de ação com um botão de chamada à ação.

Sintaxe

<xs:complexType name="ActionAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element name="ActionType" type="tns:ActionAdExtensionActionType" />
        <xs:element xmlns:q51="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q51:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q52="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q52:ArrayOfstring" />
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto ActionAdExtension tem os seguintes elementos: ActionType, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Language, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descrição	Tipo de Dados
ActionType	O tipo de ação que escolher aqui, bem como o Idioma que definiu, determina o texto apresentado no botão de chamada à ação. O Microsoft Advertising não suporta todos os tipos de ação para todos os idiomas. Se tentar utilizar um tipo de ação não suportado e uma combinação de idioma, será devolvido um erro. Para obter detalhes, veja Texto de Ação para Extensões de Ação Ad. Adicionar: Necessário Atualização: Necessário	ActionAdExtensionActionType
FinalMobileUrls	Este é um URL de página de destino compatível com dispositivos móveis quando as Extensões de Ação são fornecidas em dispositivos móveis. Se especificar URLs móveis finais, também tem de especificar FinalUrls. O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, a definição anterior será eliminada.	matriz de cadeia
FinalUrls	Esta é a ligação para a sua página Web ou formulário específico que corresponde ao texto da ação. Quando não for fornecido um URL de ação, será utilizado o URL final do anúncio. O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres. Embora o tipo de dados seja uma lista de cadeias, apenas o primeiro item de lista é utilizado pelo Microsoft Advertising. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, a definição anterior será eliminada.	matriz de cadeia
FinalUrlSuffix	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. Esta funcionalidade só está disponível para clientes no piloto Fase 3 do Sufixo de URL Final (GetCustomerPilotFeatures devolve 636). Se não estiver no piloto, esta propriedade será ignorada e não será devolvido nenhum erro. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, a definição anterior será eliminada.	cadeia
Idioma	O idioma em que a extensão de anúncios será fornecida. A extensão será sempre servida neste idioma, independentemente das definições de idioma da campanha ou do grupo de anúncios. As cadeias de idioma suportadas são: dinamarquês, neerlandês, inglês, finlandês, francês, alemão, italiano, norueguês, português, espanhol, sueco e tradicionalchinês. O Microsoft Advertising não suporta todos os tipos de ação para todos os idiomas. Se tentar utilizar um tipo de ação não suportado e uma combinação de idioma, será devolvido um erro. Para obter detalhes, veja Texto de Ação para Extensões de Ação Ad. Adicionar: Necessário Atualização: Necessário	cadeia
TrackingUrlTemplate	O modelo de controlo a utilizar como predefinição para todos os FinalUrls e FinalMobileUrls. 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: Opcional Atualização: Opcional. Se definir este elemento como nulo, a definição anterior será eliminada.	cadeia
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 . Para os clientes no piloto de Aumento do Limite de Parâmetros Personalizados Fase 3 (GetCustomerPilotFeatures devolve 635), o Microsoft Advertising aceitará os primeiros oito pares de chave e valor personalizados incluídos e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, a definição anterior será eliminada.	CustomParameters

O objeto ActionAdExtension tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do AdExtension

O objeto ActionAdExtension deriva do objeto AdExtension e herda os seguintes elementos: DevicePreference, ForwardCompatibilityMap, ID, Scheduling, Status, Type, Version. As descrições abaixo são específicas de ActionAdExtension e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto AdExtension .

Elemento	Descrição	Tipo de Dados
DevicePreference	Não é suportado para este tipo de extensão de anúncio.	long
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. Atualmente, não existem alterações de compatibilidade para o objeto AdExtension . Adicionar: Só de leitura Atualização: Só de leitura	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising da extensão de anúncios. Adicionar: Só de leitura Atualização: Só de leitura e Obrigatório	long
Agendamento	Determina os intervalos de dia e hora do calendário quando a extensão de anúncios é elegível para ser apresentada em anúncios. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, qualquer conjunto de agendamento existente para a extensão de anúncio permanecerá inalterado. Se definir esta opção para qualquer objeto Schedule não nulo, está efetivamente a substituir as definições de agendamento existentes para a extensão de anúncios. Para remover todo o agendamento, defina este elemento para um objeto Schedule vazio.	Agenda
Estado	O estado da extensão de anúncios. O valor será sempre Ativo porque o serviço Gestão de Campanhas não devolve extensões de anúncios eliminadas. Adicionar: Só de leitura Atualização: Só de leitura	AdExtensionStatus
Tipo	O tipo da extensão de anúncios. Este valor é ActionAdExtension quando obtém uma extensão de anúncio de ação. Adicionar: Só de leitura Atualização: Só de leitura Para obter mais informações sobre os tipos de extensão de anúncios, veja Comentários sobre Objetos de Dados da Extensão do Ad.	cadeia
Versão	Monitoriza o número de vezes que a extensão de anúncios foi atualizada. A versão é definida como 1 quando a extensão de anúncio é criada e incrementa um após cada atualização. Adicionar: Não permitido Atualização: Não permitido	int

Requisitos

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

Partilhar via