Partager via

Enregistrement de conversion hors connexion - En bloc

  • Article

Définit une conversion hors connexion qui peut être chargée dans un fichier en bloc.

Vous pouvez ajouter, reformater (mettre à jour) ou restracter (supprimer) des conversions hors connexion.

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.

Vous devez créer OfflineConversionGoal via l’API Gestion des campagnes pour définir la propriété IsExternallyAttributed .

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.

L’exemple csv en bloc suivant ajoute une nouvelle conversion hors connexion.

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

Si vous utilisez les Kits de développement logiciel (SDK) Bing Ads pour .NET, Java ou Python, vous pouvez gagner du temps à l’aide de BulkServiceManager pour charger l’objet BulkOfflineConversion , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ dans le fichier en bloc.

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();

Pour un enregistrement de conversion hors connexion , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Code monétaire d’ajustement

Code monétaire pour la conversion hors connexion restée.

Pour plus d’informations, consultez Devises.

Ajouter: Sans objet
Réaffirmer: Obligatoire. 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é.
Se rétracter: Sans objet

Heure d’ajustement

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.

Importante

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.

Ajouter: Sans objet
Réaffirmer: Obligatoire
Se rétracter: Obligatoire

Type d’ajustement

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’ID de clic Microsoft spécifié sera ajustée en fonction du nouveau code monétaire d’ajustement, de l’heure d’ajustement et de la valeur d’ajustement.

Si cette valeur est « Retirer », la conversion hors connexion précédemment attribuée à l’ID de clic Microsoft spécifié est retirée ou supprimée.

Ajouter: Sans objet
Réaffirmer: Obligatoire. Ce champ doit être défini sur « Restate ».
Se rétracter: Obligatoire. Ce champ doit être défini sur « Retirer ».

Valeur d’ajustement

Valeur de conversion hors connexion ajustée.

Ajouter: Sans objet
Réaffirmer: Obligatoire
Se rétracter: Sans objet

ID client

Permet d’associer des enregistrements du fichier de chargement en bloc aux enregistrements du fichier de résultats. La valeur de ce champ n’est pas utilisée ou stockée par le serveur ; il est simplement copié de l’enregistrement chargé vers l’enregistrement de résultat correspondant. Il peut s’agir d’une chaîne valide d’une longueur maximale de 100.

Ajouter: Optionnel
Réaffirmer: Optionnel
Se rétracter: Optionnel

Code monétaire de conversion

Code monétaire pour la conversion hors connexion.

Pour plus d’informations, consultez Devises.

Ajouter: 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é.
Réaffirmer: Sans objet
Se rétracter: Sans objet

Nom de la conversion

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.

Ajouter: Obligatoire
Réaffirmer: Obligatoire
Se rétracter: Obligatoire

Temps de conversion

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.

Importante

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.

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 plus tard que 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).

Ajouter: Obligatoire
Réaffirmer: Obligatoire
Se rétracter: Obligatoire

Valeur de conversion

Valeur de conversion hors connexion.

Ajouter: Optionnel. Si vous ne spécifiez pas de valeur de conversion hors connexion, l’élément Value de l’objectif ConversionGoalRevenue est utilisé.
Réaffirmer: Sans objet
Se rétracter: Sans objet

Crédit d’attribution externe

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

Modèle d’attribution externe

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

Adresse e-mail hachée

Adresse e-mail hachée utilisant l’algorithme SHA-256 pour une utilisation avec des conversions améliorées.

Ajouter: Requis pour les conversions améliorées.
Réaffirmer: Requis pour les conversions améliorées.
Se rétracter: Requis pour les conversions améliorées.

Numéro de téléphone haché

Numéro de téléphone haché conformément à la norme E.164 pour une utilisation avec des conversions améliorées.

Ajouter: Requis pour les conversions améliorées.
Réaffirmer: Requis pour les conversions améliorées.
Se rétracter: Requis pour les conversions améliorées.

Id de clic Microsoft

MSCLKID pour la conversion hors connexion.

Pour vous assurer que l’étiquetage automatique est activé pour le suivi des ID de clic Microsoft, utilisez le champ MscLKID Auto Tagging Enabled de l’enregistrement de compte .

Ajouter: Obligatoire uniquement si l’envoi d’un e-mail haché ou d’un numéro de téléphone n’est pas envoyé.
Réaffirmer: Obligatoire uniquement si l’envoi d’un e-mail haché ou d’un numéro de téléphone n’est pas envoyé.
Se rétracter: Obligatoire uniquement si l’envoi d’un e-mail haché ou d’un numéro de téléphone n’est pas envoyé.