Method: accountTypes.accounts.insights.retrieve

Recupera estadísticas de datos de marketing para una lista de usuarios determinada.

Esta función solo está disponible para los socios de datos.

Encabezados de autorización:

Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:

  • login-account: (Opcional) Es el nombre del recurso de la cuenta en la que la Cuenta de Google de las credenciales es un usuario. Si no se configura, se establece de forma predeterminada en la cuenta de la solicitud. Formato: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opcional) Es el nombre del recurso de la cuenta con una vinculación del producto establecida con el login-account. Formato: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

Solicitud HTTP

POST https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/insights:retrieve

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es la cuenta principal que posee la lista de usuarios. Formato: accountTypes/{accountType}/accounts/{account}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "baseline": {
    object (Baseline)
  },
  "userListId": string
}
Campos
baseline

object (Baseline)

Obligatorio. Es el modelo de referencia para las estadísticas solicitadas.
userListId

string

Obligatorio. Es el ID de la lista de usuarios para la que se solicitan estadísticas.

Cuerpo de la respuesta

Es el mensaje de respuesta para la API de DM de MarketingDataInsightsService.RetrieveInsights.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Campos
marketingDataInsights[]

object (MarketingDataInsight)

Contiene las estadísticas de los datos de marketing.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Modelo de referencia

Son los criterios de referencia con los que se comparan las estadísticas.

Representación JSON 
{

  // Union field baseline can be only one of the following:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of list of possible types for union field baseline.
}
Campos
Campo de unión baseline. Es la ubicación de referencia con la que se comparan las estadísticas. baseline puede ser solo uno de los parámetros siguientes:
baselineLocation

object (Location)

Es la ubicación de referencia de la solicitud. La ubicación de referencia es una lista OR de las regiones solicitadas.
locationAutoDetectionEnabled

boolean

Si se establece como verdadero, el servicio intentará detectar automáticamente la ubicación de referencia para las estadísticas.

Ubicación

Es la ubicación de referencia de la solicitud. La ubicación de referencia se encuentra en la lista OR de códigos de región ISO 3166-1 alpha-2 de las regiones solicitadas.

Representación JSON 
{
  "regionCodes": [
    string
  ]
}
Campos
regionCodes[]

string

Es una lista de códigos de región ISO 3166-1 alpha-2.

MarketingDataInsight

Son estadísticas sobre los datos de marketing.

Esta función solo está disponible para los socios de datos.

Representación JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
Campos
dimension

enum (AudienceInsightsDimension)

Dimensión a la que pertenece la estadística.
attributes[]

object (MarketingDataInsightsAttribute)

Son estadísticas sobre los valores de una dimensión determinada.

AudienceInsightsDimension

Son las dimensiones posibles para generar estadísticas.

Enums
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED No se especifica.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN El valor es desconocido en esta versión.
AFFINITY_USER_INTEREST Es un objeto Affinity UserInterest.
IN_MARKET_USER_INTEREST Es un objeto In-Market UserInterest.
AGE_RANGE Es un rango de edad.
GENDER Es un género.

MarketingDataInsightsAttribute

Son las estadísticas sobre una colección de atributos relacionados de la misma dimensión.

Representación JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
Campos
userInterestId

string (int64 format)

Es el ID del interés del usuario.
lift

number

Es la medida de efectividad que tiene el público para el valor del atributo en comparación con el modelo de referencia. Rango [0-1].
ageRange

enum (AgeRange)

Es el rango de edad del público para el que se proporciona la efectividad.
gender

enum (Gender)

Es el género del público para el que se proporciona la efectividad.

Rango de edades

Son los rangos de edad demográficos.

Enums
AGE_RANGE_UNSPECIFIED No se especifica.
AGE_RANGE_UNKNOWN Desconocido.
AGE_RANGE_18_24 Tener entre 18 y 24 años
AGE_RANGE_25_34 Entre 25 y 34 años
AGE_RANGE_35_44 Entre 35 y 44 años
AGE_RANGE_45_54 Entre 45 y 54 años
AGE_RANGE_55_64 Tener entre 55 y 64 años
AGE_RANGE_65_UP 65 años y más

Género

Es el tipo de género demográfico (por ejemplo, femenino).

Enums
GENDER_UNSPECIFIED No se especifica.
GENDER_UNKNOWN Desconocido.
GENDER_MALE Hombre.
GENDER_FEMALE Mujer.