একটি গ্রাহক ম্যাচ দর্শক তৈরি করুন

CreateUserListRequest পাঠিয়ে একটি কাস্টমার ম্যাচ অডিয়েন্স তৈরি করুন।

Construct the request body

একটি UserList রিসোর্স তৈরি করুন। এখানে সেট করার জন্য সাধারণ ফিল্ডগুলো দেওয়া হলো।

displayName

তালিকার প্রদর্শিত নাম আবশ্যক । অ্যাকাউন্টটির মালিকানাধীন সমস্ত তালিকার মধ্যে নামটি অবশ্যই অনন্য হতে হবে।

description

A brief description of the list.

integrationCode

An ID from your system.

membershipDuration

তালিকায় যুক্ত হওয়ার পর একজন দর্শক কতক্ষণ থাকবেন। এই মানটি অবশ্যই পূর্ণ দিন হতে হবে। সেট করা না থাকলে, এটি ডিফল্টভাবে সর্বোচ্চ মান গ্রহণ করবে।

If using JSON, calculate the number of seconds by multiplying the duration days by 86400 (the number of seconds per day). Then set the value to the multiplication result, followed by s . For example, if you want a membership duration of 90 days, use the value 7776000s since 90 * 86400 = 7776000 .

প্রোটোকল বাফার ফরম্যাট ব্যবহার করলে, দিনের সংখ্যার উপর ভিত্তি করে একটি Duration অবজেক্ট তৈরি করার জন্য সুবিধাজনক পদ্ধতিটি ব্যবহার করুন, যদি সেরকম কোনো পদ্ধতি বিদ্যমান থাকে। উদাহরণস্বরূপ, জাভার protobuf-java-util লাইব্রেরিতে একটি fromDays() সুবিধাজনক পদ্ধতি রয়েছে। অন্যথায়, Duration-এর দিন সংখ্যাকে 86400 (প্রতি দিনের সেকেন্ড সংখ্যা) দিয়ে গুণ করে সেকেন্ডের সংখ্যা গণনা করুন এবং সেই ফলাফলটি Duration অবজেক্টের seconds ফিল্ডে সেট করতে ব্যবহার করুন।

Required fields for Customer Match

কাস্টমার ম্যাচ অডিয়েন্সের জন্য ingestedUserListInfo ফিল্ডটি আবশ্যক।

তালিকায় দর্শক সদস্যদের যুক্ত করার জন্য আপনি যে ধরনের ডেটা ব্যবহার করতে চান, তার উপর ভিত্তি করে IngestedUserListInfo তে যে ফিল্ডগুলো সেট করতে হবে, সেগুলো এখানে দেওয়া হলো।

যোগাযোগের তথ্যের তালিকা

আপনার দর্শক সদস্যদের নির্ধারণ করতে যোগাযোগের তথ্য (হ্যাশ করা ইমেল ঠিকানা, ফোন নম্বর বা ঠিকানা) ব্যবহার করতে চাইলে নিম্নলিখিত ফিল্ডগুলি সেট করুন:

uploadKeyTypes

CONTACT_ID আপলোড কী টাইপ ধারণকারী একটি তালিকায় সেট করুন।

uploadKeyTypes তালিকায় অবশ্যই একটিমাত্র এন্ট্রি থাকতে হবে।

contactIdInfo

DataSourceType enum থেকে উপযুক্ত মান দিয়ে dataSourceType সেট করে এটিকে একটি ContactIdInfo মেসেজে সেট করুন।

Mobile ID list

Set the following fields if you want to use mobile IDs to define your audience members:

uploadKeyTypes

MOBILE_ID আপলোড কী টাইপ ধারণকারী একটি তালিকায় সেট করুন।

uploadKeyTypes তালিকায় অবশ্যই একটিমাত্র এন্ট্রি থাকতে হবে।

mobileIdInfo

Set to a MobileIdInfo message:

• DataSourceType enum থেকে dataSourceType কে উপযুক্ত মানে সেট করুন।

• keySpace IOS অথবা ANDROID এ সেট করুন।

• যে মোবাইল অ্যাপ্লিকেশন থেকে ডেটা সংগ্রহ করা হয়েছে, সেটিকে অনন্যভাবে শনাক্তকারী স্ট্রিং হিসেবে appId সেট করুন।

  • For iOS, the ID string is the 9 digit string that appears at the end of the App Store URL. For example, 476943146 for the "Flood-It!" app with App Store link https://apps.apple.com/us/app/flood-it/id476943146 .

  • For Android, the ID string is the application's package name. For example, com.labpixies.flood for the "Flood-It!" app with Google Play link https://play.google.com/store/apps/details?id=com.labpixies.flood .

Construct the request

একটি কাস্টমার ম্যাচ অডিয়েন্স তৈরি করতে, UserList রিসোর্সের জন্য একটি create রিকোয়েস্ট তৈরি করুন।

1. parent ফিল্ডটিকে অ্যাকাউন্টের রিসোর্স নেম হিসেবে সেট করুন। রিসোর্স নেমটি অবশ্যই accountTypes/{accountType}/accounts/{account_id} ফরম্যাট অনুসরণ করবে।

2. অনুরোধের মূল অংশে আপনার তৈরি করা UserList ব্যবহার করুন।

3. আপনার ক্রেডেনশিয়ালগুলি যদি parent কোনো ব্যবহারকারী Google অ্যাকাউন্টের না হয়, তাহলে ‘কনফিগার ডেস্টিনেশন অ্যান্ড হেডারস’ -এ বর্ণিত পদ্ধতি অনুযায়ী হেডার সেট করুন।

Here are sample requests in JSON for the different types of user information. Each request sets the membershipDuration to 2592000s , where 2592000 is the number of seconds in 30 days. Click the Open in API Explorer button to try a request.

{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

অনুরোধ পাঠান

অনুরোধটি পাঠান এবং প্রয়োজন হলে অনুরোধ হেডারগুলো অন্তর্ভুক্ত করুন।

If the request succeeds, the response contains the created UserList with the id and name populated. Make note of the values in these fields since you need them in requests to add audience members to the audience.

যদি অনুরোধটি ব্যর্থ হয়, তাহলে ব্যর্থতার কারণ নির্ধারণ করতে ত্রুটিগুলো পরীক্ষা করুন , যেকোনো সমস্যা সমাধানের জন্য অনুরোধ এবং হেডারগুলো আপডেট করুন, এবং তারপর আপডেট করা অনুরোধ ও হেডারগুলো প্রেরণ করুন।