Partager via

Objet de données AssetGroup - Gestion des campagnes

  • Article

Définit un groupe d’actifs dans une campagne publicitaire.

Syntaxe

<xs:complexType name="AssetGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AssetGroupSearchThemes" nillable="true" type="tns:ArrayOfAssetGroupSearchTheme">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
    <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetGroupEditorialStatus" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element xmlns:q114="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q114:ArrayOfstring" />
    <xs:element xmlns:q115="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q115:ArrayOfstring" />
    <xs:element xmlns:q116="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q116:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AssetGroupStatus" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet AssetGroup contient les éléments suivants : AssetGroupSearchThemes, BusinessName, CallToAction, Descriptions, EditorialStatus, EndDate, FinalMobileUrls, FinalUrls, ForwardCompatibilityMap, Headlines, Id, Images, LongHeadlines, Name, Path1, Path2, StartDate, Status.

Élément Description Type de données
AssetGroupSearchThemes Liste des thèmes de recherche de groupe de ressources. AssetGroupSearchTheme array
BusinessName Nom de l’entreprise.

Le nom de votre entreprise peut apparaître dans votre annonce, en fonction du placement de l’annonce.

La longueur de la chaîne est limitée à 25 caractères.

Ajouter: Obligatoire. S’il n’est pas fourni et que la campagne parente est associée à un magasin, le nom du magasin est utilisé comme nom d’entreprise.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 chaîne
CallToAction Une raison brève et percutant pour que les clients cliquent sur votre annonce dès maintenant.

Cela s’affiche sur le bouton d’appel à l’action.

Ajouter: Obligatoire. S’il n’est pas fourni et que la campagne parente est associée à un magasin, la valeur par défaut est LearnMore.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 CallToAction
Descriptions Descriptions affichées sous le chemin d’accès dans votre annonce.

Vous devez définir entre 2 et 5 descriptions. Le texte de chaque description doit contenir au moins un mot. Le texte ne peut pas contenir le caractère de nouvelle ligne (\n).

Si la campagne parente est associée à un magasin et que vous spécifiez Descriptions, vous devez également spécifier Titres, Lignes à têtes longues et Images.

Ajouter : facultatif si la campagne parente s’associe à un magasin, obligatoire si sa campagne parente n’est pas associée à un magasin.
Mise à jour : facultatif. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez cet élément zéro. Si vous définissez une valeur pour cet élément, toutes les descriptions précédemment liées à ce groupe de ressources sont remplacées. Si la campagne parente est associée à un magasin et que vous définissez cet élément sur une liste vide, le paramètre précédent est supprimé.		 Tableau AssetLink
EditorialStatus La révision éditoriale status du groupe d’actifs, qui indique si le groupe d’actifs est en attente d’examen, a été approuvé ou a été désapprouvé.

Ajouter : lecture seule
Mise à jour : lecture seule		 AssetGroupEditorialStatus
EndDate Date d’expiration du groupe de ressources.

Si vous ne spécifiez pas de date de fin, le groupe de ressources n’expire pas. La date de fin peut être prolongée pour rendre un groupe d’actifs éligible à la remise, même après l’expiration du groupe de ressources.

La date de fin est incluse. Par exemple, si vous définissez EndDate sur 31/12/2020, les annonces du groupe d’annonces expireront à 23h59 le 31/12/2020. L’heure est basée sur le fuseau horaire que vous spécifiez au niveau de la campagne.

Ajouter : facultatif. Pour ne définir aucune date de fin lors de l’ajout d’un groupe de ressources, définissez cet élément sur null.
Mise à jour : facultatif. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer le paramètre de date de fin existant et ne définir aucune date de fin lors de la mise à jour d’un groupe de ressources, définissez la date de fin égale ou ultérieure au 2 janvier 2050. Lorsque vous récupérerez le groupe de ressources la prochaine fois, cet élément sera nul, c’est-à-dire qu’il ne sera pas défini sur janvier 2, 2050.		 Date
FinalMobileUrls URL de la page d’accueil mobile.

Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales.
- 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 pouvez specifiez jusqu’à 10 éléments pour FinalUrls et FinalMobileUrls ; Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service en autorise jusqu’à 10 pour une compatibilité descendante potentielle.
- L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}.
- Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://.
- Si vous spécifiez FinalMobileUrls, vous devez également spécifier FinalUrls.

