AppInstall Objeto de DadosGoal - Gestão de Campanhas

Artigo
11/14/2024

Define um objetivo de conversão de instalação da aplicação. Utilize este tipo de objetivo para controlar sempre que alguém instala a sua aplicação como uma conversão.

Para outros tipos de objetivos de conversão, crie uma etiqueta de Controlo de Eventos Universal (UET), adicione-a ao seu site e, em seguida, crie um objetivo de conversão. No entanto, para objetivos de conversão de instalação de aplicações, tudo o que tem de fazer é utilizar o URL específico da aplicação fornecido pelo parceiro certificado pelo Microsoft Advertising. Para obter mais informações, veja Como controlar as instalações de aplicações móveis como conversões.

Sugestão

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

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

{
  "AttributionModelType": "ValueHere",
  "ConversionWindowInMinutes": IntValueHere,
  "CountType": "ValueHere",
  "ExcludeFromBidding": "ValueHere",
  "GoalCategory": "ValueHere",
  "Id": "LongValueHere",
  "IsEnhancedConversionsEnabled": "ValueHere",
  "Name": "ValueHere",
  "Revenue": {
    "CurrencyCode": "ValueHere",
    "Type": "ValueHere",
    "Value": DecimalValueHere
  },
  "Scope": "ValueHere",
  "Status": "ValueHere",
  "TagId": "LongValueHere",
  "TrackingStatus": "ValueHere",
  "Type": "AppInstall",
  "ViewThroughConversionWindowInMinutes": IntValueHere,
  "AppPlatform": "ValueHere",
  "AppStoreId": "ValueHere"
}

Elementos

O objeto AppInstallGoal tem os seguintes elementos: AppPlatform, AppStoreId.

Elemento	Descrição	Tipo de Dados
AppPlatform	A plataforma da aplicação. Os valores possíveis incluem Android, iOS, Windows e WindowsPhone. Adicionar: Necessário Atualização: Opcional	cadeia
AppStoreId	O identificador da aplicação fornecido pela loja de aplicações. Adicionar: Necessário Atualização: Opcional	cadeia

O objeto AppInstallGoal tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da ConversãoGoal

O objeto AppInstallGoal 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 AppInstallGoal 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 instalação de aplicações.	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	Não aplicável para objetivos de instalação de aplicações.	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 instalação da aplicação só suportam a categoria Transferir. Adicionar: Opcional. Se deixar este elemento nulo ou vazio, a categoria predefinida será definida como Transferir. Atualização: Opcional. 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	Longo
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. A opção VariableValue não está disponível para objetivos de conversão de instalação de aplicações. 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. Para os objetivos de instalação da aplicação, o âmbito ao nível da conta não é suportado. Pode definir este elemento como Cliente ou deixá-lo nulo. Se não for especificado, o âmbito será definido como Cliente por predefinição. 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, veja o elemento TrackingStatus . Adicionar: Opcional Atualização: Opcional	ConversionGoalStatus
TagId	Não aplicável para objetivos de instalação de aplicações.	Longo
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 para RecordingConversions se tivermos registado conversões nos últimos 7 dias. Apenas os estados NoRecentConversions e RecordingConversions são aplicáveis para objetivos de conversão de instalação de aplicações. 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 é AppInstall quando obtém um objetivo de instalação da aplicação. 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 instalação de aplicações.	int

Requisitos

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

Partilhar via