Partager via

Enregistrement d’étiquette d’annonce de texte développé - En bloc

  • Article

Définit un enregistrement d’association entre une annonce de texte développé et une étiquette qui peut être chargée et téléchargée dans un fichier en bloc. Pour charger ou télécharger l’étiquette ou l’annonce de texte développée, utilisez l’enregistrement Annonce de texte développé ou Étiquette .

Remarque

  • Mettez à niveau vos annonces textuelles développées en annonces de recherche réactives d’après le 1er février 2023. Après cette date, vous ne serez plus en mesure de créer ou de modifier des annonces textuelles développées existantes. Pour plus d’informations, consultez À propos des annonces de recherche réactive.
  • Les annonces textuelles développées existantes continueront à être diffusées et vous serez en mesure d’afficher des rapports sur leurs performances.
  • Vous pourrez toujours suspendre, activer ou supprimer vos annonces textuelles développées. Dans le cas contraire, les tentatives d’ajout ou de mise à jour d’annonces textuelles développées entraînent une CampaignServiceAdTypeInvalid erreur.
  • En savoir plus sur cette modification.

Vous pouvez télécharger tous les enregistrements d’étiquette d’annonce de texte développé dans le compte en incluant la valeur DownloadEntity de ExpandedTextAdLabels 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 applique une étiquette à une annonce de texte développé si des valeurs ID et ID parent valides sont fournies.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Expanded Text Ad Label,,-22,-11112,,,ClientIdGoesHere,,,,,

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 BulkExpandedTextAdLabel , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ du fichier en bloc.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkExpandedTextAdLabel
var bulkExpandedTextAdLabel = new BulkExpandedTextAdLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = expandedTextAdIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkExpandedTextAdLabel);

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

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
Supprimer: En lecture seule

ID

Identificateur de l’étiquette qui est appliquée ou supprimée de l’annonce de texte développée.

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

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur d’étiquette existant ou un identificateur négatif égal au champ Id de l’enregistrement Label parent. Cette option est recommandée si vous appliquez de nouvelles étiquettes à des annonces texte développées 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.
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
Supprimer: En lecture seule

Parent Id

Identificateur de l’annonce de texte développée dans laquelle cette étiquette est appliquée ou supprimée.

Ce champ en bloc est mappé au champ Id de l’enregistrement d’annonce en texte développé .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur d’annonce de texte développé existant ou un identificateur négatif égal au champ Id de l’enregistrement d’annonce de texte développé parent. Cette option est recommandée si vous appliquez des étiquettes à une nouvelle annonce de texte développée 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.
Supprimer: Lecture seule et Obligatoire

Statut

Représente le status appliqué entre l’annonce de texte développée et l’étiquette.

Les valeurs possibles sont Active et Deleted. Si l’étiquette est appliquée à l’annonce de texte développée, la valeur de ce champ est Active.

Ajouter: En lecture seule
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.