Partilhar via

Objeto de Dados OfflineConversionAdjustment – Gestão de Campanhas

  • Artigo

Define um objeto para retrair ou reformular uma conversão offline através da operação ApplyOfflineConversionAdjustments .

Pode ajustar o tempo e o valor de conversão para conversões offline aplicadas anteriormente através da operação ApplyOfflineConversions .

Sintaxe

<xs:complexType name="OfflineConversionAdjustment" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdjustmentCurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="AdjustmentTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="AdjustmentType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="AdjustmentValue" nillable="true" type="xs:double" />
    <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="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 OfflineConversionAdjustment tem os seguintes elementos: AdjustmentCurrencyCode, AdjustmentTime, AdjustmentType, AdjustmentValue, ConversionName, ConversionTime, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

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

Para obter mais informações, veja Moedas.

Aplicar: Necessário se AdjustmentType estiver definido como "Reformular" e, caso contrário, este campo for ignorado. Se não especificar um código de moeda de ajuste com a reformulação, será utilizado o elemento CurrencyCode do conversionGoalRevenue do objetivo.		 cadeia
AdjustmentTime 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.

Aplicar: Necessário		 dateTime
AdjustmentType Determina se pretende retrair ou reformular a conversão offline.

Se este valor for "Restate", a conversão offline atribuída anteriormente ao MicrosoftClickId especificado será ajustada de acordo com o novo AdjustmentCurrencyCode, AdjustmentTime e AdjustmentValue.

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

Aplicar: Necessário		 cadeia
AdjustmentValue O valor de conversão offline ajustado.

Aplicar: Necessário se AdjustmentType estiver definido como "Reformular" e, caso contrário, este campo não deve ser definido.		 duplo
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 original.

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

ApplyOfflineConversionAdjustments