REST Resource: customers.userLists

সম্পদ: ব্যবহারকারী তালিকা

একটি বিজ্ঞাপন ডেটা হাব-পরিচালিত ব্যবহারকারী তালিকা সংজ্ঞায়িত করে।

JSON প্রতিনিধিত্ব
{
  "name": string,
  "userListId": string,
  "adsDataCustomerId": string,
  "title": string,
  "description": string,
  "type": enum (UserListType),
  "createEmail": string,
  "listSize": string,
  "populateTime": string,
  "recipientAdsDataLinks": [
    string
  ],
  "state": enum (State),

  // Union field user_list can be only one of the following:
  "frequencyList": {
    object (FrequencyBasedListInfo)
  },
  "remarketingList": {
    object (RemarketingListInfo)
  }
  // End of list of possible types for union field user_list.
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। একটি বিজ্ঞাপন ডেটা হাব ব্যবহারকারী তালিকাকে অনন্যভাবে চিহ্নিত করে এমন নাম। এতে গ্রাহক/[customerId]/userLists/[userListId] ফর্ম রয়েছে

userListId

string ( int64 format)

শুধুমাত্র আউটপুট। ব্যবহারকারী তালিকা আইডি। এই ক্ষেত্রটি পরিষেবা দ্বারা উত্পন্ন হয় এবং ব্যবহারকারীর তালিকা তৈরি করতে ব্যবহৃত হয়।

adsDataCustomerId

string ( int64 format)

অপরিবর্তনীয়। লিঙ্ক করা বিজ্ঞাপন ডেটা হাব গ্রাহক আইডি এই ব্যবহারকারী তালিকার সাথে যুক্ত। এই ব্যবহারকারী তালিকা ব্যবহার করে UserListQuery কাজ চালানোর সময় এই IDটিকে adsDataCustomerId হিসাবে নির্দিষ্ট করতে হবে। অনুপস্থিত থাকলে, মূল গ্রাহককে ব্যবহার করা হবে। তালিকা তৈরি হওয়ার পরে এটি পরিবর্তন করা যাবে না।

title

string

প্রয়োজন। ব্যবহারকারীর তালিকার শিরোনাম, যা নির্দিষ্ট বিজ্ঞাপনDataCustomerId-এর জন্য অনন্য।

description

string

প্রয়োজন। ব্যবহারকারীর তালিকার বিবরণ।

type

enum ( UserListType )

শুধুমাত্র আউটপুট। UserList প্রকার মান userList এর সাথে সামঞ্জস্যপূর্ণ হওয়া উচিত। এই মান শুধুমাত্র পঠনযোগ্য এবং পেতে/তালিকা অনুরোধে অ্যাক্সেসযোগ্য হবে।

createEmail

string

শুধুমাত্র আউটপুট। এই ব্যবহারকারীর তালিকা তৈরি করা ব্যবহারকারীর ইমেল ঠিকানা।

listSize

string ( int64 format)

শুধুমাত্র আউটপুট। ব্যবহারকারীর তালিকায় ব্যবহারকারীর সংখ্যা। তালিকা আকার আপডেট বিলম্বিত হতে পারে.

populateTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। তালিকা শেষ জনসংখ্যার সময়.

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z"

state

enum ( State )

শুধুমাত্র আউটপুট। ব্যবহারকারী তালিকার অবস্থা (সক্রিয়/মোছা)। এই মান শুধুমাত্র পঠনযোগ্য এবং পেতে/তালিকা অনুরোধে অ্যাক্সেসযোগ্য হবে।

ইউনিয়ন ক্ষেত্র user_list । ব্যবহারকারীর তালিকার প্রকারের উপর নির্ভর করে আরও কনফিগারেশন।

ঠিক একটি সেট করা আবশ্যক. user_list নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

frequencyList

object ( FrequencyBasedListInfo )

ফ্রিকোয়েন্সি ক্যাপিংয়ের জন্য ব্যবহারকারীর তালিকা।

remarketingList

object ( RemarketingListInfo )

পুনঃবিপণন তালিকা।

UserListType

ব্যবহারকারীর তালিকা প্রকার। ব্যবহারকারী তালিকা নির্মাণ এবং টার্গেটিং সময়ে ব্যবহার এই enum উপর নির্ভর করে. তালিকা তৈরির পরে এর ধরন পরিবর্তন করা যাবে না।

এনামস
USER_LIST_TYPE_UNSPECIFIED ডিফল্ট মান: ব্যবহার করা উচিত নয়।
REMARKETING ADH-এ SQL কোয়েরি দিয়ে রিমার্কেটিং অডিয়েন্স তৈরি করা হয়েছে। পুনঃবিপণন তালিকা ইতিবাচক এবং নেতিবাচক টার্গেটিং জন্য ব্যবহার করা যেতে পারে.
FREQUENCY_BASED ফ্রিকোয়েন্সি সীমিত দর্শক। এই ধরনের শ্রোতা নেতিবাচক লক্ষ্যবস্তুতে সীমাবদ্ধ।

ফ্রিকোয়েন্সি ভিত্তিক তালিকা তথ্য

ফ্রিকোয়েন্সি-ভিত্তিক ব্যবহারকারী তালিকার জন্য মেটাডেটা।

JSON প্রতিনিধিত্ব
{
  "dv360LineitemIds": [
    string
  ],
  "cmCampaignIds": [
    string
  ],
  "googleAdsCampaignIds": [
    string
  ],
  "eventMatchers": [
    {
      object (EventMatcher)
    }
  ],
  "frequencyConstraint": {
    object (FrequencyConstraint)
  },
  "slidingWindowDays": integer
}
ক্ষেত্র
dv360LineitemIds[]
(deprecated)

string ( int64 format)

DV360 লাইন আইটেমগুলির জন্য আইডি যা ফ্রিকোয়েন্সিতে অবদান রাখে।

cmCampaignIds[]
(deprecated)

string ( int64 format)

CM প্রচারের জন্য আইডি যা ফ্রিকোয়েন্সিতে অবদান রাখে।

googleAdsCampaignIds[]
(deprecated)

string ( int64 format)

Google বিজ্ঞাপন প্রচারের জন্য আইডি যা ফ্রিকোয়েন্সিতে অবদান রাখে।

eventMatchers[]

object ( EventMatcher )

কোন ঘটনা কম্পাঙ্ক অবদান. ফ্রিকোয়েন্সি-ভিত্তিক ব্যবহারকারী তালিকা তৈরি করার সময়, ইভেন্টম্যাচারগুলি ফ্রিকোয়েন্সিতে অবদানকারী ইভেন্টগুলি নির্দিষ্ট করার জন্য পছন্দ করা হয়। EventMatchers খালি থাকলে dv360LineitemIds, cmCampaignIds এবং googleAdsCampaignIds ব্যবহার করা হয়।

frequencyConstraint

object ( FrequencyConstraint )

যখন একজন ব্যবহারকারী তালিকায় যুক্ত হয় তখন বর্ণনা করে।

slidingWindowDays

integer

প্রয়োজন। প্রতিটি ইভেন্টের ফ্রিকোয়েন্সি গণনা করার সময় ব্যবহৃত সময় উইন্ডোর আকার। এটি দিনে পরিমাপ করা হয়

ইভেন্টম্যাচার

জেনেরিক ইভেন্ট যা ফ্রিকোয়েন্সিতে অবদান রাখে।

JSON প্রতিনিধিত্ব
{
  "matchType": enum (MatchType),
  "value": string
}
ক্ষেত্র
matchType

enum ( MatchType )

ফ্রিকোয়েন্সি গণনায় যে সীমাবদ্ধতা অন্তর্ভুক্ত করা হবে।

value

string

সীমাবদ্ধতার মান। উদাহরণস্বরূপ, একটি Google বিজ্ঞাপন প্রচারের ID = 1234 নির্দিষ্ট করার জন্য, ম্যাচ টাইপ হবে GOOGLE_ADS_CAMPAIGN_ID এবং মান হবে '1234'। সংশ্লিষ্ট ম্যাচটাইপের জন্য এই মান আছে এমন ইভেন্টগুলি ফ্রিকোয়েন্সি গণনায় অন্তর্ভুক্ত করা হবে।

ম্যাচ টাইপ

ফ্রিকোয়েন্সি গণনার জন্য সমর্থিত সীমাবদ্ধতার প্রকারগুলি। অতিরিক্ত সীমাবদ্ধতা সমর্থন করার জন্য ভবিষ্যতে এই এনামে আরও প্রকার যুক্ত হতে পারে। আপনি DescribeValidFrequencyLimitingEventMatchersRequest-এ MatchType-এ একটি ফিল্টার নির্দিষ্ট করতে পারেন যাতে ফলাফলে ফিরে আসা ইভেন্ট ম্যাচারগুলিকে শুধুমাত্র আপনার API দ্বারা সমর্থিতদের মধ্যে সীমাবদ্ধ করা যায়। উদাহরণ স্বরূপ, ফিল্টারটিকে "eventMatcher.match_type= CM_CAMPAIGN_ID বা eventMatch_type=GOOGLE_ADS_CAMPAIGN_ID" হিসাবে সেট করলে শুধুমাত্র ঐ দুটি প্রকারের EventMatchers ফেরত আসবে।

এনামস
MATCH_TYPE_UNSPECIFIED ডিফল্ট মান। এই মান অব্যবহৃত.
CM_CAMPAIGN_ID ক্যাম্পেইন ম্যানেজার ক্যাম্পেইন আইডি প্রতিনিধিত্বকারী সীমাবদ্ধতার ধরন।
DV360_INSERTION_ORDER_ID DV360 সন্নিবেশ অর্ডার আইডি প্রতিনিধিত্বকারী সীমাবদ্ধতার ধরন।
DV360_LINE_ITEM_ID DV360 লাইন আইটেম আইডি প্রতিনিধিত্বকারী সীমাবদ্ধতার ধরন।
GOOGLE_ADS_CAMPAIGN_ID সীমাবদ্ধতার ধরন Google বিজ্ঞাপন প্রচারাভিযান আইডি প্রতিনিধিত্ব করে।

ফ্রিকোয়েন্সি সীমাবদ্ধতা

ক্যাপের জন্য ইভেন্টের ন্যূনতম সংখ্যা উল্লেখ করুন।

JSON প্রতিনিধিত্ব
{
  "eventType": enum (EventType),
  "thresholdEventCount": string
}
ক্ষেত্র
eventType

enum ( EventType )

অপরিবর্তনীয়। ইভেন্টের ধরন যা thresholdEventCount-এর বিপরীতে গণনা করা হবে। আপাতত আমরা স্পষ্টভাবে তুলনামূলক সীমাবদ্ধতার প্রতিনিধিত্ব করি না, ধরে নিই যে সবগুলিই GREATER_OR_EQUAL৷

thresholdEventCount

string ( int64 format)

প্রয়োজন। প্রতিটি ব্যবহারকারীর অন্তত K ইভেন্টে উপস্থিত হওয়া উচিত।

ইভেন্টের ধরণ

ইভেন্টের প্রকার যা ফ্রিকোয়েন্সি গণনা করতে ব্যবহার করা যেতে পারে।

এনামস
EVENT_TYPE_UNSPECIFIED ডিফল্ট মান: ব্যবহার করা উচিত নয়।
IMPRESSIONS সমস্ত ইমপ্রেশন গণনা করুন।

পুনঃবিপণন তালিকা তথ্য

পুনঃবিপণন তালিকার জন্য মেটাডেটা।

JSON প্রতিনিধিত্ব
{
  "userListQuery": string,
  "populatingUserListQueries": [
    string
  ]
}
ক্ষেত্র
userListQuery

string

অপরিবর্তনীয়। Ads Data Hub ব্যবহারকারীর তালিকার ক্যোয়ারী রিসোর্স যা নির্দিষ্ট করে কিভাবে ব্যবহারকারীদের এই দর্শকদের সাথে যুক্ত করা হয়। এর ফর্ম আছে: গ্রাহক/[customerId]/userListQueries/[query_resource_id]

populatingUserListQueries[]

string

শুধুমাত্র আউটপুট। বিজ্ঞাপন ডেটা হাব ব্যবহারকারীর তালিকার কোয়েরি রিসোর্স যা এই অডিয়েন্সকে পপুলেট করেছে। 1:1 userlist:query বিধিনিষেধ কার্যকর হওয়ার আগে একাধিক প্রশ্ন দ্বারা পপুলেট করা ব্যবহারকারী তালিকাগুলিকে সমর্থন করার জন্য এটি একটি উত্তরাধিকার ক্ষেত্র হিসাবে উদ্দিষ্ট। এর ফর্ম আছে: গ্রাহক/[customerId]/userListQueries/[query_resource_id]

রাষ্ট্র

ব্যবহারকারী তালিকার অবস্থা।

এনামস
STATE_UNSPECIFIED ডিফল্ট / আনসেট মান।
STATE_ACTIVE ব্যবহারকারী তালিকা এখনও খোলা এবং সক্রিয়.
STATE_DELETED ব্যবহারকারীর তালিকা মুছে ফেলা হিসাবে চিহ্নিত করা হয়েছে এবং আর লক্ষ্য করার জন্য ব্যবহার করা উচিত নয়

পদ্ধতি

addEventMatchers

একটি ফ্রিকোয়েন্সি-ভিত্তিক ব্যবহারকারী তালিকায় ইভেন্ট ম্যাচারদের যোগ করে।

addRecipients

একটি বিজ্ঞাপন ডেটা হাব-পরিচালিত ব্যবহারকারী তালিকার প্রাপকদের সত্তা যোগ করুন।

create

একটি বিজ্ঞাপন ডেটা হাব-পরিচালিত ব্যবহারকারী তালিকা তৈরি করে।

delete

অনুরোধ করা বিজ্ঞাপন ডেটা হাব-পরিচালিত ব্যবহারকারী তালিকা মুছুন।

generateFrequencyListMemberships

ব্যবহারকারী তালিকার জন্য সদস্যপদ তৈরি করুন।

get

অনুরোধ করা বিজ্ঞাপন ডেটা হাব-পরিচালিত ব্যবহারকারী তালিকা পুনরুদ্ধার করে।

list

নির্দিষ্ট বিজ্ঞাপন ডেটা হাব গ্রাহক দ্বারা পরিচালিত ব্যবহারকারীর তালিকাগুলিকে তালিকাভুক্ত করে৷

patch

অনুরোধ করা বিজ্ঞাপন ডেটা হাব-পরিচালিত ব্যবহারকারী তালিকা আপডেট করে।

removeRecipients

বিজ্ঞাপন ডেটা হাব-পরিচালিত ব্যবহারকারী তালিকার প্রাপকদের থেকে সত্তাগুলিকে সরিয়ে দেয়।