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

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

अनुरोध बनाना

कस्टमर मैच के लिए ऑडियंस बनाने के लिए, 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"
}

अनुरोध भेजना

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

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

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