Method: customers.generateInsightsFinderReport

Tworzy zapisany raport, który można wyświetlić w narzędziu Insights Finder.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Żądanie HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Pola
baselineAudience

object (BasicInsightsAudience)

To pole jest wymagane. Bazowa grupa odbiorców raportu, zwykle wszystkie osoby w danym regionie.
specificAudience

object (BasicInsightsAudience)

To pole jest wymagane. Konkretni odbiorcy danego raportu. Statystyki w raporcie będą oparte na atrybutach, które występują w tej grupie odbiorców częściej niż w przypadku bazowej grupy odbiorców raportu.
customerInsightsGroup

string

Nazwa planowanego klienta. Jest to wartość zdefiniowana przez użytkownika.

Treść odpowiedzi

Odpowiedź na pytanie AudienceInsightsService.GenerateInsightsFinderReport zawierająca URL raportu, który można udostępnić.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "savedReportUrl": string
}
Pola
savedReportUrl

string

Adres URL HTTPS prowadzący do precyzyjnego linku do interfejsu Insights Finder z danymi wejściowymi w raporcie wpisanymi zgodnie z żądaniem.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adwords

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

BasicInsightsAudience

Opis listy odbiorców służącej do wysyłania próśb o statystyki.

Zapis JSON 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
Pola
countryLocation[]

object (LocationInfo)

To pole jest wymagane. Kraje w przypadku tej grupy odbiorców.
subCountryLocations[]

object (LocationInfo)

Atrybuty lokalizacji geograficznej podrzędnych krajów. Jeśli występuje, każdy z tych elementów musi znajdować się w jednym z krajów na tej liście odbiorców.
gender

object (GenderInfo)

Płeć odbiorców. Jeśli go nie ma, grupa odbiorców nie jest ograniczana ze względu na płeć.
ageRanges[]

object (AgeRangeInfo)

Przedziały wiekowe odbiorców. Jeśli jej nie ma, grupa odbiorców obejmuje wszystkie osoby powyżej 18 roku życia, które pasują do innych atrybutów.
userInterests[]

object (UserInterestInfo)

Zainteresowania użytkownika definiujące tę grupę odbiorców. Obsługa odbiorców o podobnych zainteresowaniach i odbiorców na rynku.
topics[]

object (AudienceInsightsTopic)

Tematy reprezentowane przez elementy Grafu wiedzy lub kategorie produktów i usług, którymi interesują się użytkownicy z tej listy.

AudienceInsightsTopic

Encja lub kategoria reprezentująca temat definiujący listę odbiorców.

Zapis JSON 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
Pola
Pole sumy topic. Atrybut encji lub kategorii. topic może mieć tylko jedną z tych wartości:
entity

object (AudienceInsightsEntity)

Element Grafu wiedzy
category

object (AudienceInsightsCategory)

Kategoria produktu i usługi