Entwicklerleitfaden für Remarketing-Zielgruppen

In diesem Dokument wird beschrieben, wie Sie mit der Management API Google Analytics-Remarketing-Zielgruppen verwalten.

Hinweis: Wenn Sie diese API verwenden, müssen Sie die Richtlinie zu Google Analytics-Werbefunktionen einhalten, einschließlich der Regeln zu sensiblen Kategorien.

Einführung

Mit der Management API können Sie Remarketing-Zielgruppen des Typs create, get, delete, list, update und patch 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 Remarketing-Zielgruppenressource 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

Hinweis: Ihre Remarketing-Zielgruppen bleiben leer und Ihre Remarketing-Kampagnen werden möglicherweise nicht ausgeführt, wenn Sie nicht über das Tag die entsprechenden Daten erfassen. Aktivieren Sie als Erstes die Werbefunktionenin den Google Analytics-Property-Einstellungen.

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 „Remarketing-Zielgruppen“ aus.

Details zur Methode list für die 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 Account Explorer, um accountId und webPropertyId abzurufen.
2. Rufen Sie über die Management API oder den Konto-Explorer die ID der Datenansicht (Profil) für die linkedViews []-Property ab.
3. Rufen Sie mit der Sammlung Google Ads-Verknüpfungen eine Google Ads-Konto-ID für die linkedAdAccounts.linkedAccountId ab.
   • 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. Mit der Sammlung Segmente können Sie die Property segment der includeConditions festlegen. Wenn Sie eine staatsbasierte Zielgruppe erstellen, können Sie das auch für die excludeConditions tun. Informationen zum Definieren eines Segments finden Sie auch in der Segmentreferenz.
   • includeConditions kann optional Werte für membershipDurationDays und daysToLookBack enthalten
   • excludeConditions.exclusionDuration kann optional auf PERMANENT gesetzt werden.
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 die audienceDefinition nur mit einer positiven segment und ohne NOT-Operator (das !-Zeichen) erstellt werden. Wenn Sie eine Ausschlussbedingung einschließen möchten, müssen Sie eine statebasedDefinition definieren. Weitere Informationen dazu finden Sie unter Staatliche Zielgruppen. Weitere Informationen

Hinweis: Du kannst entweder audienceDefinition oder stateBasedAudienceDefinition definieren und audienceType auf den entsprechenden Wert festlegen. Außerdem sind 2.000 zulässige Remarketing-Zielgruppen zulässig. Seien Sie vorsichtig, wenn Sie das Erstellen von Remarketing-Zielgruppen automatisieren.

Bestehende Remarketing-Zielgruppe aktualisieren

So aktualisieren Sie eine 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 die beschreibbaren Felder und rufen Sie update auf, um das aktualisierte Zielgruppenobjekt zu übergeben.

Hinweis: Nachdem eine Zielgruppe erstellt wurde, kann ihre audienceType nicht mehr geändert werden. Mit anderen Worten: Wenn eine Zielgruppe einen Wert für audienceDefinition hat, können Sie keine Aktualisierung mit einem Wert für stateBasedAudienceDefinition aufrufen. Weitere Informationen finden Sie unter Staatliche Zielgruppen. Weitere Informationen findest du im Referenzbeispiel.