Entwicklerleitfaden für Remarketing-Zielgruppen

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

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

  1. Verwenden Sie die Management API oder den Account 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 der includeConditions. Wenn Sie eine auf Status basierende Zielgruppe erstellen, gehen Sie genauso für die excludeConditions vor. Wie Sie Segmente definieren, erfahren Sie in der Segmentreferenz.
  5. 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:

  1. Wenn Sie bereits über die Remarketing-Zielgruppen-ID verfügen, 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 eines der beschreibbaren Felder und rufen Sie update auf, um das aktualisierte Zielgruppenobjekt zu übergeben.