Partilhar via

Objeto de Dados OfflineConversion - Gestão de Campanhas

  • Artigo

Define uma conversão offline que envia para o Microsoft Advertising.

Para configurar o controlo de conversão offline, crie um OfflineConversionGoal. Se definir o CountType de OfflineConversionGoal para Todos, todas as conversões offline para o mesmo MicrosoftClickId com tempos de conversão diferentes serão adicionadas cumulativamente. Se definir o CountType de OfflineConversionGoal como Exclusivo, apenas a primeira conversão que ocorrer após um clique de anúncio será contabilizada. 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.

Importante

Após a configuração do OfflineConversionGoal , aguarde duas horas e, em seguida, envie à Microsoft Advertising os dados OfflineConversionatravés da operação ApplyOfflineConversions . Pode demorar até seis horas a ver os dados de conversão nos relatórios do Microsoft Advertising.

Nota

Embora possa carregar conversões offline no sandbox para testes funcionais, os dados de conversão offline não serão atribuídos nos dados de relatórios de desempenho do sandbox.

Sintaxe

<xs:complexType name="OfflineConversion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ConversionCurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="ConversionValue" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionCredit" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionModel" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="HashedEmailAddress" nillable="true" type="xs:string">
      <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="HashedPhoneNumber" nillable="true" type="xs:string">
      <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="MicrosoftClickId" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elementos

O objeto OfflineConversion tem os seguintes elementos: ConversionCurrencyCode, ConversionName, ConversionTime, ConversionValue, ExternalAttributionCredit, ExternalAttributionModel, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

Elemento Descrição Tipo de Dados
ConversionCurrencyCode O código de moeda para a conversão offline.

Para obter mais informações, veja Moedas.

Aplicar: Opcional. Se não especificar um código de moeda de conversão offline, será utilizado o elemento CurrencyCode do conversionGoalRevenue do objetivo.		 cadeia
ConversionName O nome do objetivo de conversão.

Este nome tem de corresponder a um nome de objetivo de conversão existente. Caso contrário, os dados de objetivos de conversão offline não serão aplicados.

Aplicar: Necessário		 cadeia
ConversionTime A data e hora em que ocorreu a conversão offline.

A data e hora têm de estar nos últimos 90 dias. Caso contrário, a operação falhará quando tentar enviar o Microsoft Advertising dos dados de conversão offline.

Para ser contabilizado pelo Microsoft Advertising como uma conversão offline após o carregamento com êxito, têm de ser cumpridos os seguintes requisitos adicionais:
- A data e hora da conversão têm de ser definidas posteriormente à data e hora do clique registado.
- A data e hora têm de estar dentro da janela de conversão. A propriedade ConversionWindowInMinutes do OfflineConversionGoal determina o período máximo de tempo em minutos após um clique em que as conversões serão controladas.

Por exemplo, se foram registados três cliques no dia 30 de abril, se a ConversãoWindowInMinutes do OfflineConversionGoal for igual a 30 dias (43200 minutos) e se enviar o Microsoft Advertising as seguintes conversões offline a 31 de julho, o Microsoft Advertising apenas contará o com MicrosoftClickId=2 como uma conversão offline.
- MicrosoftClickId=1; ConversionTime=2020-04-30T17:02:35.6853793Z
- MicrosoftClickId=2; ConversionTime=2020-05-15T17:02:35.6853793Z
- MicrosoftClickId=3; ConversionTime=2020-06-15T17:02:35.6853793Z

Os dados de conversão offline com MicrosoftClickId=1 não serão carregados, uma vez que a data e hora de conversão são há mais de 90 dias e os dados de conversão offline com MicrosoftClickId=3 não serão contabilizados porque não se inserem na janela de conversão (de 30 de abril a 29 de maio).

Importante: O valor tem de estar na Hora Universal Coordenada (UTC). Isto difere das opções de fuso horário quando carrega conversões offline na aplicação Web Microsoft Advertising. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Aplicar: Necessário		 dateTime
ConversionValue O valor de conversão offline.

Aplicar: Opcional. Se não especificar um valor de conversão offline, é utilizado o elemento Valor de ConversionGoalRevenue do objetivo.		 duplo
ExternalAttributionCredit Este campo só pode ser definido para ações de conversões que utilizam atribuição externa. Representa a fração da conversão atribuída a cada clique. O respetivo valor tem de ser maior do que 0 e inferior ou igual a 1.

Será devolvido um erro GoalNotEligibleForExternalAttribution se este campo for utilizado com uma ação de conversão não atribuída externamente.

Aplicar: Opcional		 duplo
ExternalAttributionModel Este campo só pode ser definido para ações de conversões que utilizam atribuição externa. Especifica o nome do modelo de atribuição.

Será devolvido um erro GoalNotEligibleForExternalAttribution se este campo for utilizado com uma ação de conversão não atribuída externamente.

Aplicar: Opcional		 cadeia
HashedEmailAddress O endereço de e-mail com hash utilizando o algoritmo SHA-256 para utilização com conversões melhoradas. cadeia
HashedPhoneNumber O número de telefone hash de acordo com a norma E.164 para utilização com conversões melhoradas. cadeia
MicrosoftClickId O MSCLKID para a conversão offline.

Para garantir que a etiquetagem automática está ativada para o controlo de ID de clique da Microsoft, utilize as operações GetAccountProperties e SetAccountProperties .

Aplicar: Opcional

Nota: o MSCLKID é opcional quando fornece um endereço de e-mail hash ou número de telefone para conversões melhoradas.		 cadeia

Requisitos

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

Utilizado Por

ApplyOfflineConversions