Ajouter : facultatif
Mise à jour : facultatif		 tableau de chaînes
FinalUrls URL de la page d’accueil.

La partie domaine de l’URL associée aux chaînes du chemin d’accès 1 et du chemin d’accès 2 ne peut pas dépasser 67 caractères.

Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales.
- 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 pouvez spécifier jusqu’à 10 éléments pour FinalUrls et FinalMobileUrls ; Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service en autorise jusqu’à 10 pour une compatibilité descendante potentielle.
- L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}.
- Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://.
- Si vous spécifiez FinalMobileUrls, vous devez également spécifier FinalUrls.

Pour les campagnes de vente au détail, l’URL finale doit correspondre au domaine du magasin associé à la campagne.

Ajouter : obligatoire. S’il n’est pas fourni et que la campagne parente est associée à un magasin, l’URL du magasin est utilisée comme URL finale.
Mise à jour : facultatif		 tableau de chaînes
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.

Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.		 Tableau KeyValuePairOfstringstring
Gros titres Les titres étant le texte le plus important qui apparaît dans votre annonce, vous devez tirer le meilleur parti des caractères disponibles. Nous avons besoin de plusieurs titres afin que l’annonce puisse s’afficher de manière flexible sur une variété d’éditeurs et de placements.

Du point de vue d’un modèle de données, les descriptions et les titres sont stockés en tant que ressources de texte, c’est-à-dire un TextAsset par AssetLink. La même ressource peut être utilisée par plusieurs annonces. Par exemple, si « Intégration transparente » est une ressource de texte, elle aura le même identificateur de ressource pour toutes les annonces du même compte Microsoft Advertising.

Vous devez définir entre 3 et 15 titres. Le texte de chaque titre doit contenir au moins un mot.

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

Si la campagne parente est associée à un magasin et que vous spécifiez Titres, vous devez également spécifier Des titres longs, des descriptions et des images.

Ajouter : facultatif si sa campagne parente est associée à un magasin, obligatoire si sa campagne parente n’est pas associée à un magasin.
Mise à jour : facultatif. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez cet élément zéro. Si vous définissez une valeur pour cet élément, tous les titres précédemment liés à ce groupe de ressources seront remplacés. Si la campagne parente est associée à un magasin et que vous définissez cet élément sur une liste vide, le paramètre précédent est supprimé.		 Tableau AssetLink
ID ID du groupe de ressources généré par le système.

Ajouter : lecture seule
Mise à jour : lecture seule		 long
Images Ressources d’image avec des tailles et des proportions différentes afin qu’elles puissent s’afficher de manière flexible sur une variété d’éditeurs et de placements.

Incluez un ou plusieurs objets AssetLink qui contiennent chacun un Objet ImageAsset avec des paramètres SubType et rognage qui correspondent aux proportions souhaitées.

ImageAsset contient les champs CropHeight, CropWidth, CropX, CropY et SubType.

Les valeurs de sous-type possibles sont LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 et ImageMedia4X1.

Vous devez fournir au moins 1 LandscapeImageMedia et 1 SquareImageMedia. Jusqu’à 20 images et jusqu’à 5 logos peuvent être enregistrés.

Si la campagne parente est associée à un magasin et que vous spécifiez Images, vous devez également spécifier Titres, Lignes à têtes longues et Descriptions.

Ajouter : facultatif si la campagne parente s’associe à un magasin, obligatoire si sa campagne parente n’est pas associée à un magasin.
Mise à jour : facultatif. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous incluez des images pendant la mise à jour, toutes les images précédemment définies seront remplacées. Si la campagne parente est associée à un magasin et que vous définissez cet élément sur une liste vide, le paramètre précédent est supprimé.		 Tableau AssetLink
Lignes d’en-têtes longues Vous devez définir entre 1 et 5 titres longs. Le texte de chaque titre doit contenir au moins un mot. Le texte ne peut pas contenir le caractère de nouvelle ligne (\n).

Si la campagne parente est associée à un magasin et que vous spécifiez LongHeadlines, vous devez également spécifier Titres, Descriptions et Images.

Ajouter : facultatif si la campagne parente s’associe à un magasin, obligatoire si sa campagne parente n’est pas associée à un magasin.
Mise à jour : facultatif. Pour conserver toutes les liaisons de ressources existantes, définissez ou laissez cet élément zéro. Si vous définissez une valeur pour cet élément, tous les titres précédemment liés à ce groupe de ressources seront remplacés. Si la campagne parente est associée à un magasin et que vous définissez cet élément sur une liste vide, le paramètre précédent est supprimé.		 Tableau AssetLink
Nom Nom du groupe de ressources. Les noms doivent être uniques dans une campagne et respecter la casse. La longueur ne peut pas dépasser 256 caractères.

