Anzeigendatenobjekt – Kampagnenverwaltung

Artikel
12/21/2023

Definiert das Basisobjekt einer Anzeige.

Versuchen Sie nicht, eine Anzeige zu instanziieren. Sie können eines oder mehrere der folgenden Objekte erstellen, die daraus abgeleitet werden.

Syntax

<xs:complexType name="Ad" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdFormatPreference" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q1:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q2="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q2:ArrayOfstring" />
    <xs:element xmlns:q3="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q3:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdStatus" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:AdType" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
  </xs:sequence>
</xs:complexType>

Elemente

Das Ad-Objekt verfügt über die folgenden Elemente: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters.

Element	Beschreibung	Datentyp
AdFormatPreference	Die Anzeigenformateinstellung wird verwendet, um anzugeben, ob Sie die Anzeigenkopie den Benutzern als Such- oder Zielgruppenanzeige anzeigen möchten oder nicht. Suchanzeigen werden in der Regel als Handlungsaufforderung geschrieben, während Zielgruppenanzeigen eher informativ geschrieben werden sollten. Sie haben zwar die Möglichkeit, Suchanzeigen als Zielgruppenanzeigen zu verwenden, aber wenn Sie eine Anzeige als bevorzugtes Format für Zielgruppenanzeigen festlegen, können Sie ihr Messaging für die native Übermittlung optimieren. Mögliche Werte sind AudienceAd und All. Wenn diese Option auf Alle festgelegt ist, ist die Anzeige sowohl für such- als auch für Zielgruppenanzeigenformate geeignet. Bei Festlegung auf AudienceAd ist die Anzeige nur für das Zielgruppenanzeigenformat geeignet. Die Anzeigeformateinstellung wird nur für ExpandedTextAd - und TextAd-Objekte unterstützt.	Zeichenfolge
DevicePreference	Bestimmt die Gerätepräferenz für die Anzeige der Anzeige. Die Geräteeinstellung wird nur für AppInstallAd - und TextAd-Objekte unterstützt.	Lange
EditorialStatus	Die redaktionelle Überprüfung status der Anzeige, die angibt, ob die Anzeige überprüft, genehmigt oder abgelehnt wurde.	AdEditorialStatus
FinalAppUrls	Reserviert für zukünftige Verwendung.	AppUrl-Array
FinalMobileUrls	Die URL der mobilen Landing Page. Dieses Element wird nur für ExpandedTextAd-, ResponsiveAd-, ResponsiveSearchAd- und TextAd-Objekte unterstützt. Sie wird mit den Objekten AppInstallAd, DynamicSearchAd und ProductAd nicht unterstützt.	Zeichenfolgenarray
FinalUrls	Die letzte oder letzte URL, an der ein Benutzer letztendlich verwendet wird, unabhängig davon, ob der Klick zum endgültigen URL-Pfad Umleitungen enthält. Dieses Element wird nur für Die Objekte AppInstallAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd und TextAd unterstützt. Sie wird mit den Objekten DynamicSearchAd und ProductAd nicht unterstützt.	Zeichenfolgenarray
FinalUrlSuffix	Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden. Dieses Element wird nur für Die Objekte AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd und ResponsiveSearchAd unterstützt. Dies wird mit den Objekten ProductAd und TextAd nicht unterstützt.	Zeichenfolge
ForwardCompatibilityMap	Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden. Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für dieses Objekt.	KeyValuePairOfstring-Array
Id	Der eindeutige Microsoft Advertising-Bezeichner für die Anzeige.	Lange
Status	Die status der Anzeige. Sie können die Anzeige status auf Aktiv oder Angehalten festlegen.	AdStatus
TrackingUrlTemplate	Die Nachverfolgungsvorlage, die als Standard für alle Landing Page-URLs verwendet werden soll. Dieses Element wird nur für Die Objekte AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd und TextAd unterstützt. Sie wird mit dem ProductAd-Objekt nicht unterstützt.	Zeichenfolge
Typ	Der Typ der Anzeige. Weitere Informationen zu Anzeigentypen finden Sie in den Hinweisen.	AdType
UrlCustomParameters	Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung. Dieses Element wird nur für Die Objekte AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd und TextAd unterstützt. Sie wird mit dem ProductAd-Objekt nicht unterstützt.	CustomParameters

Hinweise

Legen Sie für Java und die .NET-Sprachen nicht das Type-Element fest, da der Wert davon bestimmt wird, ob Sie eine erweiterte Textanzeige oder einen anderen Anzeigentyp instanziieren.

Wenn Sie das SOAP manuell generieren, verwenden Sie das Type-Attribut des <Ad> Knotens (wie im folgenden Beispiel gezeigt), um den Typ der Anzeige anzugeben.

<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Ad i:type="ExpandedTextAd">
    <DevicePreference i:nil="true" />
    <EditorialStatus i:nil="true" />
    <ForwardCompatibilityMap i:nil="true" />
    <Id i:nil="true" />
    <Status i:nil="true" />
    <FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a:string>https://www.contoso.com/womenshoesale</a:string>
    </FinalUrls>
    <Path1>seattle</Path1>
    <Path2>shoe sale</Path2>
    <Text>Find New Customers & Increase Sales!</Text>
    <TextPart2>Start Advertising on Contoso Today.</TextPart2>
    <TitlePart1>Contoso</TitlePart1>
    <TitlePart2>Fast & Easy Setup</TitlePart2>
    <TitlePart3>Top Rated</TitlePart3>
  </Ad>
</Ads>

Anforderungen

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

Verwendet von

AddAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds

Freigeben über