Objeto de Dados DynamicSearchAd - Gestão de Campanhas

Artigo
12/21/2023

Define um anúncio de pesquisa dinâmica.

Com os anúncios de pesquisa dinâmicos, o URL de manchete e apresentação é gerado automaticamente com base no domínio e idioma do site que pretende direcionar. A combinação dos elementos Path1, Path2 e Text torna o anúncio de pesquisa dinâmica exclusivo. Opcionalmente, pode fornecer um cabeçalho estático através de feeds de página.

Nota

Esta funcionalidade está atualmente disponível nos seguintes países ou regiões: Albânia (AL), Andorra (AD), Argentina (AR), Aruba, Austrália (AU), Áustria (AT), Bahamas (BS), Bangladesh(BD), Bélgica (BE), Bolívia(BO), Bósnia e Herzegovina (BA), Brasil (BR), Brunei(BN), Bulgária (BG), Canadá (CA), Ilhas Caimão(KY), Chile(CL), Colômbia(CO), Costa Rica(CR), Croácia (RH), Chipre (CY), República Checa (CZ), Dinamarca (DK), Dominica(DM), República Dominicana(DO), Equador(EC), El Salvador(SV), Estónia (EE), Fiji (FJ), Finlândia (FI), França (FR), Guiana Francesa(GF), Polinésia Francesa (PF), Alemanha (DE), Grécia (GR), Guam (GU), Guatemala (GT), Guiana (GY), Haiti (HT), Honduras (HN), Hungria (HU), Islândia (IS), Índia (IN), Indonésia (ID), Irlanda (IE), Itália (IT), Letónia (LV), Liechtenstein (LI), Lituânia (LT), Luxemburgo (LU), Malásia (MY), Maldivas (MV), Malta (MT), Martinica (MQ), México (MX), Mónaco (MC), Mongólia (MN), Montenegro (ME), Montserrat (MS), Nepal (NP), Países Baixos (NL), Nova Caledónia (NC), Nova Zelândia (NZ), República da Macedónia do Norte (MK), Noruega (NO), Panamá (PA), Paraguai (PY), Papua Nova Guiné (PG), Peru (PE), Filipinas (PH), Polónia (PO), Portugal (PT), Porto Rico, Roménia (RO), São Marino (SM), Sérvia (RS), Singapura(SG), Eslováquia (SK), Eslovénia (SI), África do Sul (ZA), Espanha (ES), Espanha(ES), Sri Lanka(LK), Suécia (SE), Suíça (CH), Tailândia(TH), Trinidad e Tobago(TT), Turquia (TR), Cidade do Vaticano (VA), Vietname(VN), Reino Unido (Reino Unido), Estados Unidos (EUA), Uruguai(UY) e Venezuela(VE).

Os anúncios de pesquisa dinâmica só podem ser criados em campanhas de pesquisa que tenham um DynamicSearchAdsSetting. O elemento ExperimentId da campanha não pode ser definido e o AdGroupType tem de ser definido como "SearchDynamic".

Nota

Já não pode adicionar, atualizar ou obter campanhas que apenas suportam anúncios de pesquisa dinâmicos. O tipo de campanha das suas campanhas existentes foi atualizado de "DynamicSearchAds" para "Search". Os grupos de anúncios são agora considerados grupos de anúncios "dinâmicos", mas não existem alterações estruturais, ou seja, contêm os mesmos destinos automáticos e anúncios de pesquisa dinâmicos como anteriormente.

Sintaxe

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

Elementos

O objeto DynamicSearchAd tem os seguintes elementos: Path1, Path2, Text, TextPart2.

