Partilhar via

Registo de Conversão Offline - Em massa

  • Artigo

Define uma conversão offline que pode ser carregada num ficheiro em massa.

Pode adicionar, reformular (atualizar) ou reativar (eliminar) conversões offline.

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.

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

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.

O seguinte exemplo de CSV em Massa adicionaria uma nova conversão offline.

Type,Status,Id,Parent Id,Client Id,Name,Conversion Currency Code,Conversion Name,Conversion Time,Conversion Value,Microsoft Click Id
Format Version,,,,,6.0,,,,,
Offline Conversion,,,,ClientIdGoesHere,,USD,My Goal Name,4/1/2020 6:50:54 PM,10,f894f652ea334e739002f7167ab8f8e3

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo com o BulkServiceManager para carregar o objeto BulkOfflineConversion , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkOfflineConversion
var bulkOfflineConversion = new BulkOfflineConversion
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    OfflineConversion = new OfflineConversion
    {
        // 'Conversion Currency Code' column header in the Bulk file
        ConversionCurrencyCode = "USD",
        // 'Conversion Name' column header in the Bulk file
        ConversionName = "My Goal Name",
        // 'Conversion Time' column header in the Bulk file
        ConversionTime = DateTime.UtcNow,
        // 'Conversion Value' column header in the Bulk file
        ConversionValue = 10,
        // 'Microsoft Click Id' column header in the Bulk file
        MicrosoftClickId = "f894f652ea334e739002f7167ab8f8e3"
    },

    // 'Adjustment Currency Code' column header in the Bulk file
    AdjustmentCurrencyCode = null,

    // 'Adjustment Time' column header in the Bulk file
    AdjustmentTime = null,

    // 'Adjustment Type' column header in the Bulk file
    AdjustmentType = null,

    // 'Adjustment Value' column header in the Bulk file
    AdjustmentValue = null,

    // 'External Attribution Credit' column header in the Bulk file
    ExternalAttributionCredit = null,

    // 'External Attribution Model' column header in the Bulk file
    ExternalAttributionModel = null,

    // 'Hashed Email Address' column header in the Bulk file
    HashedEmailAddress = null,

    // 'Hashed Phone Number' column header in the Bulk file
    HashedPhoneNumber = null
};

uploadEntities.Add(bulkOfflineConversion);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Para um registo de Conversão Offline , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Código de Moeda de Ajuste

O código de moeda para a conversão offline restada.

Para obter mais informações, veja Moedas.

Adicionar: Não aplicável
Reformular: Necessário. Se não especificar um código de moeda de ajuste com a reformulação, será utilizado o elemento CurrencyCode do conversionGoalRevenue do objetivo.
Retrair: Não aplicável

Tempo de Ajuste

A data e hora em que ocorreu o ajuste.

A hora de ajuste não pode ser anterior à data e hora da conversão offline original.

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.

Adicionar: Não aplicável
Reformular: Necessário
Retrair: Necessário

Tipo de Ajuste

Determina se pretende retrair ou reformular a conversão offline.

Se este valor for "Restate", a conversão offline atribuída anteriormente ao ID de Clique da Microsoft especificado será ajustada de acordo com o novo Código de Moeda de Ajuste, Tempo de Ajuste e Valor de Ajuste.

Se este valor for "Retrair", a conversão offline atribuída anteriormente ao ID de Clique da Microsoft especificado será retraída ou eliminada.

Adicionar: Não aplicável
Reformular: Necessário. Este campo tem de ser definido como "Reformular".
Retrair: Necessário. Este campo tem de ser definido como "Retrair".

Valor de Ajuste

O valor de conversão offline ajustado.

Adicionar: Não aplicável
Reformular: Necessário
Retrair: Não aplicável

ID de Cliente

Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.

Adicionar: Opcional
Reformular: Opcional
Retrair: Opcional

Código de Moeda de Conversão

O código de moeda para a conversão offline.

Para obter mais informações, veja Moedas.

Adicionar: Opcional. Se não especificar um código de moeda de conversão offline, será utilizado o elemento CurrencyCode do conversionGoalRevenue do objetivo.
Reformular: Não aplicável
Retrair: Não aplicável

Nome da Conversão

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.

Adicionar: Necessário
Reformular: Necessário
Retrair: Necessário

Tempo de Conversão

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.

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.

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).

Adicionar: Necessário
Reformular: Necessário
Retrair: Necessário

Valor de Conversão

O valor de conversão offline.

Adicionar: Opcional. Se não especificar um valor de conversão offline, é utilizado o elemento Valor de ConversionGoalRevenue do objetivo.
Reformular: Não aplicável
Retrair: Não aplicável

Crédito de Atribuição Externa

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

Modelo de Atribuição Externa

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

Endereço de E-mail com Hash

O endereço de e-mail com hash utilizando o algoritmo SHA-256 para utilização com conversões melhoradas.

Adicionar: Necessário para conversões melhoradas.
Reformular: Necessário para conversões melhoradas.
Retrair: Necessário para conversões melhoradas.

Número de Telefone Com Hash

O número de telefone hash de acordo com a norma E.164 para utilização com conversões melhoradas.

Adicionar: Necessário para conversões melhoradas.
Reformular: Necessário para conversões melhoradas.
Retrair: Necessário para conversões melhoradas.

ID de Clique da Microsoft

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 o campo MsCLKID Auto Tagging Enabled do registo Conta .

Adicionar: Obrigatório apenas se não enviar e-mail ou número de telefone com hash.
Reformular: Obrigatório apenas se não enviar e-mail ou número de telefone com hash.
Retrair: Obrigatório apenas se não enviar e-mail ou número de telefone com hash.