UrlGoal Data Object - Gestão de Campanhas

Artigo
07/19/2024

Define um objetivo de conversão de URL. Utilize este tipo de objetivo para contar sempre que alguém visitar uma página Web como uma conversão. Por exemplo, pode contar uma conversão se alguém visitar a página de confirmação da compra.

Sugestão

Para obter uma descrição geral da implementação, veja o Guia técnico do Controlo de Eventos Universal .

Importante

Sempre que adicionar ou atualizar uma nova DurationGoal, EventGoal, OfflineConversionGoal, PagesViewedPerVisitGoal ou UrlGoal através da aplicação Web Microsoft Advertising ou da API de Gestão de Campanhas, o valor MSCLKIDAutoTaggingEnabled da AccountProperty correspondente é definido como Verdadeiro automaticamente. Se o Âmbito do objetivo estiver definido como Ao nível do cliente , a Propriedade da Conta para todas as contas no Cliente será definida.

Sintaxe

<xs:complexType name="UrlGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="UrlExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlOperator" nillable="true" type="tns:ExpressionOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto UrlGoal tem os seguintes elementos: UrlExpression, UrlOperator.

Elemento	Descrição	Tipo de Dados
UrlExpression	A expressão utilizada para determinar a página ou páginas que o utilizador tem de visitar para contar como uma conversão. Adicionar: Necessário Atualização: Opcional	cadeia
UrlOperator	O operador que pode ser aplicado ao valor do elemento URL . Adicionar: Opcional; Se não for especificado, o operador predefinido é Igual a. Atualização: Opcional; Se não for especificado durante a atualização, a definição anterior é mantida.	ExpressionOperator

O objeto UrlGoal tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da ConversãoGoal

O objeto UrlGoal deriva do objeto ConversionGoal e herda os seguintes elementos: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes. As descrições abaixo são específicas do UrlGoal e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto ConversionGoal .

