Objet de données AppInstallAd - Gestion des campagnes

Article
12/21/2023

Définit une annonce d’installation d’application.

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.

Remarque

Les annonces d’installation d’application sont disponibles en Australie, au Brésil, au Canada, en France, en Allemagne, en Inde, au Royaume-Uni et au États-Unis sur iOS et Android uniquement. Seules les applications disponibles dans le États-Unis dans apple App Store et Google Play Store sont actuellement prises en charge. Windows n’est pas pris en charge.

Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas. Il sera bientôt disponible.

Remarque

Les publicités d’installation d’application ne peuvent être créées que dans les campagnes de recherche où AdGroupType est défini sur « SearchStandard ». Si AdGroupType est défini sur « SearchDynamic », le groupe d’annonces ne prend pas en charge les publicités d’installation d’application.

La combinaison des éléments AppPlatform, AppStoreId, Text et Title rend la publicité d’installation d’application unique.

Syntaxe

<xs:complexType name="AppInstallAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet AppInstallAd contient les éléments suivants : AppPlatform, AppStoreId, Text, Title.

Élément	Description	Type de données
AppPlatform	Plateforme d’application. Les valeurs possibles incluent iOS et Android. Ajouter: Obligatoire Mettre à jour: Optionnel	chaîne
AppStoreId	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	chaîne
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	chaîne
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	chaîne

L’objet AppInstallAd contient des éléments hérités.

Éléments hérités

Éléments hérités d’Ad

L’objet AppInstallAd dérive de l’objet Ad et hérite des éléments suivants : AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Les descriptions ci-dessous sont spécifiques à AppInstallAd et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet Ad .

Élément	Description	Type de données
AdFormatPreference	Non pris en charge pour ce type d’annonce.	chaîne
DevicePreference	Cet élément détermine si la préférence est que les annonces d’installation d’application s’affichent sur les appareils mobiles et les 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.) Pour spécifier une préférence pour les appareils mobiles uniquement (à l’exception des tablettes), définissez cet élément sur 30001. Pour spécifier une préférence pour les appareils mobiles et les tablettes, définissez cet élément sur 0 (zéro) ou laissez l’élément zéro. Par défaut, cet élément est nul. Ajouter: Optionnel Mettre à jour: Optionnel	Long
EditorialStatus	La révision éditoriale status de l’annonce, qui indique si la publicité est en attente d’examen, a été approuvée ou a été désapprouvée. Ajouter: En lecture seule Mettre à jour: En lecture seule	AdEditorialStatus
FinalAppUrls	Non pris en charge pour les publicités d’installation d’application.	Tableau AppUrl
FinalMobileUrls	Non pris en charge pour les publicités d’installation d’application.	tableau de chaînes
FinalUrls	URL où un utilisateur de recherche atterrit et peut choisir d’installer une application. Ajouter: Obligatoire Mettre à jour: Optionnel	tableau de chaînes
FinalUrlSuffix	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 cet élément sur une chaîne vide (« »), le paramètre précédent est supprimé.	chaîne
ForwardCompatibilityMap	Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API. Il n’existe actuellement aucune paire clé/valeur ForwardCompatibilityMap applicable à cet objet.	Tableau KeyValuePairOfstringstring
ID	Identificateur Microsoft Advertising unique pour la publicité. Ajouter: En lecture seule Mettre à jour: Obligatoire et en lecture seule	Long
État	Status de l’annonce. Vous pouvez définir la status publicitaire sur Actif ou Suspendu. Ajouter: Optionnel Mettre à jour: Optionnel	AdStatus
TrackingUrlTemplate	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 celles définies 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 valide pas l’existence de 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} ne sont définis 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 cet élément sur une chaîne vide (« »), le paramètre précédent est supprimé.	chaîne
Type	Type de la publicité. Cette valeur est AppInstall lorsque vous récupérez une annonce d’installation d’application. Pour plus d’informations sur les types d’annonces, consultez remarques sur les objets de données publicitaires. Ajouter: En lecture seule Mettre à jour: En lecture seule	AdType
UrlCustomParameters	Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL. Microsoft Advertising accepte les 8 premiers objets CustomParameter que vous incluez dans l’objet CustomParameters , et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée. Chaque CustomParameter comprend des éléments Key et Value . Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Définissez l’élément UrlCustomParameters sur null ou vide pour conserver tous les paramètres personnalisés existants. Pour supprimer tous les paramètres personnalisés, définissez l’élément Parameters de l’objet CustomParameters sur null ou vide. Pour supprimer un sous-ensemble de paramètres personnalisés, spécifiez les paramètres personnalisés que vous souhaitez conserver dans l’élément Parameters de l’objet CustomParameters .	CustomParameters

Configuration requise

Service : CampaignManagementService.svc v13
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Partager via