Ajouter : obligatoire
Mise à jour : facultatif		 chaîne
Chemin d’accès1 Première partie du chemin d’accès facultatif qui sera ajouté à la partie domaine de votre URL d’affichage. La partie domaine de votre URL d’affichage, par exemple https://www.contoso.com , sera générée à partir du domaine de votre URL finale (élément FinalUrls). Ensuite, si vous avez spécifié une valeur pour Path1, elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour Path2, elle sera également ajoutée à l’URL d’affichage après Path1. Par exemple, si votre FinalUrls contient https://www.contoso.com, Path1 est défini sur sous-répertoire1 et Path2 est défini sur sous-répertoire2, l’URL affichée est https://www.contoso.com/subdirectory1/subdirectory2.

Vous ne pouvez pas entrer plus de 15 caractères. L’affichage de l’annonce échoue si la longueur du domaine d’URL final et des chemins combinés dépasse 67 caractères.

Pour les langues avec des caractères à double largeur, par exemple, le chinois traditionnel ne peut pas entrer plus de 7 caractères finaux. L’annonce ne s’affiche pas si la longueur du domaine d’URL final et des chemins combinés dépasse 33 caractères. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de campagne. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

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 : facultatif
Mise à jour : facultatif		 chaîne
Chemin d’accès 2 Deuxième partie du chemin facultatif qui sera ajouté à la partie domaine de votre URL d’affichage. La partie domaine de votre URL d’affichage, par exemple https://www.contoso.com , sera générée à partir du domaine de votre URL finale (élément FinalUrls). Ensuite, si vous avez spécifié une valeur pour Path1, elle est ajoutée à l’URL d’affichage. Si vous avez également spécifié une valeur pour Path2, elle sera également ajoutée à l’URL d’affichage après Path1. Par exemple, si votre FinalUrls contient https://www.contoso.com, Path1 est défini sur sous-répertoire1 et Path2 est défini sur sous-répertoire2, l’URL affichée est https://www.contoso.com/subdirectory1/subdirectory2.

Vous ne pouvez spécifier Path2 que si Path1 est également défini.

Vous ne pouvez pas entrer plus de 15 caractères. L’affichage de l’annonce échoue si la longueur du domaine d’URL final et des chemins combinés dépasse 67 caractères.

Pour les langues avec des caractères à double largeur, par exemple, le chinois traditionnel ne peut pas entrer plus de 7 caractères finaux. L’annonce ne s’affiche pas si la longueur du domaine d’URL final et des chemins combinés dépasse 33 caractères. Les caractères à double largeur sont déterminés par les caractères que vous utilisez au lieu du jeu de caractères des paramètres de langue de campagne. Les caractères à double largeur incluent les caractères coréens, japonais et chinois, ainsi que les emojis.

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 : facultatif
Mise à jour : facultatif		 chaîne
StartDate Date à laquelle le groupe de ressources peut commencer à servir ; sinon, le service peut commencer à diffuser des annonces le jour où le groupe de ressources devient actif.

La date de début est incluse. Par exemple, si vous définissez la date de début sur 5/5/2021, les annonces créées à partir du groupe de ressources commenceront à 00h00 le 5/05/2021. L’heure est basée sur le fuseau horaire que vous spécifiez au niveau de la campagne.

Ajouter : facultatif. Si vous ne définissez pas la date de début, la valeur par défaut est la date du jour et le service peut commencer à diffuser des annonces dès que le groupe de ressources status est actif.
Mise à jour : facultatif. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. La date de début ne peut pas être mise à jour après l’envoi du groupe de ressources, c’est-à-dire une fois que la date de début est arrivée.		 Date
Statut Status du groupe de ressources. Les valeurs possibles sont Actif, Expiré et Suspendu. Le status Expiré est en lecture seule.

Ajouter : facultatif. La valeur par défaut est Paused.
Mise à jour : facultatif		 AssetGroupStatus

Configuration requise

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

Utilisé par

AddAssetGroups
GetAssetGroupsByCampaignId
GetAssetGroupsByIds
UpdateAssetGroups