Für alle Anfragen an AudienceInsightsService gilt eine Ratenbegrenzung. Für generateAudienceCompositionInsights und generateSuggestedTargetingInsights sind pro Tag weniger Anfragen zulässig als für andere Methoden für Zielgruppeninformationen. Weitere Informationen finden Sie unter API-Kontingente.
Mit AudienceInsightsService können Sie Daten zu Google-Zielgruppeninformationen in Ihre Planungstools einbinden. Die Daten helfen Medienagenturen und Medienplanern, ein besseres Verständnis ihrer Zielgruppe zu erlangen, einschließlich demografischer Merkmale, Interessen und Onlineverhalten.
Mithilfe von Zielgruppeninformationen erhalten Sie einen Überblick über eine Zielgruppe, eine Kategorie, ein Thema oder eine Marke. Wenn Sie das Nutzerverhalten bei weiteren Informationen analysieren, können Sie diese Zielgruppeninformationen nutzen, um die Zusammenhänge und Wahrnehmungen der Nutzer zu erkennen und neue Zielgruppensegmente zu identifizieren.
Die API unterstützt drei Hauptanwendungsfälle:
- Zielgruppen verfeinern und entdecken: Sie können die individuellen Interessen und Verhaltensweisen von Verbrauchern nachvollziehen, um neue Zielgruppen für eine Marke zu identifizieren, Zielgruppen-Personas zu entwickeln und Strategien zur Zielgruppensegmentierung zu verfeinern.
- Kampagnenplanung optimieren: Sie können Datenausgaben in YouTube-Zielgruppen umwandeln, um die Planung darauf abzustimmen, die potenzielle Reichweite von Zielgruppen zu schätzen und die Überschneidung zwischen Zielgruppensegmenten zu messen, um die Kampagnenreichweite zu maximieren.
- Anzeigenbotschaften entwickeln: Passen Sie Anzeigenbotschaften an Ihre Zielgruppe an, basierend auf den Themen und Interessen, mit denen sie sich am meisten beschäftigt.
Teilnahmevoraussetzungen
Damit Partner AudienceInsightsService nutzen können, müssen sie die folgenden Bedingungen erfüllen:
- Sie haben bereits Zugriff auf Insights Finder oder sind berechtigt, darauf zuzugreifen.
- Sie müssen ein Planungstool oder eine Benutzeroberfläche haben, in die die API eingebunden ist.
- Verwenden Sie die API für die Mediaplanung oder andere relevante Anwendungsfälle.
- Führen Sie eine Vorabprüfung durch.
- Anforderungen an die Datennutzung einhalten und sich regelmäßigen Datenprüfungen unterziehen.
- Akzeptieren Sie die Nutzungsbedingungen der Google Ads API und die zugehörige Richtlinie zur Datennutzung.
Weitere Informationen erhalten Sie von Ihrer Google-Kontaktperson.
Zulässige Datumsangaben für Statistiken auflisten
Ein typischer Workflow beginnt damit, zu prüfen, welche Kalendermonate und Zeiträume für die Analyse verfügbar sind. Die Methode listInsightsEligibleDates gibt ein ListInsightsEligibleDatesResponse zurück, dessen Feld data_months die Monate im Format YYYY-MM auflistet, für die Zielgruppeninformationen verfügbar sind.
Das Feld last_thirty_days der Antwort enthält den genauen Zeitraum, den generateAudienceCompositionInsights verwendet, wenn data_month in der Anfrage nicht festgelegt ist.
Attribute für Zielgruppeninformationen auflisten
Bevor Sie Messwerte zur Zielgruppenzusammensetzung oder ‑überschneidung abfragen, sollten Sie mit listAudienceInsightsAttributes gültige Attribut-IDs ermitteln. Diese Methode gibt ein ListAudienceInsightsAttributesResponse mit den verfügbaren Attributen für die angeforderten Dimensionen zurück.
Wenn beispielsweise AFFINITY_USER_INTEREST als Dimension in der Anfrage ausgewählt ist, gibt die Methode unterstützte Zielgruppen mit gemeinsamen Interessen wie „Sportfans“ oder „Musikliebhaber“ zurück. Weitere unterstützte Dimensionen für Nutzerinteressen sind IN_MARKET_USER_INTEREST und LIFE_EVENT_USER_INTEREST. Sie können mehrere Dimensionen in einer einzelnen Anfrage festlegen. Eine vollständige Liste der unterstützten Dimensionen finden Sie in der dimensions-Feldreferenz.
Wenn Sie mit der Dimension KNOWLEDGE_GRAPH nach Knowledge Graph-Entitäten (Themen) suchen, müssen Sie im Feld query_text eine Stringabfrage angeben (z. B. "football and the World Cup").
Sie können optional knowledge_graph_entity_search_options einfügen, um die Themensuche anzupassen:
- Nach Funktionen filtern: Verwenden Sie
search_filter, um die abgerufenen Entitäten auf diejenigen zu beschränken, die bestimmte Funktionen unterstützen. Sie können beispielsweise nach Themen filtern, die als Creator-Attribute unterstützt werden, indem SieCREATOR_ATTRIBUTEim Feldentity_capability_filtersangeben. Es können mehrere Funktionen angegeben werden, die mitOR-Logik kombiniert werden. - Alle Creator-Attribute abrufen: Setzen Sie
get_all_creator_attributesauftrue, um alle verfügbaren Knowledge Graph-Entitäten abzurufen, die als Creator-Attribute getaggt sind. Wenn Sie diese Option verwenden, muss die DimensionKNOWLEDGE_GRAPHausgewählt sein,query_textmuss leer sein und Sie können diese Option nicht mit einemsearch_filterkombinieren.
Die von dieser Auffindbarkeitsmethode zurückgegebenen Attribute können als Eingaben für andere AudienceInsightsService-Methoden verwendet werden.
Jedes AudienceInsightsAttributeMetadata-Objekt in ListAudienceInsightsAttributesResponse bietet eine strukturierte Darstellung eines Zielgruppenattributs sowie beschreibende Attribute und Interaktionsmesswerte.
Sie enthält die primäre Definition des Attributs, den Anzeigenamen, den Dimensionstyp und die geschätzte Zielgruppenreichweite. Felddefinitionen finden Sie in der Referenz zu AudienceInsightsAttributeMetadata.
Zielgruppendefinition generieren
Mit der Methode generateAudienceDefinition wird eine Freiformtextbeschreibung einer Zielgruppe in strukturierte Vorschläge für Zielgruppenattribute übersetzt, die Sie an nachgelagerte Insight-Methoden übergeben können.
Vorgeschlagene Targeting-Statistiken generieren
Die Methode generateSuggestedTargetingInsights gibt eine Sammlung von Targeting-Statistiken (z. B. Zielgruppensegmente, auf die Targeting möglich ist) zurück, die für die angeforderte Zielgruppe relevant sind.
Sie können die gewünschte Zielgruppe entweder als strukturiertes InsightsAudienceDefinition oder als Textbeschreibung in InsightsAudienceDescription angeben.
Während generateAudienceCompositionInsights Statistiken für einzelne Attributsegmente zurückgibt, liefert generateSuggestedTargetingInsights gebündelte Vorschläge für Zielgruppensegmente in Google Ads, die Sie als Ziel festlegen können. Mit dieser Methode können Fragen wie „Gib mir Vorschläge für Zielgruppen, die ich ansprechen kann, für Väter in den Dreißigern, die gerne angeln“ beantwortet werden.
Messwerte für Targeting-Vorschläge generieren
Die Methode generateTargetingSuggestionMetrics gibt ein GenerateTargetingSuggestionMetricsResponse zurück, das die potenzielle YouTube-Nutzerzahl enthält, die für jede in GenerateTargetingSuggestionMetricsRequest angeforderte Zielgruppendefinition erreicht werden kann.
Mit dieser Methode lassen sich Fragen beantworten wie „Wie viele Männer ab 18 Jahren, die sich für Camping in den USA interessieren, können auf YouTube erreicht werden?“.
Informationen zur Zielgruppenzusammensetzung generieren
Die Methode generateAudienceCompositionInsights gibt ein GenerateAudienceCompositionInsightsResponse zurück, das eine Liste von Attributen enthält, die die angeforderte Zielgruppe darstellen, sowie Index- und Freigabemesswerte, die den Anteil der Zielgruppe für jedes Attribut mit einer Referenzpopulation vergleichen.
Sie müssen ein Zielland für die Zielgruppe angeben. Die Liste der unterstützten Dimensionen zum Abrufen von Zusammensetzungsstatistiken ist im Feld dimensions von GenerateAudienceCompositionInsightsRequest dokumentiert.
Mit dieser Methode lassen sich Fragen beantworten wie: „Welche sind die wichtigsten Affinitäten, für die sich meine Zielgruppe im Vergleich zur Allgemeinbevölkerung interessiert, und wie viel wahrscheinlicher ist es, dass sie sich mit diesen Affinitäten beschäftigen?“
Statistiken zu Zielgruppenüberschneidungen generieren
Die Methode generateAudienceOverlapInsights gibt ein GenerateAudienceOverlapInsightsResponse zurück, das eine Liste von Zielgruppenattributen mit Schätzungen der Überschneidung zwischen ihrer potenziellen YouTube-Reichweite und der eines primären Attributs enthält.
Sie müssen ein Zielland und ein primäres Attribut angeben. Altersgruppe, Geschlecht, Segmente mit gemeinsamen Interessen und Segmente mit kaufbereiten Zielgruppen werden als Zielgruppendimensionen unterstützt.
Mit dieser Methode lassen sich Fragen beantworten wie „Wie groß ist die inkrementelle Zielgruppe, wenn wir sowohl Sportfans als auch Musikliebhaber in den USA ansprechen?“.
Insights Finder-Bericht erstellen
Mit der Methode generateInsightsFinderReport wird ein gespeicherter Bericht in Insights Finder erstellt. Grundlage dafür sind die in GenerateInsightsFinderReportRequest angegebenen Eingaben. Außerdem wird ein GenerateInsightsFinderReportResponse mit einem extern zugänglichen Link zurückgegeben, über den der Bericht in der Insights Finder-Benutzeroberfläche geöffnet werden kann.
Google Issue Tracker
Verwenden Sie den Google Issue Tracker, um Supportfragen zu stellen, Fehler zu melden oder Feature Requests einzureichen. Google verfolgt, priorisiert und veröffentlicht Updates zu Ihren Anfragen direkt im Issue Tracker. Weitere Informationen finden Sie unter Problem im Google Issue Tracker erstellen.
Erstellen Sie ein Problem mit einer der folgenden Issue Tracker-Vorlagen:
- Allgemeine Supportfrage stellen oder Feedback zur Dokumentation geben
- Technischen Fehler melden
- API-Feature Request senden
Füllen Sie alle Felder in der Vorlage mit detaillierten Informationen aus, damit Google Ihre Anfrage reproduzieren und priorisieren kann. Google schließt unvollständige Meldungen möglicherweise und bittet Sie, ein neues Problem mit den fehlenden Details einzureichen.