ProductAudience-Datenobjekt – Kampagnenverwaltung

Artikel
08/06/2024

Definiert eine Produktgruppe, die Sie verwenden können, um Produkte aus Ihrem Microsoft Merchant Center-Store neu zu vermarkten.

Hinweis

Dynamische Remarketing-Listen wurden in Microsoft Advertising früher als Produktgruppen bezeichnet. Auf der Microsoft Advertising-Benutzeroberfläche wird "Dynamic Remarketing list" (Dynamische Remarketing-Liste) angezeigt, aber um Breaking Changes zu vermeiden, werden die API-Objekte weiterhin als "Produktzielgruppe" bezeichnet.

Dynamische Remarketing-Listen kombinieren Kunden mit bestimmten Produkten basierend auf dem, was sie auf Ihrer Website angesehen, berücksichtigt oder bereits gekauft haben. Sie können dynamische Remarketing-Listen sowohl in Suchkampagnen als auch in Zielgruppenkampagnen verwenden (noch nicht jeder hat Zielgruppenkampagnen).

Dynamische Remarketing-Listen eignen sich am besten für Shopping-Kampagnen und feedbasierte Zielgruppenkampagnen, d. h. für Kampagnen, die eine Microsoft Merchant Center-Store-ID nutzen.

Wichtig

Achten Sie darauf, das Skript zu bearbeiten, das der UET-Tag-ID auf Ihrer Website entspricht, um die ecomm_prodid Parameter und ecomm_pagetype einzuschließen. Der parameter ecomm_prodid ist die Produkt-ID des Produkts auf der Seite. Sie ist für jedes Element eindeutig und muss entweder mit dem Id- oder item_group_id-Attribut in Ihrem Produktfeed übereinstimmen. Nur numerische und alphanumerische Zeichen (einschließlich Bindestrichen) mit maximal 50 Zeichen. Der parameter ecomm_pagetype identifiziert den Typ der Seite, die der Benutzer besucht hat. Gültige Optionen: Startseite, Suchergebnisse, Kategorie, Produkt, Warenkorb, Kauf, andere.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

Syntax

<xs:complexType name="ProductAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="ProductAudienceType" nillable="true" type="tns:ProductAudienceType" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das ProductAudience-Objekt weist die folgenden Elemente auf: ProductAudienceType, TagId.

Element	Beschreibung	Datentyp
ProductAudienceType	Bestimmt, ob Ihre Produkte an allgemeine Besucher, Produktsucher, Produktanzeiger, Warenkorbabbrucher oder frühere Käufer umzuvermarkten sind. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	ProductAudienceType
TagId	Der Microsoft Advertising-Bezeichner des Tags für die universelle Ereignisnachverfolgung (Universal Event Tracking, UET), das mit der Remarketing-Liste verwendet wird. Bevor Sie eine Abhängigkeit von der Tag-ID erstellen, beachten Sie, dass das UET-Tag für oder von einem anderen Kunden freigegeben werden kann. Freigegebene UET-Tags und Zielgruppen sind nur für Pilotkunden verfügbar. Eine Übersicht über die Freigabe von Zielgruppen und UET-Tags in einer Kundenhierarchie finden Sie im technischen Leitfaden Freigeben von Zielgruppen und UET-Tags . Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	lang

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

Geerbte Elemente

Geerbte Elemente von Audience

Das ProductAudience-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 ProductAudience 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: Schreibgeschützt Aktualisieren: Schreibgeschützt	lang
CustomerShare	Dieses Element wird für Produktgruppen nicht unterstützt. Sie können eine freigegebene TagId für Produktgruppen verwenden, aber eine Produktgruppe selbst kann nicht freigegeben werden. 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: Wahlfrei Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	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: Schreibgeschützt Aktualisieren: Erforderlich und schreibgeschützt	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. Hinzufügen: Wahlfrei. Wenn nicht angegeben, wird die Mitgliedschaftsdauer standardmäßig auf 30 festgelegt. Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	int
Name	Der Name der Zielgruppe. Der Name darf maximal 128 Zeichen lang sein. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	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. Hinzufügen: Erforderlich Aktualisieren: Schreibgeschützt. Sie können die übergeordnete ID nicht ändern.	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. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Sie können den Bereich von Konto in Kunde ändern, aber Sie können den Bereich nicht von Kunde in Konto ändern.	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, z. B. wenn Sie die Mitgliedschaftsdauer oder den Tagbezeichner hinzufügen oder aktualisieren. Hinzufügen: Schreibgeschü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: Schreibgeschützt Aktualisieren: Schreibgeschützt	Zeichenfolgenarray
Typ	Der Typ der Zielgruppe. Dieser Wert ist ProductAudience , wenn Sie eine Produktgruppe abrufen. Weitere Informationen zu Zielgruppentypen finden Sie in den Hinweisen zu Zielgruppendatenobjekten. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	AudienceType

Anforderungen

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

Freigeben über