Objeto de Dados OfflineConversionGoal - Gestão de Campanhas

Artigo
12/21/2023

Define um objetivo de conversão offline. Utilize este tipo de objetivo se tiver a geração de oportunidades potenciais como objetivo. A geração de oportunidades potenciais é quando potenciais clientes preenchem um formulário ou cotação de juros, e depois a venda é concluída offline pessoalmente ou por telefone (por exemplo, compras de carros, cotações de seguros, hipotecas, etc.).

Para configurar o controlo de conversão offline, crie um OfflineConversionGoal, aguarde duas horas e, em seguida, envie à Microsoft Advertising os dados OfflineConversion através da operação ApplyOfflineConversions .

Importante

Tem de criar OfflineConversionGoal através da API de Gestão de Campanhas para definir a propriedade IsExternallyAttributed .

Sugestão

Para obter mais informações, veja Controlar conversões offline.

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="OfflineConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="IsExternallyAttributed" 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:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto OfflineConversionGoal tem os seguintes elementos: IsExternallyAttributed.

Elemento	Descrição	Tipo de Dados
IsExternallyAttributed	Isto determina se o objetivo de conversão offline utiliza o seu próprio modelo de atribuição e lhe permite importar crédito fracionário para cada MSCLKID. Este elemento não é devolvido por predefinição. Para obter este elemento, inclua o valor IsExternallyAttributed no elemento ReturnAdditionalFields quando chamar as operações do serviço GetConversionGoalsByIds e GetConversionGoalsByTagIds . Nota: só pode definir IsExternallyAttributed através da API de Gestão de Campanhas. Adicionar: Opcional Atualização: Opcional	booleano

O objeto OfflineConversionGoal tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da ConversãoGoal

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

Elemento	Descrição	Tipo de Dados
AttributionModelType	Não aplicável para objetivos de conversão offline.	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 predefinido é 43200. 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 com diferentes tempos de conversão offline que ocorrem após um clique de anúncio serão contadas. Esta é uma opção comum para vendas. - Exclusivo: apenas a primeira conversão que ocorrer 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. As conversões offline duplicadas com o mesmo MicrosoftClickId e ConversionTime serão ignoradas. Por outras palavras, apenas a primeira conversão offline para um determinado MicrosoftClickId e ConversionTime será contabilizada. 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 conversão offline 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. Se o tipo de receita for FixedValue ou VariableValue, os elementos ConversionCurrencyCode e ConversionValue dos dados OfflineConversion aplicados têm precedência sobre o código e o valor de moeda ConversionGoalRevenue . 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. 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. Se não for especificado, o âmbito será definido como Conta por predefinição . Atualização: Só de leitura. Não é possível atualizar o âmbito do objetivo de conversão offline.	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, veja o elemento TrackingStatus . Adicionar: Opcional Atualização: Opcional	ConversionGoalStatus
TagId	Não aplicável para objetivos de conversão offline.	long
TrackingStatus	Não aplicável para objetivos de conversão offline.	ConversionGoalTrackingStatus
Tipo	O tipo do objetivo de conversão. Este valor é OfflineConversion quando obtém um objetivo de conversão offline. 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	Não aplicável para objetivos de conversão offline.	int

Requisitos

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

Compartilhar via