किसी ऑडियंस में सदस्यों को अपलोड करना

IngestAudienceMembersRequest भेजकर, कस्टमर मैच ऑडियंस में सदस्यों को अपलोड करें.

अनुरोध को कॉन्फ़िगर करने और भेजने के लिए, यह तरीका अपनाएं:

1. termsOfService फ़ील्ड को TermsOfService मैसेज पर सेट करें. साथ ही, customerMatchTermsOfServiceStatus को ACCEPTED पर सेट करें, ताकि यह पुष्टि की जा सके कि operatingAccount ने कस्टमर मैच की सेवा की शर्तें स्वीकार कर ली हैं.

2. audienceMembers सूची में मौजूद हर AudienceMember पर, अपलोड किए गए डेटा के टाइप के आधार पर डेटा फ़ील्ड सेट करें:

   • अगर अपलोड की गई फ़ाइल में संपर्क जानकारी, आईपी पते का डेटा या दोनों शामिल हैं, तो compositeData फ़ील्ड को CompositeData ऑब्जेक्ट पर सेट करें. संपर्क जानकारी के लिए, इसके userData फ़ील्ड को UserData ऑब्जेक्ट पर सेट करें. साथ ही, ऑडियंस के सदस्य के हर आइडेंटिफ़ायर के लिए, userIdentifiers सूची में एक अलग एंट्री जोड़ें. आईपी पते के डेटा के लिए, ऑडियंस के सदस्य के हर आईपी पते के लिए, ipData सूची में IpData एंट्री जोड़ें.

     हालांकि, userData का इस्तेमाल अब भी किया जा सकता है, लेकिन हमारा सुझाव है कि आप compositeData का इस्तेमाल करें. इससे यह पक्का किया जा सकेगा कि आपका इंटिग्रेशन, आने वाले समय में होने वाले सुधारों के लिए तैयार है. ज़्यादा जानकारी के लिए, कंपोज़िट डेटा देखें.

   • अगर अपलोड की गई फ़ाइल में मोबाइल आईडी शामिल हैं, तो mobileData फ़ील्ड को MobileData मैसेज पर सेट करें. दर्शक के हर मोबाइल आईडी के लिए, mobileIds सूची में अलग एंट्री जोड़ें.

   • अगर अपलोड किए गए डेटा में यूज़र आईडी शामिल हैं, तो userIdData फ़ील्ड को UserIdData मैसेज पर सेट करें. साथ ही, इसके userId फ़ील्ड को ऑडियंस के सदस्य के यूज़र आईडी पर सेट करें.

3. कस्टमर मैच वाला डेटा भेजने के लिए, ऑडियंस के सदस्यों का डेटा भेजना लेख में दिया गया तरीका अपनाएं.

ऑडियंस सेगमेंट के सैंपल सदस्य

यहां दिए गए उदाहरणों में, सदस्य के हर तरह के डेटा के लिए, AudienceMember ऑब्जेक्ट को स्ट्रक्चर करने का तरीका बताया गया है. एक अनुरोध में मौजूद हर AudienceMember के लिए, एक ही तरह का आईडी डेटा सेट होना चाहिए (compositeData, mobileData या userIdData):

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

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

आईपी पते का डेटा

{
  "compositeData": {
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

संपर्क और आईपी डेटा

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    },
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

मोबाइल आईडी

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

यूज़र आईडी

{
  "userIdData": {
    "userId": "user_987654321"
  }
}