Objeto de Dados OfflineConversionAdjustment – Gestão de Campanhas
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