Method: customers.generateAudienceOverlapInsights

Возвращает набор атрибутов аудитории вместе с оценками совпадения их потенциального охвата на YouTube и данного входного атрибута.

Список выброшенных ошибок: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP-запрос

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customer Id

string

Необходимый. Идентификатор клиента.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Поля
country Location

object ( LocationInfo )

Необходимый. Страна, в которой рассчитывается размер и перекрытие аудиторий.

primary Attribute

object ( AudienceInsightsAttribute )

Необходимый. Атрибут аудитории, который должен пересекаться со всеми другими подходящими аудиториями. Это должна быть близость или интерес пользователя на рынке, возрастной диапазон или пол.

dimensions[]

enum ( AudienceInsightsDimension )

Необходимый. Типы атрибутов, для которых необходимо вычислить перекрытие с PrimaryAttribute. Значения должны быть подмножеством AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE и GENDER.

customer Insights Group

string

Имя планируемого клиента. Это определяемое пользователем значение.

Тело ответа

Ответное сообщение для AudienceInsightsService.GenerateAudienceOverlapInsights .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Поля
primary Attribute Metadata

object ( AudienceInsightsAttributeMetadata )

Метаданные для основного атрибута, включая потенциальный охват на YouTube.

dimension Results[]

object ( DimensionOverlapResult )

Списки атрибутов и их перекрытие с основным атрибутом, по одному списку на каждое запрошенное измерение.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

РазмерПерекрытиеРезультат

Список атрибутов аудитории одного измерения, включая их перекрытие с основным атрибутом, возвращаемый как часть GenerateAudienceOverlapInsightsResponse .

JSON-представление 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
Поля
dimension

enum ( AudienceInsightsDimension )

Размерность всех атрибутов в этом разделе.

items[]

object ( AudienceOverlapItem )

Атрибуты и их перекрытие с основным атрибутом.

АудиторияOverlapItem

Атрибут аудитории, метаданные которого включают совпадение между потенциальным охватом этого атрибута на YouTube и потенциальным охватом основного атрибута.

JSON-представление 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Поля
attribute Metadata

object ( AudienceInsightsAttributeMetadata )

Атрибут и его метаданные, включая потенциальный охват на YouTube.

potential Youtube Reach Intersection

string ( int64 format)

Предполагаемый размер пересечения этого атрибута аудитории с основным атрибутом, то есть количество доступных пользователей YouTube, которые соответствуют ОБА основному атрибуту и ​​этому.