Objet de données AppAdExtension - Gestion des campagnes

Article
11/13/2024

Définit une extension d’annonce d’application qui peut être incluse dans une annonce.

Vous pouvez associer une extension de publicité d’application au compte ou à des campagnes et des groupes d’annonces dans le compte. Chaque entité (compte, campagne ou groupe d’annonces) peut être associée à autant d’extensions d’annonces d’application que vous le souhaitez, jusqu’au nombre total d’extensions d’annonces d’application dans votre compte.

<xs:complexType name="AppAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <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="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q48:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q49="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q49:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "DevicePreference": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Scheduling": {
    "DayTimeRanges": [
      {
        "Day": "ValueHere",
        "EndHour": IntValueHere,
        "EndMinute": "ValueHere",
        "StartHour": IntValueHere,
        "StartMinute": "ValueHere"
      }
    ],
    "EndDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "StartDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "UseSearcherTimeZone": "ValueHere"
  },
  "Status": "ValueHere",
  "Type": "AppAdExtension",
  "Version": IntValueHere,
  "AppPlatform": "ValueHere",
  "AppStoreId": "ValueHere",
  "DestinationUrl": "ValueHere",
  "DisplayText": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  }
}

Éléments

L’objet AppAdExtension contient les éléments suivants : AppPlatform, AppStoreId, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Élément	Description	Type de données
AppPlatform	Plateforme d’application. Les valeurs possibles incluent iOS, Android et Windows. Ajouter: Obligatoire Mettre à jour: Obligatoire	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: Obligatoire	chaîne
DestinationUrl	URL de la page web de téléchargement de l’App Store vers laquelle les utilisateurs sont redirigés lorsqu’ils cliquent sur le lien d’extension d’application. L’URL peut contenir des chaînes de texte dynamiques telles que {mot clé}. Pour obtenir la liste des paramètres pris en charge, consultez la section Paramètres disponibles dans l’article d’aide microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?. L’URL peut contenir un maximum de 1 024 caractères. Si l’URL ne spécifie pas de protocole, le système utilise le protocole HTTP lorsqu’un utilisateur clique sur la publicité. Si l’URL spécifie le protocole HTTP lorsque vous ajoutez une publicité, le service supprime la chaîne de protocole http:// (la chaîne de protocole HTTP ne compte pas dans la limite de 1 024 caractères) ; Toutefois, le service ne supprime pas de chaîne de protocole HTTPS (https://) de l’URL. Ajouter: Obligatoire Mettre à jour: Optionnel	chaîne
DisplayText	Texte affiché dans l’extension d’annonce de l’application. Le texte peut contenir un maximum de 35 caractères. Ajouter: Obligatoire Mettre à jour: Optionnel	chaîne
FinalAppUrls	Pour une utilisation ultérieure.	Tableau AppUrl
FinalMobileUrls	Réservé à une utilisation future.	tableau de chaînes
FinalUrls	Réservé à une utilisation future.	tableau de chaînes
FinalUrlSuffix	Réservé à une utilisation future.	chaîne
TrackingUrlTemplate	Réservé à une utilisation future.	chaîne
UrlCustomParameters	Réservé à une utilisation future.	CustomParameters

L’objet AppAdExtension a des éléments hérités.

Éléments hérités

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

L’objet AppAdExtension dérive de l’objet AdExtension et hérite des éléments suivants : DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Les descriptions ci-dessous sont spécifiques à AppAdExtension et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet AdExtension .

Élément	Description	Type de données
DevicePreference	Cet élément détermine si la préférence est que l’extension d’annonce s’affiche sur les appareils mobiles ou sur tous les appareils. Pour spécifier une préférence pour les appareils mobiles, définissez cet élément sur 30001. Pour spécifier tous les appareils, 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. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	long
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 modification de compatibilité avant pour l’objet AdExtension . Ajouter: En lecture seule Mettre à jour: En lecture seule	Tableau KeyValuePairOfstringstring
Id	Identificateur Microsoft Advertising unique de l’extension de publicité. Ajouter: En lecture seule Mettre à jour: Lecture seule et Obligatoire	long
Planification	Détermine le jour calendaire et les intervalles de temps où l’extension d’annonce peut être affichée dans des annonces. Ajouter: Optionnel Mettre à jour: Optionnel. Si vous définissez cet élément null, tout jeu de planification existant pour l’extension d’annonce reste inchangé. Si vous définissez ce paramètre sur n’importe quel objet Schedule non null, vous remplacez efficacement les paramètres de planification existants pour l’extension d’annonce. Pour supprimer toutes les planifications, définissez cet élément sur un objet Schedule vide.	Schedule
Statut	Status de l’extension d’annonce. La valeur sera toujours Active , car le service Campaign Management ne retourne pas d’extensions publicitaires supprimées. Ajouter: En lecture seule Mettre à jour: En lecture seule	AdExtensionStatus
Type	Type de l’extension d’annonce. Cette valeur est AppAdExtension lorsque vous récupérez une extension d’annonce d’application. Ajouter: En lecture seule Mettre à jour: En lecture seule Pour plus d’informations sur les types d’extensions publicitaires, consultez les remarques relatives aux objets de données d’extension d’annonce.	chaîne
Version	Effectue le suivi du nombre de mises à jour de l’extension d’annonce. La version est définie sur 1 lors de la création de l’extension d’annonce et incrémente d’un après chaque mise à jour. Ajouter: Non autorisé Mettre à jour: Non autorisé	int

Configuration requise

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

Partager via