In diesem Dokument wird beschrieben, wie Sie mit der Management API Google Analytics-Remarketing-Zielgruppen verwalten.
Einführung
Mit der Management API können Sie create
, get
, delete
, list
, update
und patch
Remarketing-Zielgruppen für eine Google Analytics-Property erstellen. Weitere Informationen zur Funktionsweise von Remarketing-Zielgruppen finden Sie im Hilfeartikel Remarketing-Zielgruppen in Analytics.
Anwendungsfälle
Die Ressource „Remarketing-Zielgruppe“ unterstützt get, delete, list, patch und update. Die wichtigsten Anwendungsfälle sind jedoch:
- Remarketing-Zielgruppen auflisten
- Erstellen Sie eine neue Remarketing-Zielgruppe.
- Remarketing-Zielgruppen aktualisieren
Remarketing-Zielgruppen auflisten
So listen Sie alle Remarketing-Zielgruppen für eine Property auf:
- Verwenden Sie die Management API oder den Account Explorer, um
accountId
undwebPropertyId
abzurufen. - Führen Sie die Methode
list
der Ressource für Remarketing-Zielgruppen aus.
Weitere Informationen zur Methode list
für die Ressource Remarketing-Zielgruppe finden Sie in der API-Referenz.
Neue Remarketing-Zielgruppe erstellen
So erstellen Sie eine neue Remarketing-Zielgruppe für eine Property:
- Verwenden Sie die Management API oder den Konto-Explorer, um
accountId
undwebPropertyId
abzurufen. - Verwenden Sie die Management API oder den Konto-Explorer, um die ID der Datenansicht (Profil) für die Property
linkedViews []
abzurufen. - Verwenden Sie die Sammlung Google Ads-Verknüpfungen, um eine Google Ads-Konto-ID für die
linkedAdAccounts.linkedAccountId
abzurufen.- Die Property
linkedAdAccounts[]
ist derzeit auf nur einelinkedForeignAccount
beschränkt. linkedAdAccounts[].type
kann aufADWORDS_LINKS
,DBM_LINKS
,MCC_LINKS
oderOPTIMIZE
festgelegt werden.
- Die Property
- In der Sammlung Segmente finden Sie Optionen zum Festlegen der
segment
-Property derincludeConditions
. Wenn Sie eine auf Status basierende Zielgruppe erstellen, gehen Sie genauso für dieexcludeConditions
vor. Wie Sie Segmente definieren, erfahren Sie in der Segmentreferenz.includeConditions
kann optional Werte fürmembershipDurationDays
unddaysToLookBack
haben.excludeConditions.exclusionDuration
kann optional aufPERMANENT
festgelegt werden.
- Führen Sie die Methode
insert
der Ressource „Remarketing-Zielgruppe“ aus.
Mit der API können Sie zwei Arten von Zielgruppen erstellen: SIMPLE
und STATE_BASED
. Für SIMPLE
-Zielgruppen muss audienceDefinition
nur mit einer positiven segment
ohne NOT-Operator (das Zeichen !
) erstellt werden. Wenn Sie eine Ausschlussbedingung einschließen möchten, müssen Sie einen statebasedDefinition
definieren. Weitere Informationen finden Sie unter Zielgruppen auf Statusbasis. Weitere Informationen finden Sie in diesem Referenzbeispiel.
Bestehende Remarketing-Zielgruppe aktualisieren
So aktualisieren Sie eine bestehende Remarketing-Zielgruppe für eine Property:
- Wenn Sie bereits über die Remarketing-Zielgruppen-ID verfügen, können Sie
get
aufrufen. Andernfalls können Sie dielist
aufrufen und die Zielgruppe auswählen, die Sie aktualisieren möchten. - Aktualisieren Sie eines der beschreibbaren Felder und rufen Sie
update
auf, um das aktualisierte Zielgruppenobjekt zu übergeben.