Method: insights.retrieveInsights

تعرض هذه السمة إحصاءات بيانات التسويق لوجهة معيّنة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
الحقول
destination

object (Destination)

الحقل مطلوب. الوجهة التي سيتم استرداد الإحصاءات الخاصة بها.
baseline

object (Baseline)

الحقل مطلوب. تمثّل هذه السمة خط الأساس للرؤى المطلوبة.

نص الاستجابة

رسالة الردّ على DM API MarketingDataInsightsService.RetrieveInsights

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
الحقول
marketingDataInsights[]

object (MarketingDataInsight)

يحتوي على إحصاءات بيانات التسويق.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

Baseline

معايير أساسية تتم مقارنة الإحصاءات بها.

تمثيل 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.
}
الحقول
حقل الدمج baseline الموقع الجغرافي الأساسي الذي تتم مقارنة الإحصاءات به يمكن أن تكون baseline إحدى القيم التالية فقط:
baselineLocation

object (Location)

الموقع الجغرافي الأساسي للطلب الموقع الجغرافي الأساسي هو قائمة "أو" بالمناطق المطلوبة.
locationAutoDetectionEnabled

boolean

في حال ضبطها على "صحيح"، ستحاول الخدمة رصد الموقع الجغرافي الأساسي للإحصاءات تلقائيًا.

الموقع الجغرافي

الموقع الجغرافي الأساسي للطلب يجب أن يكون الموقع الجغرافي الأساسي ضمن قائمة OR لرموز المناطق ذات التنسيق ISO 3166-1 alpha-2 الخاصة بالمناطق المطلوبة.

تمثيل JSON 
{
  "regionCodes": [
    string
  ]
}
الحقول
regionCodes[]

string

قائمة برموز المناطق وفقًا لمعيار ISO 3166-1 alpha-2

MarketingDataInsight

إحصاءات لبيانات التسويق

تمثيل JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
الحقول
dimension

enum (AudienceInsightsDimension)

تمثّل هذه السمة المقياس الذي تنتمي إليه الإحصاءات.
attributes[]

object (MarketingDataInsightsAttribute)

إحصاءات حول قيم سمة معيّنة

AudienceInsightsDimension

المكوّنات المحتملة التي يمكن استخدامها لإنشاء الإحصاءات

عمليات التعداد
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED لم يتم تحديد أي قيمة.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN القيمة غير معروفة في هذا الإصدار.
AFFINITY_USER_INTEREST تمثّل هذه السمة اهتمام المستخدمين المشترك.
IN_MARKET_USER_INTEREST تمثّل هذه السمة اهتمام المستخدمين في السوق.
AGE_RANGE تمثّل هذه السمة فئة عمرية.
GENDER جنس

MarketingDataInsightsAttribute

إحصاءات لمجموعة من السمات ذات الصلة من السمة نفسها

تمثيل JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
الحقول
userInterestId

string (int64 format)

رقم تعريف اهتمام المستخدِم.
lift

number

مقياس التحسّن الذي حقّقه الجمهور في قيمة السمة مقارنةً بالمقياس الأساسي النطاق [0-1]
ageRange

enum (AgeRange)

تمثّل هذه السمة الفئة العمرية للجمهور الذي يتم توفير مقياس التحسّن له.
gender

enum (Gender)

جنس الجمهور الذي يتم توفير التحسّن له.

معدل العمر

الفئات العمرية الديمغرافية

عمليات التعداد
AGE_RANGE_UNSPECIFIED لم يتم تحديد أي قيمة.
AGE_RANGE_UNKNOWN غير معروف.
AGE_RANGE_18_24 أن يتراوح عمرك بين 18 و24 عامًا
AGE_RANGE_25_34 أن يتراوح عمره بين 25 و34 عامًا
AGE_RANGE_35_44 تتراوح أعمارهم بين 35 و44 عامًا
AGE_RANGE_45_54 تتراوح أعمارهم بين 45 و54 عامًا
AGE_RANGE_55_64 تتراوح أعمارهم بين 55 و64 عامًا
AGE_RANGE_65_UP 65 عامًا وما فوق

الجنس

نوع الجنس الديمغرافي (على سبيل المثال، أنثى)

عمليات التعداد
GENDER_UNSPECIFIED لم يتم تحديد أي قيمة.
GENDER_UNKNOWN غير معروف.
GENDER_MALE ذكر
GENDER_FEMALE أنثى