ग्राहक मिलान की ऑडियंस बनाएं

CreateUserListRequest भेजकर, कस्टमर मैच के लिए ऑडियंस बनाएं.

अनुरोध का मुख्य हिस्सा बनाना

UserList संसाधन बनाएं. यहां सेट करने के लिए, सामान्य फ़ील्ड दिए गए हैं.

displayName

ज़रूरी है सूची का डिसप्ले नेम. नाम, खाते की सभी सूचियों में अलग होना चाहिए.

description

सूची के बारे में संक्षिप्त जानकारी.

integrationCode

आपके सिस्टम से मिला आईडी.

membershipDuration

ऑडियंस के किसी सदस्य को सूची में जोड़ने के बाद, वह सदस्य सूची में कितने समय तक बना रहता है. वैल्यू, पूरे दिनों के हिसाब से होनी चाहिए. अगर यह सेट नहीं है, तो डिफ़ॉल्ट रूप से ज़्यादा से ज़्यादा वैल्यू सेट होती है.

JSON का इस्तेमाल करने पर, दिनों की संख्या को 86400 (एक दिन में सेकंड की संख्या) से गुणा करके, सेकंड की संख्या का हिसाब लगाएं. इसके बाद, गुणा करने पर मिली वैल्यू को सेट करें. इसके बाद, s जोड़ें. उदाहरण के लिए, अगर आपको 90 दिनों की सदस्यता अवधि चाहिए, तो वैल्यू के तौर पर 7776000s का इस्तेमाल करें, क्योंकि 90 * 86400 = 7776000 होता है.

प्रोटोकॉल बफ़र फ़ॉर्मैट का इस्तेमाल करने पर, दिनों की संख्या के आधार पर Duration ऑब्जेक्ट बनाने के लिए, सुविधा वाले तरीके का इस्तेमाल करें. हालांकि, यह तरीका तब ही इस्तेमाल किया जा सकता है, जब यह मौजूद हो. उदाहरण के लिए, Java के लिए protobuf-java-util लाइब्रेरी में, fromDays() सुविधा वाला तरीका मौजूद है. इसके अलावा, दिनों की संख्या को 86400 (एक दिन में सेकंड की संख्या) से गुणा करके, सेकंड की संख्या का हिसाब लगाएं. इसके बाद, Duration ऑब्जेक्ट के seconds फ़ील्ड को सेट करने के लिए, मिले नतीजे का इस्तेमाल करें.

कस्टमर मैच के लिए ज़रूरी फ़ील्ड

कस्टमर मैच के लिए ऑडियंस बनाने के लिए, ingestedUserListInfo फ़ील्ड ज़रूरी है.

सूची में ऑडियंस के सदस्यों को जोड़ने के लिए, जिस तरह का डेटा इस्तेमाल करना है उसके आधार पर, IngestedUserListInfo पर ये फ़ील्ड सेट करें.

संपर्क जानकारी की सूची

अगर आपको ऑडियंस के सदस्यों को तय करने के लिए, संपर्क जानकारी (हैश किए गए ईमेल पते, फ़ोन नंबर या पते) का इस्तेमाल करना है, तो ये फ़ील्ड सेट करें:

uploadKeyTypes

CONTACT_ID अपलोड पासकोड टाइप वाली सूची पर सेट करें.

uploadKeyTypes सूची में सिर्फ़ एक एंट्री होनी चाहिए.

contactIdInfo

ContactIdInfo मैसेज पर सेट करें. इसमें dataSourceType को DataSourceType enum से सही वैल्यू पर सेट किया गया हो.

मोबाइल आईडी की सूची

अगर आपको ऑडियंस के सदस्यों को तय करने के लिए, मोबाइल आईडी का इस्तेमाल करना है, तो ये फ़ील्ड सेट करें:

uploadKeyTypes

MOBILE_ID अपलोड पासकोड टाइप वाली सूची पर सेट करें.

uploadKeyTypes सूची में सिर्फ़ एक एंट्री होनी चाहिए.

mobileIdInfo

मैसेज पर सेट करें:MobileIdInfo

• dataSourceType को DataSourceType enum से सही वैल्यू पर सेट करें.

• keySpace को IOS या ANDROID पर सेट करें.

• appId को उस स्ट्रिंग पर सेट करें जो मोबाइल ऐप्लिकेशन की खास तौर पर पहचान करती है. यह डेटा उसी ऐप्लिकेशन से इकट्ठा किया गया है.

  • iOS के लिए, आईडी स्ट्रिंग नौ अंकों वाली वह स्ट्रिंग होती है जो App Store के यूआरएल के आखिर में दिखती है. उदाहरण के लिए, "Flood-It!" ऐप्लिकेशन के लिए, 476943146. इसका App Store लिंक https://apps.apple.com/us/app/flood-it/id476943146 है.

  • Android के लिए, आईडी स्ट्रिंग, ऐप्लिकेशन का पैकेज नेम होता है. उदाहरण के लिए, com.labpixies.flood "Flood-It!" ऐप्लिकेशन के लिए, जिसका Google Play लिंक https://play.google.com/store/apps/details?id=com.labpixies.flood है.

यूज़र आईडी की सूची

अगर आपको ऑडियंस के सदस्यों को तय करने के लिए, यूज़र आईडी का इस्तेमाल करना है, तो ये फ़ील्ड सेट करें:

uploadKeyTypes

USER_ID अपलोड पासकोड टाइप वाली सूची पर सेट करें.

uploadKeyTypes सूची में सिर्फ़ एक एंट्री होनी चाहिए.

अनुरोध बनाना

कस्टमर मैच के लिए ऑडियंस बनाने के लिए, create अनुरोध को UserList संसाधन के लिए बनाएं.

1. parent फ़ील्ड को खाते के संसाधन के नाम पर सेट करें. संसाधन का नाम, accountTypes/{accountType}/accounts/{account_id} फ़ॉर्मैट में होना चाहिए.

2. अनुरोध के मुख्य हिस्से के लिए, बनाए गए UserList का इस्तेमाल करें.

3. अगर आपके क्रेडेंशियल, उस Google खाते के लिए नहीं हैं जो parent पर उपयोगकर्ता है, तो मंज़ूरी पाने वाले लोगों और हेडर कॉन्फ़िगर करना में बताए गए तरीके से हेडर सेट करें.

यहां उपयोगकर्ता की अलग-अलग तरह की जानकारी के लिए, JSON में अनुरोध के नमूने दिए गए हैं. हर अनुरोध में, membershipDuration को 2592000s पर सेट किया गया है. यहां 2592000 का मतलब 30 दिनों में सेकंड की संख्या है. अनुरोध आज़माने के लिए, एपीआई एक्सप्लोरर में खोलें बटन पर क्लिक करें.

{
    "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"
}

{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

अनुरोध भेजना

अनुरोध भेजें. अगर ज़रूरी हो, तो अनुरोध के हेडर शामिल करें.

अगर अनुरोध पूरा हो जाता है, तो जवाब में बनाया गया UserList शामिल होता है. इसमें id और name की वैल्यू भरी होती है. इन फ़ील्ड में मौजूद वैल्यू नोट करें, क्योंकि ऑडियंस में ऑडियंस के सदस्यों को जोड़ने के लिए, आपको इनकी ज़रूरत होगी.

अगर अनुरोध पूरा नहीं होता है, तो गड़बड़ियों की जांच करके, पूरा न होने की वजह पता करें. इसके बाद, किसी भी समस्या को ठीक करने के लिए, अनुरोध और हेडर अपडेट करें. इसके बाद, अपडेट किया गया अनुरोध और हेडर भेजें.