ConversionGoal Data Object - Gestão de Campanhas

Artigo
12/21/2023

Define o objeto base de um objetivo de conversão.

Não tente instanciar uma ConversãoGoal. Pode criar um ou mais dos seguintes objetos que derivam do mesmo.

Sintaxe

<xs:complexType name="ConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AttributionModelType" nillable="true" type="tns:AttributionModelType">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ConversionWindowInMinutes" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="CountType" nillable="true" type="tns:ConversionGoalCountType" />
    <xs:element minOccurs="0" name="ExcludeFromBidding" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="GoalCategory" nillable="true" type="tns:ConversionGoalCategory">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsEnhancedConversionsEnabled" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Revenue" nillable="true" type="tns:ConversionGoalRevenue" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ConversionGoalStatus" />
    <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:ConversionGoalTrackingStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalType" />
    <xs:element minOccurs="0" name="ViewThroughConversionWindowInMinutes" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elementos

O objeto ConversionGoal tem os seguintes elementos: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes.

Elemento	Descrição	Tipo de Dados
AttributionModelType	Determina que modelo de atribuição, LastTouch ou LastClick, é utilizado com um objetivo de conversão. Este elemento não é devolvido por predefinição. Para obter este elemento, inclua o valor AttributionModelType no elemento ReturnAdditionalFields quando chamar as operações do serviço GetConversionGoalsByIds e GetConversionGoalsByTagIds . Este elemento não é aplicável para AppInstallGoal, InStoreTransactionGoal e OfflineConversionGoal.	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).	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. Este elemento não é aplicável ao AppInstallGoal.	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".	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, por isso, consulte a página de referência correspondente para obter os requisitos detalhados.	ConversionGoalCategory
ID	O identificador exclusivo do Microsoft Advertising para o objetivo de conversão.	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.	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. A opção VariableValue não está disponível para AppInstallGoal, DurationGoal ou PagesViewedPerVisitGoal.	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. 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. Apenas o Âmbito do cliente é suportado para o AppInstallGoal.	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 .	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 . Este elemento não é aplicável para AppInstallGoal, InStoreTransactionGoal e OfflineConversionGoal.	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 . Apenas os estados NoRecentConversions e RecordingConversions são aplicáveis para AppInstallGoal e OfflineConversionGoal.	ConversionGoalTrackingStatus
Tipo	O tipo do objetivo de conversão. Para obter mais informações sobre os tipos de objetivos de conversão, veja As observações.	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 . Este elemento não é aplicável para AppInstallGoal, InStoreTransactionGoal e OfflineConversionGoal.	int

Observações

Para linguagens Java e .NET, não defina o elemento Tipo porque o valor é determinado pelo tipo de objetivo de conversão que instancia.

Se gerar o SOAP manualmente, utilize o atributo type do <ConversionGoal> nó, conforme mostrado no exemplo seguinte, para especificar o tipo do objetivo de conversão.

<ConversionGoals i:nil="false">
  <ConversionGoal i:type="UrlGoal">
    <ConversionWindowInMinutes i:nil="false"></ConversionWindowInMinutes>
    <CountType i:nil="false">Unique</CountType>
    <Id i:nil="true" />
    <Name i:nil="false">My Url Conversion Goal</Name>
    <Revenue i:nil="false">
      <CurrencyCode i:nil="false">USDollar</CurrencyCode>
      <Type i:nil="false">FixedValue</Type>
      <Value i:nil="false">10.00</Value>
    </Revenue>
    <Scope i:nil="false">Customer</Scope>
    <Status i:nil="true" />
    <TagId i:nil="false"></TagId>
    <TrackingStatus i:nil="true" />
    <UrlExpression i:nil="false">contoso</UrlExpression>
    <UrlOperator i:nil="false">Contains</UrlOperator>
  </ConversionGoal>
</ConversionGoals>

Requisitos

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

Utilizado Por

AddConversionGoals
GetConversionGoalsByIds
GetConversionGoalsByTagIds
UpdateConversionGoals

Partilhar via