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

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 enum से, dataSourceType को सही वैल्यू पर सेट करें.

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

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

    • iOS के लिए, आईडी स्ट्रिंग नौ अंकों की वह स्ट्रिंग होती है जो App Store के यूआरएल के आखिर में दिखती है. उदाहरण के लिए, 476943146 "Flood-It!" ऐप्लिकेशन के लिए, 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 सूची में सिर्फ़ एक एंट्री होनी चाहिए.

अनुरोध तैयार करना

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

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

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

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

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

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

एपीआई एक्सप्लोरर में खोलें 
{
    "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 की वैल्यू भरी होती है. इन फ़ील्ड में मौजूद वैल्यू नोट कर लें. आपको ऑडियंस में ऑडियंस सदस्यों को जोड़ने के अनुरोधों में इनकी ज़रूरत होगी.

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

पीछे जाएं
खास जानकारी
आगे बढ़ें
किसी ऑडियंस में सदस्यों को अपलोड करना