Objeto de Dados ResponsiveSearchAd - Gestão de Campanhas

Artigo
12/21/2023

Um formato de anúncio reativo para anúncios de texto na rede de Pesquisa.

Nota

Os anúncios de pesquisa reativo duplicados são permitidos no mesmo grupo de anúncios.

Os anúncios de pesquisa reativo permitem-lhe definir entre 3 a 15 cabeçalhos de anúncios exclusivos (também conhecidos como "títulos") e descrições de anúncios 2 a 4 num único anúncio. A partir daí, o Bing irá selecionar a combinação de título e descrição mais relevante para cada consulta especificada e o utilizador de pesquisa correspondente. Ao permitir que Bing AI selecione o cabeçalho e a descrição mais relevantes para cada consulta, garantimos que a mensagem certa chega a cada um dos seus potenciais clientes, no momento certo, em todos os sinais de intenção possíveis.

Os anúncios reativos apresentados aos utilizadores parecem idênticos aos anúncios de texto expandidos, ou seja, até 3 cabeçalhos (partes de título através de anúncios de texto expandido) e 2 descrições (partes de texto através de anúncios de texto expandidos). Para maximizar as impressões em todos os formatos de anúncios, as descrições podem nem sempre ser apresentadas no seu anúncio.

Quando cria anúncios de pesquisa reativo, as listas Descrições e Títulos são armazenadas como recursos de texto que podem ser partilhados por qualquer anúncio de pesquisa reativo na conta. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, irá observar que tem o mesmo identificador de recursos em todos os anúncios que ligam à "Integração Totalmente Integrada" na mesma conta microsoft Advertising. Os identificadores de recursos não estão incluídos na resposta AddAds ou UpdateAds . Com o serviço Gestão de Campanhas, a única forma de obter os identificadores de recursos é ao obter os anúncios que criou. Pode obter os identificadores de recursos para descrições e títulos ao obter os anúncios numa chamada de serviço subsequente, por exemplo, através de GetAdsByAdGroupId. Com o Serviço em massa, os identificadores de recursos estão incluídos no ficheiro de resultados de carregamento em massa.

Nota

Os anúncios de pesquisa reativa só podem ser criados em campanhas de Pesquisa em que o AdGroupType está definido como "SearchStandard". Se o AdGroupType estiver definido como "SearchDynamic", o grupo de anúncios não suporta anúncios de pesquisa reativos.

Sintaxe

<xs:complexType name="ResponsiveSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto ResponsiveSearchAd tem os seguintes elementos: Descrições, Domínio, Cabeçalhos, Caminho1, Caminho2.

