Method: insights.retrieveInsights

Belirli bir hedefle ilgili pazarlama verisi analizlerini alır.

HTTP isteği

POST https://datamanager.googleapis.com/v1/insights:retrieveInsights

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
Alanlar
destination

object (Destination)

Zorunlu. Analizlerin alınacağı hedef.
baseline

object (Baseline)

Zorunlu. İstenen analizlerin temel çizgisi.

Yanıt metni

DM API MarketingDataInsightsService.RetrieveInsights için yanıt mesajı

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Alanlar
marketingDataInsights[]

object (MarketingDataInsight)

Pazarlama verileriyle ilgili analizleri içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Temel

Analizlerin karşılaştırıldığı temel ölçütler.

JSON gösterimi 
{

  // 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.
}
Alanlar
baseline birleşik alanı. Analizlerin karşılaştırıldığı temel konum. baseline aşağıdakilerden yalnızca biri olabilir:
baselineLocation

object (Location)

İsteğin temel konumudur. Temel konum, istenen bölgelerin VEYA listesidir.
locationAutoDetectionEnabled

boolean

Doğru olarak ayarlanırsa hizmet, analizler için temel konumunu otomatik olarak algılamaya çalışır.

Konum

İsteğin temel konumudur. Temel konum, istenen bölgelerin ISO 3166-1 alfa-2 bölge kodlarının OR listesinde yer alıyor.

JSON gösterimi 
{
  "regionCodes": [
    string
  ]
}
Alanlar
regionCodes[]

string

ISO 3166-1 alfa-2 bölge kodlarının listesi.

MarketingDataInsight

Pazarlama verileriyle ilgili analizler.

JSON gösterimi 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
Alanlar
dimension

enum (AudienceInsightsDimension)

Analizin ait olduğu boyut.
attributes[]

object (MarketingDataInsightsAttribute)

Belirli bir boyutun değerleriyle ilgili analizler.

AudienceInsightsDimension

Analiz oluşturmada kullanılabilecek olası boyutlar.

Sıralamalar
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Belirtilmedi.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN Bu sürümde değer bilinmiyor.
AFFINITY_USER_INTEREST Yakın ilgi alanı kullanıcı ilgi alanı.
IN_MARKET_USER_INTEREST Pazardaki bir kullanıcı ilgi alanı.
AGE_RANGE Yaş aralığı
GENDER Cinsiyet.

MarketingDataInsightsAttribute

Aynı boyuttaki ilgili özellikler koleksiyonuyla ilgili analizler.

JSON gösterimi 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
Alanlar
userInterestId

string (int64 format)

Kullanıcı ilgi alanı kimliği.
lift

number

Kitlenin, temel değere kıyasla özellik değeri için sahip olduğu artış ölçüsü. Aralık [0-1].
ageRange

enum (AgeRange)

Artışın sağlandığı kitlenin yaş aralığı.
gender

enum (Gender)

Artışın sağlandığı kitlenin cinsiyeti.

Yaş Aralığı

Demografik yaş aralıkları

Sıralamalar
AGE_RANGE_UNSPECIFIED Belirtilmedi.
AGE_RANGE_UNKNOWN Bilinmiyor.
AGE_RANGE_18_24 18-24 yaş aralığında olmalıdır.
AGE_RANGE_25_34 25-34 yaş aralığında
AGE_RANGE_35_44 35-44 yaş arasında
AGE_RANGE_45_54 45-54 yaş aralığında
AGE_RANGE_55_64 55-64 yaş aralığında
AGE_RANGE_65_UP 65 yaş ve üzeri

Cinsiyet

Demografik cinsiyet türü (örneğin, kadın).

Sıralamalar
GENDER_UNSPECIFIED Belirtilmedi.
GENDER_UNKNOWN Bilinmiyor.
GENDER_MALE Erkek.
GENDER_FEMALE Kadın.