CustomAudience-Datenobjekt – Kampagnenverwaltung

2024-11-13

Definiert eine benutzerdefinierte Zielgruppe.

Hinweis

Es werden nur Aktualisierungen des Namens und der Beschreibung unterstützt. Sie können mithilfe der Bing Ads-API löschen, aber keine benutzerdefinierte Zielgruppe hinzufügen. Abgesehen davon können Sie benutzerdefinierte Zielgruppenzuordnungen und -ausschlüsse hinzufügen und löschen.

Eine benutzerdefinierte Zielgruppe ist eine Art Remarketing-Liste, die mithilfe Ihrer eigenen Kundendaten generiert wird, um umfangreichere Benutzersegmente zu erstellen. Sie können benutzerdefinierte Zielgruppen in Verbindung mit Ihren Remarketing-Listen verwenden, in der Regel über Ihren Datenverwaltungsanbieter (Data Management Provider, DMP). Wenn Ihr DMP eine Verbindung mit unserem Custom Audience-Feature herstellt, können Sie Ihre benutzerdefinierten Zielgruppen für suchorientiertes Remarketing in Microsoft Advertising importieren. Sie können benutzerdefinierte Zielgruppen getrennt vom Remarketing verwenden, ohne dass UET erforderlich ist.

Tipp

Eine Übersicht über benutzerdefinierte Zielgruppen finden Sie im Hilfethema Informationen zu benutzerdefinierten Zielgruppen .

<xs:complexType name="CustomAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AudienceNetworkSize": "LongValueHere",
  "CustomerShare": {
    "CustomerAccountShares": [
      {
        "AccountId": "LongValueHere",
        "Associations": [
          {
            "AssociationCount": "LongValueHere",
            "UsageType": "ValueHere"
          }
        ],
        "CustomerId": "LongValueHere"
      }
    ],
    "OwnerCustomerId": "LongValueHere"
  },
  "Description": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "MembershipDuration": IntValueHere,
  "Name": "ValueHere",
  "ParentId": "LongValueHere",
  "Scope": "ValueHere",
  "SearchSize": "LongValueHere",
  "SupportedCampaignTypes": [
    "ValueHere"
  ],
  "Type": "Custom"
}

Elemente

Das CustomAudience-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von Audience

Das CustomAudience-Objekt wird vom Audience-Objekt abgeleitet und erbt die folgenden Elemente: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Die folgenden Beschreibungen gelten spezifisch für CustomAudience und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom Audience-Objekt erben.

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. Die Zielgruppe muss mindestens 300 Personen haben, bevor Microsoft Advertising es für Optimierungen verwendet. Hinzufügen: Nicht unterstützt Aktualisieren: Schreibgeschützt	lang
CustomerShare	Dieses Element wird für benutzerdefinierte Zielgruppen nicht unterstützt. Hinzufügen: Nicht unterstützt Aktualisieren: Nicht unterstützt	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. Hinzufügen: Nicht unterstützt Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um die vorherige Einstellung zu entfernen, legen Sie dieses Elemment auf einen leeren Zeichenfolgenwert ("") fest.	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 das Audience-Objekt .	KeyValuePairOfstring-Array
Id	Der Microsoft Advertising-Bezeichner der Zielgruppe. Hinzufügen: Nicht unterstützt Aktualisieren: Erforderlich und schreibgeschützt	lang
MembershipDuration	Die Mitgliedschaftsdauer bestimmt, wie weit microsoft Advertising nach Aktionen sucht, die Ihrer benutzerdefinierten Zielgruppendefinition entsprechen, um Ihrer Liste Personen hinzuzufügen. Für eine benutzerdefinierte Zielgruppe ist die Mitgliedschaftsdauer in der Microsoft Advertising-Webanwendung nicht festgelegt, und Microsoft Advertising verschiebt sich an die Einstellungen ihres benutzerdefinierten Zielgruppenanbieters. Wenn Sie die benutzerdefinierte Zielgruppe über die Bing Ads-API anfordern, ist die zurückgegebene Mitgliedschaftsdauer NULL. Hinzufügen: Nicht unterstützt Aktualisieren: Nicht unterstützt	int
Name	Der Name der Zielgruppe. Der Name darf maximal 128 Zeichen lang sein. Hinzufügen: Nicht unterstützt Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	Zeichenfolge
ParentId	Der Microsoft Advertising-Bezeichner des Kunden, der die benutzerdefinierte Zielgruppe enthält. Hinzufügen: Nicht unterstützt Aktualisieren: Nicht unterstützt	lang
Bereich	Bereich definiert, welche Konten diese Zielgruppe verwenden können. Für eine benutzerdefinierte Zielgruppe ist der einzige unterstützte Bereich Der Kunde, und die Zielgruppe kann Kampagnen und Anzeigengruppen in allen Konten des Kunden zugeordnet werden. Hinzufügen: Nicht unterstützt Aktualisieren: Nicht unterstützt	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. Die Zielgruppe muss mindestens 300 Personen haben, bevor Microsoft Advertising es für Optimierungen verwendet. Diese Eigenschaft ist während der Erstellung der Zielgruppe bis zu 24 Stunden lang null oder leer. Wenn Sie beispielsweise neue benutzerdefinierte Zielgruppen aus DMP importiert haben, dauert es 24 Stunden, die Zielgruppe zu erstellen, und in der Zwischenzeit ist diese Eigenschaft null oder leer. Hinzufügen: Nicht unterstützt Aktualisieren: Schreibgeschützt	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. Hinzufügen: Nicht unterstützt Aktualisieren: Schreibgeschützt	Zeichenfolgenarray
Typ	Der Typ der Zielgruppe. Dieser Wert ist Benutzerdefiniert , wenn Sie eine benutzerdefinierte Zielgruppe abrufen. Weitere Informationen zu Zielgruppentypen finden Sie in den Hinweisen zu Zielgruppendatenobjekten. Hinzufügen: Nicht unterstützt Aktualisieren: Schreibgeschützt	AudienceType

Anforderungen

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