Elemento	Descrição	Tipo de Dados
AttributionModelType	Determina que modelo de atribuição, LastTouch ou LastClick, é utilizado com um objetivo de conversão.	AttributionModelType
ConversionWindowInMinutes	A janela de conversão é o período de tempo em minutos após um clique que pretende controlar as conversões. Se definir este valor como 43200 minutos (30 dias), as conversões que ocorrem no prazo de 30 dias após um clique são controladas. As conversões anteriores não são afetadas. O valor mínimo suportado é de 1 minuto, embora tenha em atenção que uma janela de conversão mais curta reduzirá o número de conversões que a sua conta regista. O valor máximo suportado é 129600 minutos (90 dias). Adicionar: Opcional Atualização: Opcional	int
CountType	Isto determina a forma como as conversões são registadas na janela de conversão escolhida. Existem duas opções e, se não definir um valor, a predefinição é Tudo: - Tudo: todas as conversões que ocorrem após um clique de anúncio serão contadas. Esta é uma opção comum para vendas. - Exclusivo: apenas uma conversão que ocorre após um clique de anúncio será contabilizada. Esta é uma opção comum para oportunidades potenciais. Por exemplo: controla duas conversões: oportunidades potenciais e vendas. Selecione Exclusivo para oportunidades potenciais e Tudo para vendas. Quando um clique se transforma em duas oportunidades potenciais e duas vendas, é contabilizado como três conversões: uma para a oportunidade potencial exclusiva e duas para todas as vendas. Adicionar: Opcional Atualização: Opcional	ConversionGoalCountType
ExcludeFromBidding	Determina se excluir ou não dados relacionados com este objetivo de conversão de um subconjunto de colunas de relatório de desempenho. Este elemento só está disponível para clientes que estão ativados para a funcionalidade Incluir em Conversões (GetCustomerPilotFeatures devolve 574). Se este elemento estiver definido como verdadeiro, os dados relacionados com este objetivo de conversão serão excluídos das `Conversions`colunas , `ConversionRate`, `CostPerConversion`, `ReturnOnAdSpend`, `RevenuePerConversion`e `Revenue` relatório. Além disso, se utilizar uma estratégia de licitação automatizada, definir esta propriedade como verdadeira fará com que as conversões do objetivo deixem de ser tidas em conta em cálculos de licitação automatizados. Definir esta propriedade como "verdadeiro" é efetivamente o mesmo que desmarcar "Incluir em Conversões" na aplicação Web Microsoft Advertising. Independentemente deste valor de elemento, as `AllConversions`colunas , `AllConversionRate`, `AllCostPerConversion`, `AllReturnOnAdSpend`, `AllRevenuePerConversion`e `AllRevenue` relatório incluirão dados para todos os objetivos de conversão. Por predefinição, este elemento é falso e os dados relacionados com este objetivo de conversão estão incluídos em todas as colunas do relatório. Para obter mais informações, veja Atributos de Relatório e Estatísticas de Desempenho e o artigo de ajuda Objetivos de conversão: "Conversões" versus "Todas as conversões". Adicionar: Opcional Atualização: Opcional	booleano
GoalCategory	A categoria utilizada para segmentar o objetivo de conversão. No entanto, categorizar os seus objetivos de conversão faz sentido para a sua empresa. As categorias de objetivos não afetam o desempenho. Estão aqui para ajudá-lo a segmentar os seus objetivos e as métricas de desempenho. Os valores de categoria suportados variam consoante o tipo de objetivo de conversão. Os objetivos de URL suportam as categorias AddToCart, BeginCheckout, BookAppointment, Contact, GetDirections, Other, OutboundClick, PageView, Purchase, RequestQuote, Signup, SubmitLeadForm e Subscribe . Adicionar: Obrigatório a partir de junho de 2021. Anteriormente, se deixou este elemento nulo ou vazio, a categoria predefinida foi definida como Nenhuma. Atualização: Opcional se o objetivo de conversão já tiver uma categoria definida que não Nenhuma. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	ConversionGoalCategory
ID	O identificador exclusivo do Microsoft Advertising para o objetivo de conversão. Adicionar: Só de leitura Atualização: Necessário e Read-Only	long
IsEnhancedConversionsEnabled	Determina se as conversões melhoradas estão ativadas para um objetivo de conversão. Nota: para criar um objetivo de conversão melhorado e definir `isEnhancedConversionsEnabled=true`o , tem de criar um objetivo de conversão para a conta através da IU do Microsoft Advertising com a definição de conversão melhorada selecionada e a caixa de verificação associada selecionada.	booleano
Nome	O nome do objetivo de conversão. O comprimento máximo do nome é 100 e o nome tem de ser exclusivo entre todos os objetivos de conversão pertencentes ao mesmo cliente. Adicionar: Necessário Atualização: Opcional	cadeia
Receita	Determina quanto vale cada conversão para a sua empresa. Ao adicionar um objetivo de conversão se não especificar quaisquer preferências de controlo de receitas, cada ConversionGoalRevenue será definido para os respetivos valores predefinidos. Ao atualizar um objetivo de conversão, se o elemento Receita for nulo ou estiver vazio, nenhuma das propriedades aninhadas será atualizada. No entanto, se este elemento não for nulo ou estiver vazio, está efetivamente a substituir quaisquer propriedades de receita existentes. Adicionar: Opcional Atualização: Opcional	ConversionGoalRevenue
Âmbito	Determina se o objetivo se aplica a todas as contas ou apenas à conta especificada no elemento de cabeçalho CustomerAccountId necessário. Se tiver várias contas do Microsoft Advertising, pode controlar as conversões em todas essas contas. Se associar um objetivo a uma conta, as conversões serão controladas apenas para essa conta. Os valores possíveis são Conta e Cliente. Se não for especificado, o âmbito será definido como Cliente por predefinição. Depois de definir o âmbito, não pode alterá-lo. Se quiser alterar o âmbito, tem de criar um novo objetivo de conversão e colocar o antigo em pausa. Adicionar: Opcional Atualização: Opcional	EntityScope
Estado	Define os possíveis valores de estado determinados pelo utilizador de um objetivo de conversão. Estes são os valores de estado que um utilizador pode decidir definir, por exemplo, um objetivo pode ser definido como Em pausa se já não quiser controlar as conversões para esse objetivo. Para obter os valores de estado que podem ser definidos pelo sistema, por exemplo, se a etiqueta UET está ou não verificada, veja o elemento TrackingStatus . Adicionar: Opcional Atualização: Opcional	ConversionGoalStatus
TagId	O identificador exclusivo do Microsoft Advertising da etiqueta UET que adicionou ao seu site para permitir que o Microsoft Advertising recolha ações que as pessoas efetuam no seu site. Antes de assumir uma dependência do ID da etiqueta, tenha em atenção que a etiqueta UET pode ser partilhada com ou a partir de outro cliente. As etiquetas e audiências UET partilhadas só estão disponíveis para clientes piloto. Para obter uma descrição geral da partilha de audiências e etiquetas UET numa hierarquia de clientes, consulte o guia técnico Partilhar Audiências e Etiquetas UET . Adicionar: Necessário Atualização: Opcional	long
TrackingStatus	Define os possíveis valores de estado determinados pelo sistema de um objetivo de conversão. Estes são os valores de estado que podem ser definidos pelo sistema, por exemplo, o sistema define o estado como TagUnverified se a etiqueta UET ainda não tiver sido verificada. Para os valores de estado que um utilizador pode decidir definir, por exemplo, definir o estado como Em Pausa se já não quiser controlar as conversões para esse objetivo, veja o elemento Estado . Adicionar: Só de leitura Atualização: Só de leitura	ConversionGoalTrackingStatus
Tipo	O tipo do objetivo de conversão. Este valor é URL quando obtém um objetivo de URL. Para obter mais informações sobre os tipos de objetivos de conversão, veja ConversionGoal Data Object Remarks (Comentários de Objetos de Dados De Conversão). Adicionar: Só de leitura Atualização: Só de leitura	ConversionGoalType
ViewThroughConversionWindowInMinutes	A janela de conversão view-through é o período de tempo em minutos após um clique que pretende controlar as conversões de visualização. Se definir este valor como 43200 minutos (30 dias), as conversões de visualização que ocorrem no prazo de 30 dias após um clique são controladas. As conversões anteriores não são afetadas. O valor mínimo suportado é de 1 minuto, embora tenha em atenção que uma janela de conversão mais curta reduzirá o número de conversões que a sua conta regista. O valor máximo suportado é 43200 minutos (30 dias). A propriedade da conta IncludeViewThroughConversions também tem de ser definida como verdadeira para que as conversões view-through sejam controladas. Este elemento não é devolvido por predefinição. Para obter este elemento, inclua o valor ViewThroughConversionWindowInMinutes no elemento ReturnAdditionalFields quando chama as operações do serviço GetConversionGoalsByIds e GetConversionGoalsByTagIds . Adicionar: Opcional Atualização: Opcional	int

Requisitos

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

Compartilhar via