Partager via

Enregistrement d’association de liste de remarketing basé sur l’impression de campagne - En bloc

  • Article

Définit une association de liste de remarketing basée sur l’impression de campagne qui peut être chargée et téléchargée dans un fichier en bloc.

Les cibles d’audience ne peuvent pas être définies au niveau de la campagne et du groupe d’annonces. Si vous définissez des critères d’audience au niveau de la campagne biddable, vous ne pouvez pas définir de critères d’audience au niveau du groupe d’annonces biddables. Les exclusions d’audience peuvent être définies au niveau de la campagne et du groupe d’annonces. Microsoft Advertising applique une union d’exclusions au niveau de la campagne et du groupe d’annonces.

Conseil

Pour obtenir une vue d’ensemble et plus d’informations sur les audiences, consultez le guide technique des API d’audience .

Vous pouvez télécharger tous les enregistrements d’association de listes de remarketing basées sur l’impression de campagne dans le compte en incluant la valeur DownloadEntity de CampaignImpressionBasedRemarketingListAssociations dans la demande de service DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . En outre, la demande de téléchargement doit inclure l’étendue EntityData . Pour plus d’informations sur le service en bloc, y compris les meilleures pratiques, consultez Téléchargement et chargement en bloc.

L’exemple csv en bloc suivant ajoute une nouvelle association de liste de remarketing basée sur l’impression de campagne si une valeur d’ID parent valide est fournie.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Campaign Impression Based Remarketing List Association,Paused,,-1111,,,ClientIdGoesHere,,10,,ImpressionBasedRemarketingListIdHere,My Impression Based Remarketing List

Si vous utilisez les sdk Bing Ads pour .NET, Java ou Python, vous pouvez gagner du temps à l’aide de BulkServiceManager pour charger et télécharger l’objet BulkCampaignImpressionBasedRemarketingListAssociation , 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 BulkCampaignImpressionBasedRemarketingListAssociation
var bulkCampaignImpressionBasedRemarketingListAssociation = new BulkCampaignImpressionBasedRemarketingListAssociation
{
    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.
    BiddableCampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = impressionBasedRemarketingListIdKey,
        },
        // 'Bid Adjustment' column header in the Bulk file
        CriterionBid = new BidMultiplier
        {
            Multiplier = 10
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.Paused
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Audience' column header in the Bulk file
    AudienceName = null,
};

uploadEntities.Add(bulkCampaignImpressionBasedRemarketingListAssociation);

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 Association de liste de remarketing basé sur l’impression de campagne, les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Audience

Nom de la liste de remarketing basée sur l’impression.

Ce champ en bloc est mappé au champ Audience de l’enregistrement liste de remarketing basé sur l’impression .

Ajouter: En lecture seule et Obligatoire pour certains cas d’usage. Vous devez spécifier le champ Audience ou Id d’audience . Si vous ajoutez de nouvelles associations de listes de remarketing basées sur l’impression de campagne avec de nouvelles listes de remarketing basées sur l’impression dans le même fichier en bloc, et si vous ne définissez pas le champ Id d’audience, ce champ Audience doit être défini en tant que clé logique avec la même valeur que le champ Audience de l’enregistrement liste de remarketing basé sur l’impression . Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: En lecture seule
Supprimer: En lecture seule

ID d’audience

Identificateur Microsoft Advertising de la liste de remarketing basée sur l’impression associée à la campagne.

Ce champ en bloc est mappé au champ Id de l’enregistrement liste de remarketing basé sur l’impression .

Ajouter: En lecture seule et Obligatoire pour certains cas d’usage. Vous devez spécifier le champ Audience ou Id d’audience . Si vous définissez le champ Id d’audience , vous devez spécifier un identificateur de liste de remarketing basé sur l’impression existant ou un identificateur négatif égal au champ Id de l’enregistrement parent de liste de remarketing basé sur l’impression . Si le champ Id d’audience n’est pas défini, vous devez définir le champ Audience en tant que clé logique sur la même valeur que le champ Audience de l’enregistrement liste de remarketing basé sur l’impression . L’une de ces options est recommandée si vous ajoutez de nouvelles associations de listes de remarketing basées sur l’impression de campagne avec de nouvelles listes de remarketing basées sur l’impression dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Ajustement de l’enchère

Pourcentage que vous souhaitez augmenter/diminuer le montant de l’offre pour la liste de remarketing basée sur l’impression.

Les valeurs prises en charge sont négatives quatre-vingt-dix (-90,00) à neuf cents (900,00) positives.

Importante

Si elle n’est pas spécifiée, la valeur d’ajustement de l’enchère par défaut est 0. La valeur par défaut est susceptible d’être modifiée.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule

Campagne

Nom de la campagne associée à la liste de remarketing basée sur l’impression.

Ajouter: Lecture seule et Obligatoire
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Remarque

Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Campagne .

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
Mettre à jour: Optionnel
Supprimer: En lecture seule

ID

Identificateur généré par le système pour l’association entre une campagne et une liste de remarketing basée sur l’impression.

Ajouter: En lecture seule
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Heure de modification

Date et heure de la dernière mise à jour de l’entité. La valeur est exprimée au format UTC (temps universel coordonné).

Remarque

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. 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: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Parent Id

Identificateur généré par le système de la campagne associée à la liste de remarketing basée sur l’impression.

Ce champ en bloc est mappé au champ Id de l’enregistrement de campagne .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de campagne existant ou un identificateur négatif égal au champ Id de l’enregistrement de campagne parent. Cela est recommandé si vous associez des listes de remarketing basées sur l’impression à une nouvelle campagne dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Remarque

Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Campagne .

État

État de l’association.

Les valeurs possibles sont Active, Paused ou Deleted.

Ajouter: Optionnel. La valeur d’état par défaut est Active.
Mettre à jour: Optionnel
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.