In diesem Dokument wird beschrieben, wie Sie die Management API zum Verwalten von Google Analytics-Remarketing-Zielgruppen verwenden.
Einleitung
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 in diesem Hilfeartikel.
Anwendungsfälle
Die Ressource Remarketing-Zielgruppe unterstützt get, delete, list, patch und update. Die wichtigsten Anwendungsfälle sind jedoch:
- Listen Sie Remarketing-Zielgruppen auf.
- Erstellen Sie eine neue Remarketing-Zielgruppe.
- Bestehende Remarketing-Zielgruppe aktualisieren
Remarketing-Zielgruppen auflisten
So listen Sie alle Remarketing-Zielgruppen für eine Property auf:
- Verwenden Sie die Management API oder den Konto-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 vonincludeConditions
. Wenn Sie eine auf Status basierende Zielgruppe erstellen, gehen Sie genauso vor fürexcludeConditions
. Informationen zum Definieren von Segmenten finden Sie in der Segmentreferenz.includeConditions
kann optional Werte fürmembershipDurationDays
unddaysToLookBack
enthaltenexcludeConditions.exclusionDuration
kann optional aufPERMANENT
festgelegt werden.
- Führen Sie die Methode
insert
der Ressource „Remarketing-Zielgruppe“ aus.
Mit der API lassen sich zwei Arten von Zielgruppen erstellen: SIMPLE
und STATE_BASED
. Für SIMPLE
-Zielgruppen muss audienceDefinition
nur mit einem positiven segment
ohne einen 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 eine Remarketing-Zielgruppen-ID haben, können Sie
get
aufrufen. Andernfalls können Sie dielist
aufrufen und die Zielgruppe auswählen, die Sie aktualisieren möchten. - Aktualisieren Sie alle beschreibbaren Felder und rufen Sie
update
auf, um das aktualisierte Zielgruppenobjekt zu übergeben.