- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- InsightsAudience
- InsightsAudienceAttributeGroup
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- Testen!
Gibt eine Sammlung von Attributen zurück, die in einer relevanten Zielgruppe vertreten sind, mit Messwerten, die den Anteil der einzelnen Attribute an der Zielgruppe mit dem Anteil an der Baseline-Zielgruppe vergleichen.
Liste der ausgegebenen Fehler: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP-Anfrage
POST https://googleads.googleapis.com/v14/customers/{customerId}:generateAudienceCompositionInsights
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
customerId |
Erforderlich. Die ID des Kunden. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "audience": { object ( |
Felder | |
---|---|
audience |
Erforderlich. Die Zielgruppe, für die Erkenntnisse angefordert werden. |
baselineAudience |
Die Baseline-Zielgruppe, mit der die gewünschte Zielgruppe verglichen wird. |
dataMonth |
Der Zeitraum von einem Monat, der für Statistiken im Format "yyyy-mm" verwendet werden soll. Wenn die Richtlinie nicht konfiguriert ist, werden Statistiken für die letzten 30 Tage zurückgegeben. |
dimensions[] |
Erforderlich. Die Zielgruppendimensionen, für die Zusammensetzungsstatistiken zurückgegeben werden sollen. |
customerInsightsGroup |
Der Name der Kundin oder des Kunden, für den/die geplant werden soll. Dies ist ein benutzerdefinierter Wert. |
Antworttext
Antwortnachricht für AudienceInsightsService.GenerateAudienceCompositionInsights
.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"sections": [
{
object ( |
Felder | |
---|---|
sections[] |
Der Inhalt des Statistikberichts (in Abschnitte gegliedert). Jeder Bereich ist mit einem der AudienceInsightsDimension-Werte in der Anfrage verknüpft. Pro Dimension kann mehr als ein Abschnitt vorhanden sein. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/adwords
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
InsightsAudience
Eine Gruppe von Nutzern, definiert durch verschiedene Merkmale, für die mit AudienceInsightsService Statistiken angefordert werden können.
JSON-Darstellung |
---|
{ "countryLocations": [ { object ( |
Felder | |
---|---|
countryLocations[] |
Erforderlich. Die Länder für die Zielgruppe. |
subCountryLocations[] |
Geografischer Standortattribute für das Unterland. Sofern vorhanden, muss jedes dieser Elemente in einem der Länder der Zielgruppe enthalten sein. Ist dies nicht der Fall, wird die Zielgruppe geografisch auf die countryLocations ausgerichtet und nicht weiter. |
gender |
Geschlecht der Zielgruppe. Ist dies nicht der Fall, wird die Zielgruppe nicht nach Geschlecht eingeschränkt. |
ageRanges[] |
Altersgruppen für die Zielgruppe. Falls nicht, umfasst die Zielgruppe alle Personen über 18 Jahren, die den anderen Attributen entsprechen. |
parentalStatus |
Elternstatus für die Zielgruppe. Ist dies nicht der Fall, gelten für die Zielgruppe keine Einschränkungen durch den Elternstatus. |
incomeRanges[] |
Perzentilbereiche des Haushaltseinkommens für die Zielgruppe. Ist dies nicht der Fall, wird die Zielgruppe nicht auf den Bereich des Haushaltseinkommens angewendet. |
dynamicLineups[] |
Dynamische Pakete, die die von der Zielgruppe angesehenen YouTube-Inhalte darstellen |
topicAudienceCombinations[] |
Eine Kombination aus Entitäts-, Kategorie- und Nutzerinteressenattributen, mit denen die Zielgruppe definiert wird. Die Kombination hat eine logische UND-aus-ODER-Struktur: Attribute innerhalb einer InsightsAudienceAttributeGroup werden mit OR und die Kombinationen selbst mit AND kombiniert. Beispielsweise kann der Ausdruck (Entity OR Affinität) AND (kaufbereit ODER Kategorie) mithilfe von zwei InsightsAudienceAttributeGroups mit jeweils zwei Attributen gebildet werden. |
InsightsAudienceAttributeGroup
Eine Liste der AudienceInsightsAttributes.
JSON-Darstellung |
---|
{
"attributes": [
{
object ( |
Felder | |
---|---|
attributes[] |
Erforderlich. Eine Sammlung von Zielgruppenattributen, die mit einem logischen ODER kombiniert werden sollen. Die Attribute müssen nicht alle dieselbe Dimension haben. In diesem Kontext werden nur Knowledge Graph-Objekte, Produkt- und Dienstleistungskategorien sowie Zielgruppen mit gemeinsamen Interessen und kaufbereite Zielgruppen unterstützt. |
AudienceCompositionSection
Eine Sammlung verwandter Attribute desselben Typs in einem Bericht mit Statistiken zur Zielgruppenzusammensetzung.
JSON-Darstellung |
---|
{ "dimension": enum ( |
Felder | |
---|---|
dimension |
Der Typ der Attribute in diesem Abschnitt. |
topAttributes[] |
Die relevantesten Segmente für diese Zielgruppe. Falls die Dimension GENDER, AGE_RANGE oder PARENTAL_STATUS lautet, ist diese Liste der Attribute vollständig. |
clusteredAttributes[] |
Zusätzliche Attribute für diese Zielgruppe, gruppiert in Clustern. Wird nur ausgefüllt, wenn die Dimension YOUTUBE_CHANNEL ist. |
AudienceCompositionAttribute
Ein Zielgruppenattribut mit Metadaten und Messwerten.
JSON-Darstellung |
---|
{ "attributeMetadata": { object ( |
Felder | |
---|---|
attributeMetadata |
Das Attribut mit seinen Metadaten. |
metrics |
Messwerte für das Attribut freigeben und indexieren. |
AudienceCompositionMetrics
Die Anteil- und Indexmesswerte, die einem Attribut in einem Bericht mit Statistiken zur Zielgruppenzusammensetzung zugeordnet sind.
JSON-Darstellung |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
Felder | |
---|---|
baselineAudienceShare |
Der Anteil der Baseline-Zielgruppe (von 0 bis einschließlich 1), der mit dem Attribut übereinstimmt. |
audienceShare |
Der Anteil (von 0 bis einschließlich 1) der spezifischen Zielgruppe, die dem Attribut entspricht. |
index |
Das Verhältnis von „AudienceShare“ zu „BaselineAudienceShare“ oder null, wenn dieses Verhältnis nicht definiert oder nicht aussagekräftig ist. |
score |
Ein Relevanzwert von 0 bis einschließlich 1. |
AudienceCompositionAttributeCluster
Eine Sammlung verwandter Attribute mit Metadaten und Messwerten in einem Bericht mit Statistiken zur Zielgruppenzusammensetzung.
JSON-Darstellung |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
Felder | |
---|---|
clusterDisplayName |
Der Name dieses Clusters von Attributen |
clusterMetrics |
Wenn die mit diesem Cluster verknüpfte Dimension YOUTUBE_CHANNEL ist, dann sind clusterMetrics Messwerte, die dem Cluster als Ganzes zugeordnet sind. Bei anderen Dimensionen ist das Feld nicht festgelegt. |
attributes[] |
Die einzelnen Attribute, aus denen dieser Cluster besteht, mit Metadaten und Messwerten. |