Entwicklerleitfaden für Remarketing-Zielgruppen

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:

Remarketing-Zielgruppen auflisten

So listen Sie alle Remarketing-Zielgruppen für eine Property auf:

  1. Verwenden Sie die Management API oder den Konto-Explorer, um accountId und webPropertyId abzurufen.
  2. 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:

  1. Verwenden Sie die Management API oder den Konto-Explorer, um accountId und webPropertyId abzurufen.
  2. Verwenden Sie die Management API oder den Konto-Explorer, um die ID der Datenansicht (Profil) für die Property linkedViews [] abzurufen.
  3. 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 eine linkedForeignAccount beschränkt.
    • linkedAdAccounts[].type kann auf ADWORDS_LINKS, DBM_LINKS, MCC_LINKS oder OPTIMIZE festgelegt werden.
  4. In der Sammlung Segmente finden Sie Optionen zum Festlegen der segment-Property von includeConditions. Wenn Sie eine auf Status basierende Zielgruppe erstellen, gehen Sie genauso vor für excludeConditions. Informationen zum Definieren von Segmenten finden Sie in der Segmentreferenz.
  5. 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:

  1. Wenn Sie bereits eine Remarketing-Zielgruppen-ID haben, können Sie get aufrufen. Andernfalls können Sie die list aufrufen und die Zielgruppe auswählen, die Sie aktualisieren möchten.
  2. Aktualisieren Sie alle beschreibbaren Felder und rufen Sie update auf, um das aktualisierte Zielgruppenobjekt zu übergeben.