Partager via

Enregistrement d’annonces d’hôtel - En bloc

  • Article

Définit une annonce d’hôtel qui peut être téléchargée et chargée dans un fichier en bloc.

Une annonce d’hôtel n’est pas utilisée directement pour la copie de l’annonce remise. Au lieu de cela, le moteur de livraison génère des annonces d’hôtel à partir des détails de l’hôtel qu’il trouve dans le catalogue du magasin Microsoft Merchant Center du client.

Vous pouvez télécharger tous les enregistrements Hotel Ad dans le compte en incluant la valeur DownloadEntity de HotelAds 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 annonce d’hôtel si une valeur d’ID parent valide est fournie.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Hotel Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,

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 et télécharger l’objet BulkHotelAd , 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 BulkHotelAd
var bulkHotelAd = new BulkHotelAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // HotelAd object of the Campaign Management service.
    HotelAd = new HotelAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Promotion' column header in the Bulk file
        PromotionalText = "Find New Customers & Increase Sales!",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
    },
};

uploadEntities.Add(bulkHotelAd);

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 Hotel Ad , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Groupe d’annonces

Nom du groupe d’annonces qui contient la publicité.

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 Groupe d’annonces .

Campagne

Nom de la campagne qui contient le groupe d’annonces et l’annonce.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

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

État de l’appel éditorial

Détermine si vous pouvez faire appel des problèmes détectés par la révision éditoriale.

Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur Description
Appelable La question éditoriale peut faire l’objet d’un appel.
AppelPending La question éditoriale peut faire l’objet d’un appel et un appel a été déposé.
NotAppealable La question éditoriale n’est pas appelable.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Emplacement éditorial

Composant ou propriété de l’annonce qui a échoué à la révision éditoriale.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Code de raison éditorial

Code qui identifie la raison de l’échec. Pour obtenir la liste des codes de raison possibles, consultez Codes de raison éditorial.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

État éditorial

La status éditoriale de l’annonce.

Les valeurs possibles sont décrites dans le tableau ci-dessous.

Valeur Description
Actif L’annonce a fait l’objet d’une révision éditoriale.
ActiveLimited L’annonce a fait l’objet d’une révision éditoriale dans un ou plusieurs marchés, et un ou plusieurs éléments de la publicité font l’objet d’une révision éditoriale dans un autre marché. Par exemple, l’annonce a passé une révision éditoriale pour le Canada et est toujours en attente d’examen dans le États-Unis.
Désapprouvé L’annonce a échoué à la révision éditoriale.
Inactif Un ou plusieurs éléments de l’annonce font l’objet d’une révision éditoriale.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Terme éditorial

Terme qui a échoué à la révision éditoriale.

Ce champ n’est pas défini si une combinaison de termes a provoqué l’échec ou si l’échec est basé sur une violation de stratégie.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

ID

Identificateur généré par le système de la publicité.

Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un identificateur négatif défini pour la publicité peut ensuite être référencé dans le champ Id parent des types d’enregistrements dépendants tels que Hotel Ad Label. Cette option est recommandée si vous ajoutez de nouvelles annonces et de nouveaux enregistrements dépendants 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

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 du groupe d’annonces qui contient la publicité.

Ce champ en bloc est mappé au champ Id de l’enregistrement groupe d’annonces .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de groupe d’annonces existant ou un identificateur négatif égal au champ Id de l’enregistrement de groupe d’annonces parent. Cette option est recommandée si vous ajoutez de nouvelles annonces à un nouveau groupe d’annonces 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

Remarque

Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Groupe d’annonces .

Pays d’éditeur

Liste des pays ou régions de l’éditeur dont les directives éditoriales n’autorisent pas le terme spécifié.

Dans un fichier en bloc, la liste des pays ou régions de l’éditeur est délimitée par un point-virgule (;).

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Statut

Status de l’annonce.

Les valeurs possibles sont Active, Paused ou Deleted.

Ajouter: Optionnel. La valeur par défaut est Active.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.