Method: accountTypes.accounts.insights.retrieve

একটি প্রদত্ত ব্যবহারকারী তালিকার জন্য মার্কেটিং ডেটা অন্তর্দৃষ্টি পুনরুদ্ধার করে।

এই বৈশিষ্ট্যটি শুধুমাত্র ডেটা পার্টনারদের জন্য উপলব্ধ।

অনুমোদনের শিরোনাম:

এই পদ্ধতিটি নিম্নলিখিত ঐচ্ছিক হেডারগুলিকে সমর্থন করে যা API কীভাবে অনুরোধের জন্য অ্যাক্সেস অনুমোদন করে তা নির্ধারণ করে:

  • login-account : (ঐচ্ছিক) সেই অ্যাকাউন্টের রিসোর্স নাম যেখানে শংসাপত্রের Google অ্যাকাউন্টটি একজন ব্যবহারকারী। যদি সেট না করা থাকে, তাহলে অনুরোধের অ্যাকাউন্টে ডিফল্টভাবে সেট করা হবে। ফর্ম্যাট: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account : (ঐচ্ছিক) login-account সাথে একটি প্রতিষ্ঠিত পণ্য লিঙ্ক সহ অ্যাকাউন্টের রিসোর্স নাম। ফর্ম্যাট: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

HTTP অনুরোধ

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

URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পথের পরামিতি

পরামিতি
parent

string

আবশ্যক। ব্যবহারকারী তালিকার মালিকানাধীন মূল অ্যাকাউন্ট। ফর্ম্যাট: accountTypes/{accountType}/accounts/{account}

অনুরোধের মূল অংশ

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON উপস্থাপনা 
{
  "baseline": {
    object (Baseline)
  },
  "userListId": string
}
ক্ষেত্র
baseline

object ( Baseline )

প্রয়োজনীয়। অনুরোধ করা অন্তর্দৃষ্টির ভিত্তিরেখা।

userListId

string

প্রয়োজনীয়। ব্যবহারকারীর তালিকা আইডি যার জন্য অন্তর্দৃষ্টি অনুরোধ করা হয়েছে।

প্রতিক্রিয়া মূল অংশ

DM API MarketingDataInsightsService.RetrieveInsights এর জন্য প্রতিক্রিয়া বার্তা

যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:

JSON উপস্থাপনা 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
ক্ষেত্র
marketingDataInsights[]

object ( MarketingDataInsight )

মার্কেটিং ডেটার অন্তর্দৃষ্টি ধারণ করে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

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

বেসলাইন

অন্তর্দৃষ্টির তুলনা করা হয় এমন মৌলিক মানদণ্ড।

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 )

অনুরোধের বেসলাইন অবস্থান। বেসলাইন অবস্থান হল অনুরোধকৃত অঞ্চলগুলির একটি OR-তালিকা।

locationAutoDetectionEnabled

boolean

যদি সত্য হিসেবে সেট করা হয়, তাহলে পরিষেবাটি অন্তর্দৃষ্টির জন্য স্বয়ংক্রিয়ভাবে বেসলাইন অবস্থান সনাক্ত করার চেষ্টা করবে।

স্থান

অনুরোধের বেসলাইন অবস্থান। অনুরোধকৃত অঞ্চলের ISO 3166-1 আলফা-2 অঞ্চল কোডের OR-তালিকায় বেসলাইন অবস্থানটি রয়েছে।

JSON উপস্থাপনা 
{
  "regionCodes": [
    string
  ]
}
ক্ষেত্র
regionCodes[]

string

ISO 3166-1 আলফা-2 অঞ্চল কোডের তালিকা।

মার্কেটিংডেটাইনসাইট

মার্কেটিং ডেটার জন্য অন্তর্দৃষ্টি।

এই বৈশিষ্ট্যটি শুধুমাত্র ডেটা পার্টনারদের জন্য উপলব্ধ।

JSON উপস্থাপনা 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
ক্ষেত্র
dimension

enum ( AudienceInsightsDimension )

অন্তর্দৃষ্টি যে মাত্রার অন্তর্গত।

attributes[]

object ( MarketingDataInsightsAttribute )

একটি নির্দিষ্ট মাত্রার মান সম্পর্কে অন্তর্দৃষ্টি।

দর্শকদের অন্তর্দৃষ্টিমাত্রা

অন্তর্দৃষ্টি তৈরিতে ব্যবহারের জন্য সম্ভাব্য মাত্রা।

এনামস
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED নির্দিষ্ট করা হয়নি।
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN এই সংস্করণে মানটি অজানা।
AFFINITY_USER_INTEREST একজন অ্যাফিনিটি ব্যবহারকারীর আগ্রহ।
IN_MARKET_USER_INTEREST একটি ইন-মার্কেট ব্যবহারকারীর আগ্রহ।
AGE_RANGE একটি বয়সসীমা।
GENDER একটি লিঙ্গ।

মার্কেটিংডেটাইনসাইটসঅ্যাট্রিবিউট

একই মাত্রার সম্পর্কিত বৈশিষ্ট্যের সংগ্রহের জন্য অন্তর্দৃষ্টি।

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 ১৮ থেকে ২৪ বছরের মধ্যে।
AGE_RANGE_25_34 ২৫ থেকে ৩৪ বছরের মধ্যে।
AGE_RANGE_35_44 ৩৫ থেকে ৪৪ বছরের মধ্যে।
AGE_RANGE_45_54 ৪৫ থেকে ৫৪ বছরের মধ্যে।
AGE_RANGE_55_64 ৫৫ থেকে ৬৪ বছরের মধ্যে।
AGE_RANGE_65_UP ৬৫ বছর এবং তার বেশি বয়সী।

লিঙ্গ

জনসংখ্যাতাত্ত্বিক লিঙ্গের ধরণ (উদাহরণস্বরূপ, মহিলা)।

এনামস
GENDER_UNSPECIFIED নির্দিষ্ট করা হয়নি।
GENDER_UNKNOWN অজানা।
GENDER_MALE পুরুষ।
GENDER_FEMALE মহিলা।