Enregistrement publicitaire d’installation d’application - En bloc

Définit une publicité d’installation d’application qui peut être téléchargée et chargée dans un fichier en bloc.

Les annonces d’installation d’application sont similaires aux annonces textuelles, mais fournissent des liens directs vers vos applications avec un bouton, en envoyant les clients directement au magasin applicable pour télécharger l’application. Il s’agit d’une solution idéale pour les annonceurs qui souhaitent gérer et piloter les téléchargements de leurs applications, plutôt que le trafic du site web.

App Install Ads détecte automatiquement l’appareil mobile et le système d’exploitation du client, en les envoyant au App Store Apple ou Google Play correspondant. Vous pouvez également suivre les conversions avec les mêmes partenaires de suivi des conversions que les extensions d’application : AppsFlyer, Kochava, Tune, Singular, Adjust et Branch.

Vous pouvez télécharger tous les enregistrements d’annonces d’installation d’application dans le compte en incluant la valeur DownloadEntity de AppInstallAds 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’installation d’application 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
Format Version,,,,,,,,,,,,,,6.0,,,,,,,
App Install Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,,,,All,,Android,AppStoreIdGoesHere,FinalUrlGoesHere,,,,{_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 BulkAppInstallAd , 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 BulkAppInstallAd
var bulkAppInstallAd = new BulkAppInstallAd
{
    // '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 
    // AppInstallAd object of the Campaign Management service.
    AppInstallAd = new AppInstallAd
    {
        // 'App Platform' column header in the Bulk file
        AppPlatform = "Android",
        // 'App Id' column header in the Bulk file
        AppStoreId = "AppStoreIdGoesHere",
        // 'Device Preference' column header in the Bulk file
        DevicePreference = 0,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "FinalUrlGoesHere"
        },
        // '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(bulkAppInstallAd);

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 d’installation d’application, les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc. La combinaison des champs Id d’application, Plateforme de l’application, Texte et Titre rend l’installation de l’application publicitaire unique.

• Groupe d’annonces
• ID de l’application
• Plateforme d’application
• Campagne
• Client Id
• Paramètre personnalisé
• Préférence d’appareil
• État de l’appel éditorial
• Emplacement éditorial
• Code de raison éditorial
• État éditorial
• Terme éditorial
• URL finale
• Suffixe d’URL final
• Id
• Heure de modification
• Parent Id
• Pays d’éditeur
• État
• Texte
• Titre
• 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

ID de l’application

Identificateur d’application fourni par l’App Store.

Si l’application est nouvelle, attendez-vous à attendre 4 à 7 jours avant que l’annonce puisse être remise.

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

Plateforme d’application

Plateforme d’application.

Les valeurs possibles incluent iOS et Android.

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

Préférence d’appareil

Ce champ détermine si la préférence est que les publicités d’installation d’application s’affichent sur les appareils mobiles et tablettes ou uniquement sur les appareils mobiles. (Les annonces d’installation d’applications ne sont actuellement pas prises en charge sur les ordinateurs de bureau.)

Les valeurs possibles sont All (appareils mobiles et tablettes) et Mobile (à l’exclusion des tablettes), 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.

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é. Si vous définissez ce champ sur delete_value, vous réinitialisez la valeur par défaut de Tous.
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

URL finale

URL où un utilisateur de recherche atterrit et peut choisir d’installer une application.

Les règles de validation suivantes s’appliquent à l’URL finale pour les annonces d’installation d’application.

• 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 ne pouvez spécifier qu’une seule URL dans ce champ.
• 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://.

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

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 App Install 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é).

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

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

État

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

Copie de l’annonce. La copie doit contenir au moins un mot. La copie et le titre de l’annonce combinés doivent totaler au moins trois mots.

La copie publicitaire ne peut pas contenir de chaînes de texte dynamiques telles que {mot clé}.

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

La copie de l’annonce ne peut pas contenir le caractère newline (\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

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 ne peut pas contenir de chaînes de texte dynamiques telles que {mot clé}.

La longueur d’entrée maximale du titre est de 25 caractères. Notez que pour les groupes d’annonces qui utilisent le chinois traditionnel, le titre est limité à 15 caractères.

Le titre 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

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