Elemento	Descrição	Tipo de Dados
Caminho1	A primeira parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. O URL de apresentação, por exemplo , www.contoso.com será gerado a partir do domínio do URL de apresentação. Em seguida, se tiver especificado um valor para o Caminho 1 , será acrescentado ao URL de apresentação. Se também tiver especificado um valor para o Caminho 2, também será acrescentado ao URL de apresentação após o Caminho 1. Por exemplo, se o seu domínio estiver contoso.com, o Caminho 1 está definido como subdiretório1 e o Caminho 2 está definido como subdiretório2, o URL apresentado será www.contoso.com/subdirectory1/subdirectory2. O comprimento máximo de entrada do caminho é de 15 carateres. Tenha em atenção que para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada do caminho é de 7 carateres. O caminho pode conter funções SE e contagem decrescente . Independentemente do comprimento total de todos os parâmetros de contagem decrescente sem título, a contagem decrescente apresentada final utilizará sempre 8 carateres do total de carateres disponíveis. Para obter mais detalhes, veja Personalizadores de Contagem Decrescente. 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. Adicionar: Opcional Atualização: Opcional	cadeia
Caminho2	A segunda parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. O URL de apresentação, por exemplo , www.contoso.com será gerado a partir do domínio das definições de nível de campanha de anúncios de pesquisa dinâmica. Em seguida, se tiver especificado um valor para o Caminho 1 , será acrescentado ao URL de apresentação. Se também tiver especificado um valor para o Caminho 2, também será acrescentado ao URL de apresentação após o Caminho 1. Por exemplo, se o seu domínio estiver contoso.com, o Caminho 1 está definido como subdiretório1 e o Caminho 2 está definido como subdiretório2, o URL apresentado será www.contoso.com/subdirectory1/subdirectory2. Só pode especificar Path2 se Path1 também estiver definido. O comprimento máximo de entrada do caminho é de 15 carateres. Tenha em atenção que para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada do caminho é de 7 carateres. O caminho pode conter funções SE e contagem decrescente . Independentemente do comprimento total de todos os parâmetros de contagem decrescente sem título, a contagem decrescente apresentada final utilizará sempre 8 carateres do total de carateres disponíveis. Para obter mais detalhes, veja Personalizadores de Contagem Decrescente. 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. Adicionar: Opcional Atualização: Opcional	cadeia
Text	A primeira parte da descrição do anúncio. O texto tem de conter, pelo menos, uma palavra. O comprimento máximo de entrada da cópia é de 90 carateres. Tenha em atenção que para grupos de anúncios que utilizam chinês tradicional, o comprimento máximo de entrada da cópia é de 45 carateres. O texto pode conter funções SE e contagem decrescente . Independentemente do comprimento total de todos os parâmetros de contagem decrescente sem título, a contagem decrescente apresentada final utilizará sempre 8 carateres do total de carateres disponíveis. Para obter mais detalhes, veja Personalizadores de Contagem Decrescente. O texto não pode conter o caráter newline (\n). Adicionar: Necessário Atualização: Opcional	cadeia
TextPart2	A segunda parte da descrição do anúncio. O texto tem de conter, pelo menos, uma palavra. O comprimento máximo de entrada da cópia é de 90 carateres. Tenha em atenção que para grupos de anúncios que utilizam chinês tradicional, o comprimento máximo de entrada da cópia é de 45 carateres. O texto pode conter funções SE e contagem decrescente . Independentemente do comprimento total de todos os parâmetros de contagem decrescente sem título, a contagem decrescente apresentada final utilizará sempre 8 carateres do total de carateres disponíveis. Para obter mais detalhes, veja Personalizadores de Contagem Decrescente. O texto não pode conter o caráter newline (\n). Adicionar: Opcional Atualização: Opcional	cadeia

O objeto DynamicSearchAd tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Ad

O objeto DynamicSearchAd 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 de DynamicSearchAd 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	Não suportado para este tipo de anúncio.	matriz de cadeia
FinalUrls	Não suportado para este tipo de anúncio.	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. Atualmente, não existem pares de chaves de mapa de compatibilidade e valores de compatibilidade suportados para anúncios de pesquisa dinâmica.	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 é DynamicSearch quando obtém um anúncio de pesquisa dinâmico. 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