Elemento	Descrição	Tipo de Dados
Descrições	A lista de descrições que o Bing pode utilizar para otimizar o esquema de anúncios. Para maximizar as impressões em todos os formatos de anúncios, as descrições podem nem sempre ser apresentadas no seu anúncio. A menos que afixe uma das descrições a uma posição específica, o Bing otimizará dinamicamente o esquema de anúncios com as melhores manchetes e descrições para a consulta de pesquisa do utilizador. Numa perspetiva de modelo de dados, as desriptações e os títulos são armazenados como recursos de texto, ou seja, um TextAsset por AssetLink. O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising. Tem de definir entre 2 a 4 descrições. O Texto de cada descrição tem de conter, pelo menos, uma palavra. Para uma utilização eficiente dos recursos, recomendamos que utilize cadeias de texto dinâmicas, como {keyword} em vez de criar uma nova cópia de anúncios para cada palavra-chave. 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 Texto de cada descrição é de 1000 carateres, incluindo cadeias de texto dinâmicas, e desses 1000 não são permitidos mais de 90 carateres finais após a substituição. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 90 carateres após a substituição de texto dinâmico ocorrer. Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 500 carateres, incluindo cadeias de texto dinâmicas, e desses 500 não são permitidos mais de 45 carateres finais após a substituição. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 45 carateres após a substituição de texto dinâmico ocorrer. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis. O Texto não pode conter o caráter newline (\n). O texto pode conter funções SE . Adicionar: Necessário Atualização: Opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este elemento nulo. Se definir este elemento, todas as descrições anteriormente ligadas a este anúncio serão substituídas.	Matriz AssetLink
Domínio	O URL que será apresentado em vez do URL final. O URL final continuará a ser utilizado para o URL da página de destino. Reservado para utilização piloto limitada, por exemplo, clientes farmacêuticos. A parte do domínio do URL em combinação com as cadeias de caminho 1 e caminho 2 não pode exceder os 67 carateres. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.	cadeia
Cabeçalhos	A lista de títulos de anúncios que o Bing pode utilizar para otimizar o esquema de anúncios. A menos que afixe um dos cabeçalhos a uma posição específica, o Bing otimizará dinamicamente o esquema de anúncios com as melhores manchetes e descrições para a consulta de pesquisa do utilizador. Numa perspetiva de modelo de dados, as desriptações e os títulos são armazenados como recursos de texto, ou seja, um TextAsset por AssetLink. O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising. Tem de definir entre 3 a 15 cabeçalhos. O Texto de cada cabeçalho tem de conter, pelo menos, uma palavra. Para uma utilização eficiente dos recursos, recomendamos que utilize cadeias de texto dinâmicas, como {keyword} em vez de criar uma nova cópia de anúncios para cada palavra-chave. 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 Texto de cada título é de 1000 carateres, incluindo cadeias de texto dinâmicas, e desses 1000 não são permitidos mais de 30 carateres finais após a substituição. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 30 carateres após a substituição de texto dinâmico ocorrer. Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 500 carateres, incluindo cadeias de texto dinâmicas, e desses 500 não são permitidos mais de 15 carateres finais após a substituição. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder 15 carateres após a substituição de texto dinâmico ocorrer. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis. O Texto não pode conter o caráter newline (\n). O texto pode conter funções SE . Adicionar: Necessário Atualização: Opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este elemento nulo. Se definir este elemento, quaisquer títulos que tenham sido anteriormente ligados a este anúncio serão substituídos.	Matriz AssetLink
Caminho1	A primeira parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. A parte do domínio do URL de apresentação, por exemplo, https://www.contoso.com será gerada a partir do domínio do URL Final (elemento FinalUrls ). Em seguida, se tiver especificado um valor para Path1 , este será anexado ao URL de apresentação. Se também tiver especificado um valor para Path2, também será acrescentado ao URL de apresentação após Path1. Por exemplo, se os Seus FinalUrls contiverem https://www.contoso.com, Path1 estiver definido como subdiretório1 e Path2 estiver definido como subdiretório2, o URL apresentado será https://www.contoso.com/subdirectory1/subdirectory2. O caminho 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 comprimento máximo de entrada é de 1000 carateres se incluir cadeias de texto dinâmicas. Não podem ser introduzidos mais de 15 carateres finais (não de texto dinâmico). O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento do domínio de URL final e os caminhos combinados excederem os 67 carateres. Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 1000 carateres se incluir cadeias de texto dinâmicas. Não podem ser introduzidos mais de 7 carateres finais (não de texto dinâmico). O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento do domínio de URL final e os caminhos combinados excederem os 33 carateres. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis. O caminho não pode conter os carateres de barra (/) ou newline (\n). Se o caminho incluir um espaço, será substituído por um caráter de sublinhado (_) quando o anúncio for apresentado. O caminho pode conter funções SE . Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.	cadeia
Caminho2	A segunda parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. A parte do domínio do URL de apresentação, por exemplo, https://www.contoso.com será gerada a partir do domínio do URL Final (elemento FinalUrls ). Em seguida, se tiver especificado um valor para Path1 , este será anexado ao URL de apresentação. Se também tiver especificado um valor para Path2, também será acrescentado ao URL de apresentação após Path1. Por exemplo, se os Seus FinalUrls contiverem https://www.contoso.com, Path1 estiver definido como subdiretório1 e Path2 estiver definido como subdiretório2, o URL apresentado será https://www.contoso.com/subdirectory1/subdirectory2. Só pode especificar Path2 se Path1 também estiver definido. O caminho 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 comprimento máximo de entrada é de 1000 carateres se incluir cadeias de texto dinâmicas. Não podem ser introduzidos mais de 15 carateres finais (não de texto dinâmico). O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento do domínio de URL final e os caminhos combinados excederem os 67 carateres. Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 1000 carateres se incluir cadeias de texto dinâmicas. Não podem ser introduzidos mais de 7 carateres finais (não de texto dinâmico). O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento do domínio de URL final e os caminhos combinados excederem os 33 carateres. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis. O caminho não pode conter os carateres de barra (/) ou newline (\n). Se o caminho incluir um espaço, será substituído por um caráter de sublinhado (_) quando o anúncio for apresentado. O caminho pode conter funções SE . Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.	cadeia

O objeto ResponsiveSearchAd tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Ad

O objeto ResponsiveSearchAd 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 ResponsiveSearchAd e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto do Ad .

Elemento	Descrição	Tipo de Dados
AdFormatPreference	Não suportado para este tipo de anúncio.	cadeia
DevicePreference	Não suportado para este tipo de anúncio.	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: Só de leitura Atualização: Só de leitura	AdEditorialStatus
FinalAppUrls	Não suportado para este tipo de anúncio.	Matriz appUrl
FinalMobileUrls	O URL da página de destino móvel. 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. Este URL só é utilizado se a palavra-chave não especificar um URL móvel final. Adicionar: Opcional Atualização: Opcional	matriz de cadeia
FinalUrls	O URL da página de destino. A parte do domínio do URL em combinação com as cadeias de caminho 1 e caminho 2 não pode exceder os 67 carateres. 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. Este URL é utilizado apenas se a palavra-chave não especificar um URL final. Adicionar: Necessário Atualização: Opcional	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. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.	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 do anúncio. Adicionar: Só de leitura Atualização: Necessário e Read-Only	long
Estado	O estado do anúncio. Pode definir o estado do anúncio como Ativo ou Em Pausa. Adicionar: Opcional 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: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.	cadeia
Tipo	O tipo do anúncio. Este valor é ResponsiveSearch quando obtém um anúncio de pesquisa reativo. Para obter mais informações sobre tipos de anúncios, veja Ad Data Object Remarks (Comentários de Objetos de Dados do Ad). Adicionar: Só de leitura Atualização: Só de leitura	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