Freigeben über

Zielgruppendatenobjekt – Kampagnenverwaltung

Definiert das Basisobjekt einer Zielgruppe.

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

Hinweis

Microsoft Advertising generiert automatisch ähnliche Zielgruppen für Remarketing-Listen für Pilotteilnehmer, d. h. GetCustomerPilotFeatures gibt den Featurebezeichner 317 zurück.

Syntax

<xs:complexType name="Audience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AudienceNetworkSize" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CustomerShare" nillable="true" type="tns:CustomerShare" />
    <xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
    <xs:element xmlns:q124="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q124:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MembershipDuration" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ParentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="SearchSize" nillable="true" type="xs:long" />
    <xs:element xmlns:q125="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="SupportedCampaignTypes" nillable="true" type="q125:ArrayOfstring" />
    <xs:element minOccurs="0" name="Type" type="tns:AudienceType" />
  </xs:sequence>
</xs:complexType>

Elemente

Das Audience-Objekt verfügt über die folgenden Elemente: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type.

Element Beschreibung Datentyp
AudienceNetworkSize Die Gesamtzahl der Personen, die aktive Mitglieder dieser Zielgruppe im Zielgruppennetzwerk sind. Dadurch erhalten Sie eine Vorstellung davon, wie viele Benutzer des Audience-Netzwerks Sie ansprechen können.

Weitere Informationen finden Sie in der Dokumentation für die Objekte, die dieses Element erben, z. B. RemarketingList.		 lang
CustomerShare Bestimmt die Liste der Kunden und Konten, die die Zielgruppe gemeinsam nutzen. Details umfassen die Anzahl der Benutzergruppenzuordnungen.

Dieses Element wird nur mit einer RemarketingList unterstützt. Zielgruppen anderer Typen können in der Kundenhierarchie nicht freigegeben werden.		 CustomerShare
Beschreibung Die Beschreibung der Zielgruppe. Verwenden Sie eine Beschreibung, um sich daran zu erinnern, für welche Zielgruppe Sie sich richten.

Die Beschreibung darf maximal 1.024 Zeichen enthalten.		 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 Microsoft Advertising-Bezeichner der Zielgruppe. lang
MembershipDuration Wenn Sie eine Zielgruppe erstellen, können Sie angeben, wie weit Microsoft Advertising nach Aktionen suchen soll, die Ihrer Zielgruppendefinition entsprechen.

Die Mindestdauer beträgt 1 Tag und die maximal zulässige Dauer 180 Tage.		 int
Name Der Name der Zielgruppe. Der Name darf maximal 128 Zeichen lang sein. Zeichenfolge
ParentId Der Microsoft Advertising-Bezeichner des Kontos oder Kunden.

Wenn der Bereich auf Konto festgelegt ist, ist dies die Konto-ID und andernfalls die Kunden-ID.		 lang
Bereich Bereich definiert, welche Konten diese Zielgruppe verwenden können.

Wenn bereich auf Konto festgelegt ist, kann die Zielgruppe nur Kampagnen und Anzeigengruppen in einem Konto zugeordnet werden, d. h. über die ParentId. Wenn scope auf Customer festgelegt ist, kann die Zielgruppe Kampagnen und Anzeigengruppen in allen Konten des Kunden zugeordnet werden.		 EntityScope
SearchSize Die Gesamtzahl der Personen, die aktive Mitglieder dieser Zielgruppe im Suchnetzwerk sind. Dadurch erhalten Sie eine Vorstellung davon, wie viele Suchbenutzer Sie als Ziel verwenden können.

Weitere Informationen finden Sie in der Dokumentation für die Objekte, die dieses Element erben, z. B. RemarketingList.		 lang
SupportedCampaignTypes Die Liste der Kampagnentypen, die diese Zielgruppe unterstützen.

Unterstützte Werte sind Audience, DynamicSearchAds, Search und Shopping. Möglicherweise werden in Zukunft neue Kampagnentypen hinzugefügt, sodass Sie keine Abhängigkeit von einem festen Satz von Werten annehmen sollten.		 Zeichenfolgenarray
Typ Der Typ der Zielgruppe. Weitere Informationen zu Zielgruppentypen finden Sie in den Hinweisen. AudienceType

Hinweise

Legen Sie für Java und die .NET-Sprachen nicht das Type-Element fest, da der Wert davon bestimmt wird, ob Sie eine benutzerdefinierte Zielgruppe oder eine andere Art von Zielgruppe instanziieren. Wenn Sie das SOAP manuell generieren, verwenden Sie das type-Attribut des Knotens Audience , wie im folgenden Beispiel gezeigt.

<Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Audience i:type="CustomAudience">
    <Description i:nil="false">Custom Audience Description</Description>
    <ForwardCompatibilityMap xmlns:e43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
      <e43:KeyValuePairOfstringstring>
        <e43:key i:nil="false"></e43:key>
        <e43:value i:nil="false"></e43:value>
      </e43:KeyValuePairOfstringstring>
    </ForwardCompatibilityMap>
    <Id i:nil="true" />
    <MembershipDuration i:nil="false">30</MembershipDuration>
    <Name i:nil="false">Custom Audience Name</Name>
    <ParentId i:nil="false">ParentIdHere</ParentId>
    <Scope>Customer</Scope>
  </Audience>
</Audiences>

Anforderungen

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

Verwendet von

AddAudiences
GetAudiencesByIds
UpdateAudiences