Enregistrement cible publicitaire de recherche dynamique de groupe d’annonces - En bloc

  • Article

Définit une cible publicitaire de recherche dynamique de groupe d’annonces qui peut être chargée et téléchargée dans un fichier en bloc.

L’enregistrement Cible publicitaire de recherche dynamique de groupe d’annonces 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 cibles publicitaires de recherche dynamique de groupe d’annonces dans le compte en incluant la valeur DownloadEntityd’AdGroupDynamicSearchAdTargets 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 cible publicitaire de recherche dynamique de groupe d’annonces si une valeur ID parent valide est fournie.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Tracking Template,Custom Parameter,Dynamic Ad Target Condition 1,Dynamic Ad Target Condition 2,Dynamic Ad Target Condition 3,Dynamic Ad Target Value 1,Dynamic Ad Target Value 2,Dynamic Ad Target Value 3
Format Version,,,,,,,,,6.0,,,,,,,,
Ad Group Dynamic Search Ad Target,Paused,,-1113,,,ClientIdGoesHere,,0.5,Bulk Ad Group Dynamic Search Ad Target,,{_promoCode}=PROMO1; {_season}=summer,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers

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 BulkAdGroupDynamicSearchAdTarget , 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 BulkAdGroupDynamicSearchAdTarget
var bulkAdGroupDynamicSearchAdTarget = new BulkAdGroupDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                // Set Conditions null if you want to target all webpages
                Conditions = new []
                {
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 1' column header in the Bulk file
                        Argument = "contoso.com",
                        // 'Dynamic Ad Target Condition 1' column header in the Bulk file
                        Operand = WebpageConditionOperand.Url
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 2' column header in the Bulk file
                        Argument = "US/CA/SFO",
                        // 'Dynamic Ad Target Condition 2' column header in the Bulk file
                        Operand = WebpageConditionOperand.Category
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 3' column header in the Bulk file
                        Argument = "flowers",
                        // 'Dynamic Ad Target Condition 3' column header in the Bulk file
                        Operand = WebpageConditionOperand.PageContent
                    },
                },
                // 'Name' column header in the Bulk file
                CriterionName = "Bulk Ad Group Dynamic Search Ad Target"
            }
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // '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"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupDynamicSearchAdTarget);

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 cible publicitaire de recherche dynamique de groupe d’annonces, 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 cible d’annonce dynamique (critère de page web).

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 .

Offre

Montant à enchérir dans la vente aux enchères.

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

Campagne

Nom de la campagne qui contient le groupe d’annonces et la cible publicitaire dynamique (critère de page web).

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

Remarque

Si vous ne définissez aucun champ de condition, d’opérateur ou de valeur de la cible d’annonce dynamique, vous ciblez efficacement toutes les pages web.

Condition de cible d’annonce dynamique 1

Le premier d’un maximum de 3 opérandes de condition de page web. La condition est remplie si la propriété de page web référencée par ce champ contient ou est égale à la valeur Dynamic Ad Target Value 1 .

Les valeurs possibles sont Category, CustomLabel, PageContent, PageTitle et Url.

Ajouter: Optionnel. Si vous ne définissez aucun des champs de valeur ou de condition de cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Vous ne pouvez avoir qu’une seule cible publicitaire dynamique par groupe d’annonces pour toutes les pages web.
Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour la condition ou les champs de valeur de la cible publicitaire dynamique. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

Condition de cible d’annonce dynamique 2

Deuxième d’un maximum de 3 opérandes de condition de page web. La condition est remplie si la propriété de page web référencée par ce champ contient ou est égale à la valeur Dynamic Ad Target Value 2 .

Les valeurs possibles sont Category, CustomLabel, PageContent, PageTitle et Url.

Ajouter: Optionnel. Si vous ne définissez aucun des champs de valeur ou de condition de cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Vous ne pouvez avoir qu’une seule cible publicitaire dynamique par groupe d’annonces pour toutes les pages web.
Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour la condition ou les champs de valeur de la cible publicitaire dynamique. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

Condition de cible d’annonce dynamique 3

Troisième opérandes de condition de page web sur un maximum de 3. La condition est remplie si la propriété de page web référencée par ce champ contient ou est égale à la valeur Dynamic Ad Target Value 1 .

Les valeurs possibles sont Category, CustomLabel, PageContent, PageTitle et Url.

Ajouter: Optionnel. Si vous ne définissez aucun des champs de valeur ou de condition de cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Vous ne pouvez avoir qu’une seule cible publicitaire dynamique par groupe d’annonces pour toutes les pages web.
Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour la condition ou les champs de valeur de la cible publicitaire dynamique. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

Opérateur cible d’annonce dynamique 1

Le premier d’un maximum de 3 opérateurs de condition de page web. La condition est remplie si la propriété de page web référencée par ce champ contient ou est égale à la valeur Dynamic Ad Target Value 1 .

Les valeurs possibles sont Contains et Equals.

Ajouter: Optionnel. Si vous ne définissez aucun champ de condition, d’opérateur ou de valeur de la cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Si vous définissez la condition de cible d’annonce dynamique 1 et que vous ne définissez pas l’opérateur cible d’annonce dynamique 1, nous utiliserons l’opérateur par défaut pour l’opérande sélectionné. Si vous souhaitez créer une URL égale, l’opérateur doit être passé. Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour l’opérateur de cible publicitaire dynamique ou les champs de valeur. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

Opérateur cible d’annonce dynamique 2

