Objet de données OfflineConversionAdjustment - Gestion des campagnes
Définit un objet pour retirer ou reformater une conversion hors connexion via l’opération ApplyOfflineConversionAdjustments .
Vous pouvez ajuster le temps de conversion et la valeur des conversions hors connexion précédemment appliquées via l’opération ApplyOfflineConversions .
Syntaxe
<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>
Éléments
L’objet OfflineConversionAdjustment contient les éléments suivants : AdjustmentCurrencyCode, AdjustmentTime, AdjustmentType, AdjustmentValue, ConversionName, ConversionTime, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.
| Élément | Description | Type de données |
|---|---|---|
| AdjustmentCurrencyCode | Code monétaire pour la conversion hors connexion restée. Pour plus d’informations, consultez Devises. Appliquer: Obligatoire si AdjustmentType est défini sur « Restate », sinon ce champ est ignoré. Si vous ne spécifiez pas de code monétaire d’ajustement avec le réajustement, l’élément CurrencyCode de l’objectif ConversionGoalRevenue est utilisé. |
chaîne |
| AdjustmentTime | Date et heure auxquelles l’ajustement s’est produit. L’heure d’ajustement ne peut pas être antérieure à la date et à l’heure de conversion hors connexion d’origine. Important: La valeur doit être en temps universel coordonné (UTC). Cela diffère des options de fuseau horaire lorsque vous chargez des conversions hors connexion dans l’application web Microsoft Advertising. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs. Appliquer: Obligatoire |
dateTime |
| AdjustmentType | Détermine s’il faut retirer ou reformater la conversion hors connexion. Si cette valeur est « Restate », la conversion hors connexion précédemment attribuée à l’élément MicrosoftClickId spécifié est ajustée en fonction des nouveaux code AdjustCurrencyCode, AdjustmentTime et AdjustmentValue. Si cette valeur est « Retract », la conversion hors connexion précédemment attribuée au MicrosoftClickId spécifié est retirée ou supprimée. Appliquer: Obligatoire |
chaîne |
| Valeur d’ajustement | Valeur de conversion hors connexion ajustée. Appliquer: Obligatoire si AdjustmentType est défini sur « Restate », sinon ce champ ne doit pas être défini. |
Double |
| ConversionName | Nom de l’objectif de conversion. Ce nom doit correspondre à un nom d’objectif de conversion existant, sinon les données de l’objectif de conversion hors connexion ne seront pas appliquées. Appliquer: Obligatoire |
chaîne |
| ConversionTime | Date et heure auxquelles la conversion hors connexion d’origine s’est produite. La date et l’heure doivent être comprises dans les 90 derniers jours, sinon l’opération échoue lorsque vous tentez d’envoyer à Microsoft Advertising les données de conversion hors connexion. Pour être comptabilisé par Microsoft Advertising comme une conversion hors connexion après un chargement réussi, les conditions supplémentaires suivantes doivent être remplies : - La date et l’heure de la conversion doivent être définies après la date et l’heure du clic enregistré. - La date et l’heure doivent se trouver dans la fenêtre de conversion. La propriété ConversionWindowInMinutes de OfflineConversionGoal détermine la durée maximale en minutes après un clic pendant laquelle les conversions seront suivies. Par exemple, si trois clics ont été enregistrés le 30 avril, si conversionWindowInMinutes de OfflineConversionGoal est égal à 30 jours (43 200 minutes) et si vous envoyez à Microsoft Advertising les conversions hors connexion suivantes le 31 juillet, Microsoft Advertising ne comptera que celle avec MicrosoftClickId=2 comme conversion hors connexion. - 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 Les données de conversion hors connexion avec MicrosoftClickId=1 ne seront pas chargées, car la date et l’heure de conversion sont il y a plus de 90 jours et les données de conversion hors connexion avec MicrosoftClickId=3 ne seront pas comptabilisées, car elles ne sont pas comprises dans la fenêtre de conversion (du 30 avril au 29 mai). Important: La valeur doit être en temps universel coordonné (UTC). Cela diffère des options de fuseau horaire lorsque vous chargez des conversions hors connexion dans l’application web Microsoft Advertising. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs. Appliquer: Obligatoire |
dateTime |
| HashedEmailAddress | Adresse e-mail hachée utilisant l’algorithme SHA-256 pour une utilisation avec des conversions améliorées. | chaîne |
| HashedPhoneNumber | Numéro de téléphone haché conformément à la norme E.164 pour une utilisation avec des conversions améliorées. | chaîne |
| MicrosoftClickId | MSCLKID pour la conversion hors connexion. Pour vous assurer que l’étiquetage automatique est activé pour le suivi des ID de clic Microsoft, utilisez les opérations GetAccountProperties et SetAccountProperties . Appliquer: Optionnel Remarque : Le MSCLKID est facultatif lorsque vous fournissez une adresse e-mail hachée ou un numéro de téléphone pour les conversions améliorées. |
chaîne |
Configuration requise
Service : CampaignManagementService.svc v13
Noms: https://bingads.microsoft.com/CampaignManagement/v13