Enregistrement d’annonce de texte - En bloc
Définit une annonce texte qui peut être téléchargée et chargée dans un fichier en bloc.
Importante
À compter d’avril 2020, la distribution d’annonces texte standart (STA) n’est pas prise en charge.
Les annonces de texte standard ont été déconseillées en faveur des annonces de texte développées (EXTAs). La prise en charge de l’ajout et de la mise à jour d’annonces texte standard a pris fin le 31 juillet 2017. Désormais, les annonceurs peuvent obtenir et supprimer, mais ne peuvent plus ajouter de nouveaux contrats STA ou mettre à jour les annonces texte standard existantes. Une exception à la règle est que vous pouvez toujours mettre à jour le status STA, par exemple de Actif à Suspendu. Sinon, les tentatives d’ajout ou de mise à jour des MDA entraînent l’erreur CampaignServiceAdTypeInvalid .
Vous pouvez télécharger tous les enregistrements d’annonce de texte dans le compte en incluant la valeur DownloadEntity de TextAds 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 de texte 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,,,,,,,,,,
Text Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,contoso.com,,,All,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,,,,
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 BulkTextAd , 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 BulkTextAd
var bulkTextAd = new BulkTextAd
{
// '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
// TextAd object of the Campaign Management service.
TextAd = new TextAd
{
// 'Ad Format Preference' column header in the Bulk file
AdFormatPreference = "All",
// 'Destination Url' column header in the Bulk file
DestinationUrl = null,
// 'Device Preference' column header in the Bulk file
DevicePreference = 0,
// 'Display Url' column header in the Bulk file
DisplayUrl = "contoso.com",
// 'Mobile Final Url' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/womenshoesale"
},
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/womenshoesale"
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales!",
// 'Title' column header in the Bulk file
Title = "Contoso Quick Setup",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
},
};
uploadEntities.Add(bulkTextAd);
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’annonce de texte , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
- Préférence de format d’annonce
- Groupe d’annonces
- Campagne
- Client Id
- Paramètre personnalisé
- Préférence d’appareil
- URL d’affichage
- État de l’appel éditorial
- Emplacement éditorial
- Code de raison éditorial
- État éditorial
- Terme éditorial
- URL finale
- Id
- URL finale mobile
- Heure de modification
- Parent Id
- Pays d’éditeur
- État
- Texte
- Titre
- Modèle de suivi
Préférence de format d’annonce
Le champ Préférence de format d’annonce est utilisé pour indiquer si vous préférez ou non que la copie de l’annonce soit présentée aux utilisateurs sous la forme d’une annonce de recherche ou d’audience. Les annonces de recherche ont tendance à être écrites comme un appel à l’action, tandis que les publicités d’audience doivent être écrites dans un style plus informationnel. Bien que vous ayez la possibilité d’utiliser des annonces de texte de recherche comme publicités d’audience, la conception d’une annonce comme format préféré des publicités d’audience vous permet d’optimiser sa messagerie pour la distribution native.
Importante
Vous devez définir au moins une annonce de texte par groupe d’annonces qui ne préfère pas les publicités d’audience, sinon la copie de toutes les annonces textuelles sera éligible pour les annonces de recherche et d’audience.
Les valeurs possibles sont Audience Ad et All. Si elle est définie sur Tous, l’annonce est éligible aux formats d’annonces de recherche et d’audience. Si elle est définie sur Publicité d’audience, la publicité est uniquement éligible au format d’annonce d’audience.
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: En lecture seule
Groupe d’annonces
Nom du groupe d’annonces qui contient la publicité.
Ajouter: Non pris en charge
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
Remarque
Pour la mise à jour et la suppression, 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: Non pris en charge
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: Non pris en charge
Mettre à jour: Optionnel
Supprimer: En lecture seule
Paramètre personnalisé
Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL.
Dans un fichier en bloc, la liste des paramètres personnalisés est mise en forme comme suit.
Mettez en forme chaque paire de paramètres personnalisés en tant que Clé=Valeur, par exemple {_promoCode}=PROMO1.
Microsoft Advertising accepte les 8 premières paires clé/valeur de paramètres personnalisés que vous incluez, et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée. Chaque paire clé-valeur est délimitée par un point-virgule et un espace (« ; »), par exemple {_promoCode}=PROMO1 ; {_season}=été.
Une clé ne peut pas contenir de point-virgule. Si une valeur contient un point-virgule, elle doit être placée dans une séquence d’échappement en tant que « \ ; ». En outre, si la valeur contient une barre oblique inverse, elle doit également être placée dans une séquence d’échappement en tant que « \ ».
La clé ne peut pas dépasser 16 UTF-8 octets, et la valeur ne peut pas dépasser 250 UTF-8 octets. La clé est obligatoire et la valeur est facultative. La taille maximale de la clé n’inclut pas les accolades et le trait de soulignement, c’est-à-dire « { », « _ » et « } ».
Remarque
Avec le service en bloc, la clé doit être mise en forme avec des accolades environnantes et un trait de soulignement de début. Par exemple, si la clé est promoCode, elle doit être mise en forme comme {_promoCode}. Avec le service Gestion des campagnes, vous ne pouvez pas spécifier les accolades et le trait de soulignement environnants.
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: En lecture seule
Préférence d’appareil
Ce champ détermine si la préférence est que les annonces textuelles soient affichées sur tous les appareils ou uniquement sur les appareils mobiles.
Les valeurs possibles sont All et Mobile, qui diffèrent des valeurs utilisées dans le service de gestion des campagnes.
SixMonths
Dans le fichier de résultats de téléchargement et de chargement en bloc, ce champ n’est jamais vide. Si vous n’avez pas spécifié de préférence d’appareil, la valeur par défaut All est retournée.
Importante
Vous devez définir au moins une annonce texte par groupe d’annonces qui n’est pas recommandée pour les appareils mobiles, sinon la copie de toutes les annonces textuelles sera éligible pour tous les appareils.
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: En lecture seule
URL d’affichage
URL à afficher dans l’annonce.
Le sous-répertoire de l’URL d’affichage peut contenir des chaînes de texte dynamiques telles que {mot clé} ; toutefois, le nom d’hôte de l’URL ne peut pas contenir de texte dynamique. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.
La longueur d’entrée maximale de l’URL est de 200 caractères et peut contenir des chaînes de texte dynamiques. Toutefois, l’affichage de l’annonce échoue si l’URL dépasse 35 caractères après la substitution de texte dynamique.
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
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.
Ajouter: Non pris en charge
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: Non pris en charge
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: Non pris en charge
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.
Ajouter: Non pris en charge
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: Non pris en charge
Mettre à jour: En lecture seule
Supprimer: En lecture seule
URL finale
URL de la page d’accueil.
Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales.
La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
Vous pouvez spécifier jusqu’à 10 éléments pour les URL finales et les URL mobiles finales . Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service en autorise jusqu’à 10 pour une compatibilité descendante potentielle.
Chaque URL est délimitée par un point-virgule et un espace (« ; »).
L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple « {lpurl} ».
Chaque URL doit être une URL bien formée commençant par http:// ou https://.
Si vous spécifiez les URL Final Mobile, vous devez également spécifier l’URL finale.
Notez également que si les champs Modèle de suivi ou Paramètre personnalisé sont définis, au moins une URL finale est requise.
Remarque
Cette URL est utilisée uniquement si le mot clé ne spécifie pas d’URL finale.
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
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 Text 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
URL finale mobile
URL de la page d’accueil mobile.
Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales.
La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
Vous pouvez spécifier jusqu’à 10 éléments pour les URL finales et les URL mobiles finales . Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service en autorise jusqu’à 10 pour une compatibilité descendante potentielle.
Chaque URL est délimitée par un point-virgule et un espace (« ; »).
L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple « {lpurl} ».
Chaque URL doit être une URL bien formée commençant par http:// ou https://.
Si vous spécifiez les URL Final Mobile, vous devez également spécifier l’URL finale.
Remarque
Cette URL est utilisée uniquement si le mot clé ne spécifie pas d’URL finale mobile.
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: En lecture seule
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: Non pris en charge
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: Non pris en charge
Mettre à jour: En lecture seule
Supprimer: En lecture seule
Remarque
Pour la mise à jour et la suppression, 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: Non pris en charge
Mettre à jour: En lecture seule
Supprimer: En lecture seule
Statut
Status de l’annonce.
Les valeurs possibles sont Active, Paused ou Deleted.
Ajouter: Non pris en charge
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é.
Texte
Copie de l’annonce.
Le texte doit contenir au moins un mot et peut contenir des chaînes de texte dynamiques telles que {mot clé}. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.
La longueur d’entrée maximale de la copie est de 300 caractères et peut contenir des chaînes de texte dynamiques. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur dépasse 80 caractères après la substitution de texte dynamique. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, la longueur d’entrée maximale de la copie est de 150 caractères et que le texte est limité à 40 caractères après substitution.
Le texte ne peut pas contenir le caractère de nouvelle ligne (\n).
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: En lecture seule
Titre
Titre de l’annonce.
Le titre doit contenir au moins un mot. La copie et le titre de l’annonce combinés doivent totaler au moins trois mots.
Le titre peut contenir des chaînes de texte dynamiques telles que {mot clé}. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.
La longueur d’entrée maximale du titre est de 80 caractères et peut contenir des chaînes de texte dynamiques. L’affichage de l’annonce échoue ou le texte par défaut est utilisé si la longueur dépasse 25 caractères après la substitution de texte dynamique. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, le titre est limité à 15 caractères après substitution.
Le titre ne peut pas contenir le caractère de nouvelle ligne (\n).
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: En lecture seule
Modèle de suivi
Modèle de suivi à utiliser comme valeur par défaut pour l’URL spécifiée avec FinalUrls.
Les règles de validation suivantes s’appliquent aux modèles de suivi. Pour plus d’informations sur les modèles et paramètres pris en charge, consultez l’article d’aide Microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?
Les modèles de suivi définis pour les entités de niveau inférieur, par exemple, les publicités remplacent ceux définis pour les entités de niveau supérieur, par exemple la campagne. Pour plus d’informations, consultez Limites d’entité.
La longueur du modèle de suivi est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
Le modèle de suivi doit être une URL bien formée commençant par l’une des suivantes : http://, https://, {lpurl} ou {unscapedlpurl}.
Microsoft Advertising ne vérifie pas s’il existe des paramètres personnalisés. Si vous utilisez des paramètres personnalisés dans votre modèle de suivi et qu’ils n’existent pas, l’URL de la page d’accueil inclut les espaces réservés de clé et de valeur de vos paramètres personnalisés sans substitution. Par exemple, si votre modèle de suivi est
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}et que ni {_season} ni {_promocode} n’est défini au niveau de la campagne, du groupe d’annonces, du critère, du mot clé ou de la publicité, l’URL de la page d’accueil sera la même.
Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: En lecture seule