Objet de données ResponsiveAd - Gestion des campagnes

Format d’annonce réactif pour les annonces d’audience et les annonces multimédias.

L’objet ResponsiveAd est utilisé pour les annonces multimédias dans le réseau de recherche et les publicités d’audience dans le réseau d’audience Microsoft. Pour plus d’informations sur les principaux différateurs, consultez la section remarques ci-dessous.

Syntaxe

<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdSubType" nillable="true" type="tns:AdSubType">
          <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="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
          <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="LongHeadline" nillable="true" type="tns:AssetLink" />
        <xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
          <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="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
          <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="Videos" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet ResponsiveAd contient les éléments suivants : AdSubType, BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headline, Headlines, Images, ImpressionTrackingUrls, LongHeadline, LongHeadline,LongHeadlineString, Text, VerifiedTrackingSettings, Videos.

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

Éléments hérités

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

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

Remarques

L’objet ResponsiveAd est utilisé pour les annonces multimédias dans le réseau de recherche et les publicités d’audience dans le réseau d’audience Microsoft.

La plupart des propriétés prises en charge sont les mêmes, mais voici quelques-uns des principaux différérateurs.

• Pour les publicités d’audience, vous devez définir BusinessName, Headlines, Images, ImpressionTrackingUrls, LongHeadlines et Descriptions.
• Pour les publicités multimédias, vous devez définir BusinessName, CallToAction, CallToActionLanguage, Descriptions, Titres, Images et LongHeadlines.

Images publicitaires multimédias

Pour les publicités multimédias, vous allez créer plusieurs ressources d’image avec différentes tailles et proportions. Vous devez ajouter au moins 1 image avec des proportions de 1,91:1 et 1 image avec des proportions de 1:1.

Dans l’élément Images , incluez un ou plusieurs objets AssetLink . Chaque lien de ressource contient un objet ImageAsset avec SubType défini sur l’une des valeurs de chaîne du tableau ci-dessous.

Logos d’annonces multimédias

Pour les publicités multimédias, vous allez créer plusieurs ressources de logo avec des tailles, des proportions et des paramètres de rognage différents afin qu’elles puissent s’afficher de manière flexible dans la liste des miniatures.

Le sous-type doit être défini sur « Logo » si l’image est associée à une annonce en tant que « LandscapeLogoMedia » ou « SquareLogoMedia ».

Images publicitaires d’audience

Pour les publicités d’audience, vous allez créer plusieurs ressources d’image avec des tailles, des proportions et des paramètres de rognage différents afin qu’elles puissent s’afficher de manière flexible sur une variété d’éditeurs et de placements.

Dans l’élément Images , incluez un ou plusieurs objets AssetLink . Chaque lien de ressource contient un objet ImageAsset avec SubType défini sur l’une des valeurs de chaîne du tableau ci-dessous.

Vous devez uniquement fournir une ressource d’image OriginalImage par défaut (l’image par défaut était précédemment LandscapeImageMedia). Dans l’élément Images , incluez un AssetLink qui contient un ImageAsset avec SubType défini sur OriginalImage. Les dimensions recommandées pour l’OriginalImage sont 1200 largeur x 628 hauteur. Si vous le souhaitez, vous pouvez inclure des liens de ressources supplémentaires, c’est-à-dire une ressource d’image pour chaque sous-type pris en charge. Pour tous les sous-types de ressources d’image que vous ne définissez pas explicitement, Microsoft Advertising crée automatiquement des liens de ressources d’image en rognant l’originalImage.

Étant donné l’exemple de réponse GetAdsByAdGroupId ci-dessous, notez ce qui suit :

• Le même identificateur de ressource d’image (par exemple, 1234567890000) est utilisé pour tous les sous-types de ressources d’image générés automatiquement. Que vous laissons ou non Microsoft Advertising générer automatiquement les images rognées, l’ID n’a pas besoin d’être unique parmi les ressources d’image liées à la même annonce.
• Étant donné que la publicité de cet exemple a été créée sans paramètres de rognage pour le sous-type de ressource image OriginalImage, toutes les ressources d’image sont rognées, à l’exception de l’image associée OriginalImage.
• Microsoft Advertising utilise les paramètres de rognage de l’OriginalImage pour tous les paramètres de rognage par défaut. Dans cet exemple, la hauteur de rognage de toutes les ressources d’image générées par le système est de 628, et nous pouvons déduire que le format OriginalImage (sous-type OriginalImage) avec des proportions de 1,91:1 a une largeur et une hauteur de 1200 x 628. Les paramètres de rognage des ressources d’image générées automatiquement sont basés sur les paramètres de rognage du lien de ressource OriginalImage.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header>
		<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
	</s:Header>
	<s:Body>
		<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
			<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				<Ad i:type="ResponsiveAd">
					<AdFormatPreference i:nil="true"/>
					<DevicePreference>0</DevicePreference>
					<EditorialStatus>Inactive</EditorialStatus>
					<FinalAppUrls i:nil="true"/>
					<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://mobile.contoso.com/womenshoesale</a:string>
					</FinalMobileUrls>
					<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://www.contoso.com/womenshoesale</a:string>
					</FinalUrls>
					<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
					<Id>9876543210000</Id>
					<Status>Active</Status>
					<TrackingUrlTemplate i:nil="true"/>
					<Type>ResponsiveAd</Type>
					<UrlCustomParameters i:nil="true"/>
					<BusinessName>Contoso</BusinessName>
					<CallToAction>AddToCart</CallToAction>
					<Headline>Fast &amp; Easy Setup</Headline>
					<Images>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight i:nil="true"/>
								<CropWidth i:nil="true"/>
								<CropX i:nil="true"/>
								<CropY i:nil="true"/>
								<SubType>OriginalImage</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>628</CropWidth>
								<CropX>286</CropX>
								<CropY>0</CropY>
								<SubType>SquareImageMedia</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>942</CropWidth>
								<CropX>129</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia15X10</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>835</CropWidth>
								<CropX>183</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia133X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>1118</CropWidth>
								<CropX>41</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia178X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
					</Images>
					<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
					<LandscapeLogoMediaId i:nil="true"/>
					<LongHeadline>Find New Customers &amp; Increase Sales!</LongHeadline>
					<SquareImageMediaId>1234567890000</SquareImageMediaId>
					<SquareLogoMediaId i:nil="true"/>
					<Text>Find New Customers &amp; Increase Sales! Start Advertising on Contoso Today.</Text>
				</Ad>
			</Ads>
		</GetAdsByAdGroupIdResponse>
	</s:Body>
</s:Envelope>

Configuration requise

Service : CampaignManagementService.svc v13
Espace de noms: https://bingads.microsoft.com/CampaignManagement/v13