Objeto de Dados FlyerAdExtension - Gestão de Campanhas
As Extensões flyer permitem que os anunciantes distribuam catálogos de produtos ou lojas (panfletos) a potenciais clientes.
Podem apresentar-se de forma proeminente em consultas abrangentes como "ofertas semanais" ou "vendas semanais" e, assim, incentivar os compradores a clicar no seu anúncio em vez do do concurso. Por natureza, ajudam a informar melhor os searchers e, como resultado, a aumentar a cativação dos utilizadores, por exemplo, clique através da taxa.
Nota
As Extensões flyer estão disponíveis para clientes no piloto de funcionalidades (GetCustomerPilotFeatures devolve 802).
Sintaxe
<xs:complexType name="FlyerAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:AdExtension">
<xs:sequence>
<xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
<xs:element xmlns:q61="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q61:ArrayOfstring" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q62="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q62:ArrayOfstring" />
<xs:element minOccurs="0" name="FlyerName" nillable="true" type="xs:string" />
<xs:element xmlns:q63="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImageMediaIds" nillable="true" type="q63:ArrayOflong" />
<xs:element xmlns:q64="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImageMediaUrls" nillable="true" type="q64:ArrayOfstring" />
<xs:element minOccurs="0" name="StoreId" nillable="true" type="xs:long" />
<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 FlyerAdExtension tem os seguintes elementos: Description, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, FlyerName, ImageMediaIds, ImageMediaUrls, StoreId, TrackingUrlTemplate, UrlCustomParameters.
| Elemento | Descrição | Tipo de Dados |
|---|---|---|
| Descrição | Descrição que pode ser utilizada pelo anunciante, agência ou gestor de conta para controlar, etiquetar ou gerir extensões de panfleto. Esta descrição não é apresentada com o anúncio ou imagem. O comprimento máximo para este elemento é de 1024 carateres. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
cadeia |
| FinalAppUrls | Reservado para utilização futura. | Matriz appUrl |
| FinalMobileUrls | O URL da página de destino para dispositivos móveis. 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 de lista para FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 itens de lista 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. 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 para uma lista vazia, a definição anterior será eliminada. |
matriz de cadeia |
| FinalUrls | O URL da página de destino. 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 de lista para FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 itens de lista 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. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
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 não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
cadeia |
| FlyerName | O nome do panfleto. O comprimento máximo para este elemento é de 150 carateres. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
cadeia |
| ImageMediaIds | O identificador da imagem a incluir no anúncio. Só pode definir um ID de multimédia. O tipo de dados é uma lista de valores longos caso o suporte para múltiplas imagens seja adicionado mais tarde. Cada ID de multimédia corresponde a uma Imagem do subtipo de Multimédia "GenericImage". Pode obter o identificador de cada Imagem ao adicioná-los à biblioteca de imagens ao chamar a operação AddMedia . Caso contrário, depois de o suporte de dados ter sido adicionado à biblioteca de imagens, pode obter os identificadores de multimédia com a operação GetMediaMetaDataByAccountId . A imagem deve ter uma largura e altura mínimas de 220 px e um tamanho de ficheiro máximo de 3,9 MB. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
matriz longa |
| ImageMediaUrls | O URL do suporte de dados que já adicionou. Adicionar: Só de leitura Atualização: Só de leitura |
matriz de cadeia |
| StoreId | O identificador exclusivo de uma loja do Microsoft Merchant Center utilizada para anúncios de produtos. Adicionar: Opcional Atualização: Só de leitura. Não é possível atualizar o ID da loja depois de ter sido definido. |
long |
| 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 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 |
| UrlCustomParameters | A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs. O Microsoft Advertising aceitará os primeiros 3 objetos CustomParameter que incluir no objeto CustomParameters e quaisquer parâmetros personalizados adicionais serão ignorados. 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 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 |
O objeto FlyerAdExtension tem Elementos Herdados.
Elementos Herdados
Elementos Herdados do AdExtension
O objeto FlyerAdExtension 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 FlyerAdExtension 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. O EndDate tem de estar dentro de 30 dias após o DataDo Start. Adicionar: A agenda StartDate e EndDate são necessárias para extensões de anúncios de panfleto. 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. Não é possível definir este elemento para um objeto Agenda vazio, uma vez que tentaria efetivamente eliminar todos os agendamentos. Tal resultaria num erro, uma vez que StartDate e EndDate são necessários para extensões de anúncios de panfleto. |
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 é FlyerAdExtension quando obtém uma extensão de anúncio de panfleto. 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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de