Enregistrement publicitaire de recherche dynamique - En bloc

Définit une annonce de recherche dynamique qui peut être téléchargée et chargée dans un fichier en bloc.

Avec les annonces de recherche dynamique, le titre et l’URL d’affichage sont générés automatiquement en fonction du domaine et de la langue du site web que vous souhaitez cibler. La combinaison des éléments Path1, Path2 et Text rend la publicité de recherche dynamique unique. Si vous le souhaitez, vous pouvez fournir un titre statique à l’aide de flux de page.

L’enregistrement d’annonce de recherche dynamique ne peut être créé que dans les campagnes de recherche qui ont des paramètres d’annonces de recherche dynamique valides (comprenant les champs Langue de domaine, Description dynamique activée, ID de flux de page, Source et Site web ). L’ID d’expérience de la campagne doit être défini et le type de groupe d’annonces doit être défini sur « SearchDynamic ».

Vous pouvez télécharger tous les enregistrements d’annonces de recherche dynamique dans le compte en incluant la valeur DownloadEntity de DynamicSearchAds 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 recherche dynamique 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,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,
Dynamic Search Ad,Active,,-1113,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,,,,,,,,,,,,{_promoCode}=PROMO1; {_season}=summer,,,seattle,shoe sale

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 BulkDynamicSearchAd , 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 BulkDynamicSearchAd
var bulkDynamicSearchAd = new BulkDynamicSearchAd
{
    // '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 
    // DynamicSearchAd object of the Campaign Management service.
    DynamicSearchAd = new DynamicSearchAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Path 1' column header in the Bulk file
        Path1 = "seattle",
        // 'Path 2' column header in the Bulk file
        Path2 = "shoe sale",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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(bulkDynamicSearchAd);

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 publicitaire de recherche dynamique , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc. La combinaison des champs Path 1, Path 2 et Text rend la publicité de recherche dynamique unique.

• Groupe d’annonces
• Campagne
• Client Id
• Paramètre personnalisé
• État de l’appel éditorial
• Emplacement éditorial
• Code de raison éditorial
• État éditorial
• Terme éditorial
• Suffixe d’URL final
• Id
• Heure de modification
• Parent Id
• Chemin d’accès 1
• Chemin d’accès 2
• Pays d’éditeur
• État
• Texte
• Modèle de suivi

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

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

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: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer tous les paramètres personnalisés, définissez ce champ sur delete_value. Le delete_value mot clé supprime le paramètre précédent. Pour supprimer un sous-ensemble de paramètres personnalisés, spécifiez les paramètres personnalisés que vous souhaitez conserver et omettez ceux que vous ne souhaitez pas conserver. Le nouvel ensemble de paramètres personnalisés remplace tout jeu de paramètres personnalisé précédent.
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: 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.

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

Suffixe d’URL final

Le suffixe d’URL final peut inclure des paramètres de suivi qui seront ajoutés à la fin de l’URL de votre page d’accueil. Nous vous recommandons de placer les paramètres de suivi requis par votre page d’accueil dans un suffixe d’URL final afin que vos clients soient toujours envoyés à votre page d’accueil. Pour plus d’informations et les règles de validation, consultez Suffixe d’URL final dans les guides techniques.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
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 l’étiquette d’annonce de recherche dynamique. 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é).

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

Chemin d’accès 1

Première partie du chemin d’accès facultatif qui sera ajouté à la partie domaine de votre URL d’affichage. L’URL d’affichage, par exemple , www.contoso.com sera générée à partir du domaine de votre URL d’affichage. Ensuite, si vous avez spécifié une valeur pour Chemin d’accès 1 , elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour chemin d’accès 2, elle est également ajoutée à l’URL d’affichage après le chemin d’accès 1. Par exemple, si votre domaine est contoso.com, que le chemin d’accès 1 est défini sur sous-répertoire1 et que le chemin d’accès 2 est défini sur sous-répertoire2, l’URL affichée est www.contoso.com/subdirectory1/subdirectory2.

La longueur d’entrée maximale du chemin d’accès est de 15 caractères. Notez que pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale du chemin d’accès est de 7 caractères.

Le chemin d’accès peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

Le chemin d’accès ne peut pas contenir la barre oblique (/) ou les caractères de nouvelle ligne (\n).

Si le chemin d’accès comprend un espace, il est remplacé par un trait de soulignement (_) lorsque l’annonce est affichée.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

Chemin d’accès 2

Deuxième partie du chemin facultatif qui sera ajouté à la partie domaine de votre URL d’affichage. L’URL d’affichage, par exemple , www.contoso.com sera générée à partir du domaine de vos paramètres de niveau de campagne d’annonces de recherche dynamique. Ensuite, si vous avez spécifié une valeur pour Chemin d’accès 1 , elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour chemin d’accès 2, elle est également ajoutée à l’URL d’affichage après le chemin d’accès 1. Par exemple, si votre domaine est contoso.com, que le chemin d’accès 1 est défini sur sous-répertoire1 et que le chemin d’accès 2 est défini sur sous-répertoire2, l’URL affichée est www.contoso.com/subdirectory1/subdirectory2.

Vous ne pouvez spécifier le chemin d’accès 2 que si le chemin d’accès 1 est également défini.

La longueur d’entrée maximale du chemin d’accès est de 15 caractères. Notez que pour les langues avec des caractères à double largeur, par exemple le chinois traditionnel, la longueur d’entrée maximale du chemin d’accès est de 7 caractères.

Le chemin d’accès peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

Le chemin d’accès ne peut pas contenir la barre oblique (/) ou les caractères de nouvelle ligne (\n). Si le chemin d’accès comprend un espace, il est remplacé par un trait de soulignement (_) lorsque l’annonce est affichée.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

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é.

Texte

Première partie de la description de l’annonce.

Le texte doit contenir au moins un mot.

La longueur d’entrée maximale de la copie est de 90 caractères. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, la longueur d’entrée maximale de la copie est de 45 caractères.

Le texte peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

Le texte ne peut pas contenir le caractère de nouvelle ligne (\n).

Ajouter: Obligatoire
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

Partie 2 du texte

Deuxième partie de la description de l’annonce.

Le texte doit contenir au moins un mot.

La longueur d’entrée maximale de la copie est de 90 caractères. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, la longueur d’entrée maximale de la copie est de 45 caractères.

Le texte peut contenir des fonctions SI et compte à rebours . Quelle que soit la longueur totale de tous les paramètres de compte à rebours non sous-affectés, le compte à rebours final affiché utilise toujours 8 caractères sur le nombre total de caractères disponibles. Pour plus d’informations , consultez Personnalisateurs de compte à rebours.

Le texte ne peut pas contenir le caractère de nouvelle ligne (\n).

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

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: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule