Partager via

Objet de données OfflineConversion - Gestion des campagnes

  • Article

Définit une conversion hors connexion que vous envoyez à Microsoft Advertising.

Pour configurer le suivi des conversions hors connexion, créez un OfflineConversionGoal. Si vous définissez CountType de OfflineConversionGoal sur All, toutes les conversions hors connexion pour le même MicrosoftClickId avec des durées de conversion différentes sont ajoutées de manière cumulative. Si vous définissez CountType de OfflineConversionGoal sur Unique, seule la première conversion qui se produit après un clic publicitaire sera comptabilisée. Les conversions hors connexion dupliquées avec les mêmes MicrosoftClickId et ConversionTime seront ignorées. En d’autres termes, seule la première conversion hors connexion pour un MicrosoftClickId et un ConversionTime donnés sont comptés.

Importante

Une fois offlineConversionGoal configuré, patientez deux heures, puis envoyez à Microsoft Advertising les données OfflineConversion via l’opération ApplyOfflineConversions . L’affichage des données de conversion dans les rapports Microsoft Advertising peut prendre jusqu’à six heures.

Remarque

Bien que vous puissiez charger des conversions hors connexion dans le bac à sable à des fins de test fonctionnel, les données de conversion hors connexion ne seront pas attribuées dans les données de rapports de performances du bac à sable.

Syntaxe

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

Éléments

L’objet OfflineConversion contient les éléments suivants : ConversionCurrencyCode, ConversionName, ConversionTime, ConversionValue, ExternalAttributionCredit, ExternalAttributionModel, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

Élément Description Type de données
ConversionCurrencyCode Code monétaire pour la conversion hors connexion.

Pour plus d’informations, consultez Devises.

Appliquer: Optionnel. Si vous ne spécifiez pas de code monétaire de conversion hors connexion, l’élément CurrencyCode de l’objectif ConversionGoalRevenue est utilisé.		 chaîne
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 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
ConversionValue Valeur de conversion hors connexion.

Appliquer: Optionnel. Si vous ne spécifiez pas de valeur de conversion hors connexion, l’élément Value de l’objectif ConversionGoalRevenue est utilisé.		 double
ExternalAttributionCredit Ce champ ne peut être défini que pour les actions de conversion qui utilisent l’attribution externe. Il représente la fraction de la conversion qui est attribuée à chaque clic. Sa valeur doit être supérieure à 0 et inférieure ou égale à 1.

Une erreur GoalNot EligibleForExternalAttribution est retournée si ce champ est utilisé avec une action de conversion non attribuée à l’externe.

Appliquer: Optionnel		 double
ExternalAttributionModel Ce champ ne peut être défini que pour les actions de conversion qui utilisent l’attribution externe. Il spécifie le nom du modèle d’attribution.

Une erreur GoalNot EligibleForExternalAttribution est retournée si ce champ est utilisé avec une action de conversion non attribuée à l’externe.

Appliquer: Optionnel		 chaîne
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
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

ApplyOfflineConversions