Le deuxième d’un maximum de 3 opérateurs de condition de page web. La condition est remplie si la propriété de page web référencée par ce champ contient ou est égale à la valeur Dynamic Ad Target Value 2 .

Les valeurs possibles sont Contains et Equals.

Ajouter: Optionnel. Si vous ne définissez aucun champ de condition, d’opérateur ou de valeur de la cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Si vous définissez Dynamic Ad Target Condition21 et que vous ne définissez pas Dynamic Ad Target Operator 2, nous utiliserons l’opérateur par défaut pour l’opérande sélectionné. Si vous souhaitez créer une URL égale, l’opérateur doit être passé. Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour l’opérateur de cible publicitaire dynamique ou les champs de valeur. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

Opérateur cible d’annonce dynamique 3

Troisième opérateur de condition de page web sur un maximum de 3. La condition est remplie si la propriété de page web référencée par ce champ contient ou est égale à la valeur Dynamic Ad Target Value 3 .

Les valeurs possibles sont Contains et Equals.

Ajouter: Optionnel. Si vous ne définissez aucun champ de condition, d’opérateur ou de valeur de la cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Si vous définissez Dynamic Ad Target Condition 3 et que vous ne définissez pas Dynamic Ad Target Operator 3, nous allons utiliser l’opérateur par défaut pour l’opérande sélectionné. Si vous souhaitez créer une URL égale, l’opérateur doit être passé. Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour l’opérateur de cible publicitaire dynamique ou les champs de valeur. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

Valeur cible d’annonce dynamique 1

Le premier des 3 arguments de condition ou de critère de page web maximum.

Vous pouvez définir cette chaîne sur l’URL, la catégorie, le titre de page ou le contenu de la page de votre site. Par exemple, si le champ Dynamic Ad Target Condition 1 est défini sur Url, vous pouvez définir ce champ sur contoso.com/flowers.

Ajouter: Optionnel. Si vous ne définissez aucun des champs de valeur ou de condition de cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Vous ne pouvez avoir qu’une seule cible publicitaire dynamique par groupe d’annonces pour toutes les pages web.
Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour la condition ou les champs de valeur de la cible publicitaire dynamique. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

Valeur cible d’annonce dynamique 2

Deuxième argument de condition ou de critère de page web d’au maximum 3.

Vous pouvez définir cette chaîne sur l’URL, la catégorie, le titre de page ou le contenu de la page de votre site. Par exemple, si le champ Dynamic Ad Target Condition 2 est défini sur Url, vous pouvez définir ce champ sur contoso.com/flowers.

Ajouter: Optionnel. Si vous ne définissez aucun des champs de valeur ou de condition de cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Vous ne pouvez avoir qu’une seule cible publicitaire dynamique par groupe d’annonces pour toutes les pages web.
Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour la condition ou les champs de valeur de la cible publicitaire dynamique. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

Valeur cible d’annonce dynamique 3

Troisième argument de condition ou de critère de page web d’un maximum de 3.

Vous pouvez définir cette chaîne sur l’URL, la catégorie, le titre de page ou le contenu de la page de votre site. Par exemple, si le champ Dynamic Ad Target Condition 3 est défini sur Url, vous pouvez définir ce champ sur contoso.com/flowers.

Ajouter: Optionnel. Si vous ne définissez aucun des champs de valeur ou de condition de cible d’annonce dynamique, vous ciblez efficacement toutes les pages web. Vous ne pouvez avoir qu’une seule cible publicitaire dynamique par groupe d’annonces pour toutes les pages web.
Mettre à jour: Non autorisé. Vous ne pouvez pas mettre à jour la condition ou les champs de valeur de la cible publicitaire dynamique. Pour mettre à jour les conditions de la page web, vous devez supprimer la cible publicitaire dynamique et en ajouter une nouvelle.
Supprimer: En lecture seule

ID

Identificateur généré par le système de la cible publicitaire dynamique (critère de page web).

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

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

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

Nom

Nom du critère que vous pouvez utiliser pour identifier les critères, par exemple, vous pouvez filtrer ou trier par ordre alphabétique.

La longueur du nom du critère doit être comprise entre 1 et 2048 inclus.

Ajouter: Optionnel. Si vous ne spécifiez aucun nom, par défaut, le nom est défini sur une liste concaténée de conditions. Chaque condition est délimitée par les mot clé et . Par exemple, si les conditions sont a) Url contient une fleur , b) Url contient le livre et c) PageContent contient seattle, le nom du critère par défaut est Url contient flower et Url contient book et PageContent contient seattle. Si tous les champs de condition et de valeur sont vides, vous ciblez efficacement toutes les pages web et le nom est défini sur Toutes les pages web.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous spécifiez le delete_value mot clé, le nom du critère est mis à jour avec la valeur par défaut, c’est-à-dire Toutes les pages web ou une liste concaténée de critères.
Supprimer: En lecture seule

Parent Id

Identificateur généré par le système du groupe d’annonces qui contient la cible publicitaire dynamique (critère de page web).

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 cibles publicitaires dynamiques à 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 .

Statut

Status de la cible publicitaire dynamique (critère de page web).

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

Modèle de suivi

Les modèles de suivi peuvent être utilisés en tandem avec l’URL de la page d’accueil générée dynamiquement à partir du domaine que vous avez spécifié pour votre campagne Dynamic Search Ads. En combinant le domaine avec le modèle de suivi, l’URL de la page d’accueil est assemblée à l’endroit où un utilisateur est dirigé après avoir cliqué sur la publicité.

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