بارگذاری اعضا در مخاطب

با ارسال کردن IngestAudienceMembersRequest، اعضا را در مخاطب «مطابقت مشتری» بارگذاری کنید.

برای پیکربندی و ارسال درخواست، مراحل زیر را تکمیل کنید:

1. فیلد termsOfService را روی TermsOfService پیامی با customerMatchTermsOfServiceStatus تنظیم‌شده روی ACCEPTED تنظیم کنید تا تأیید کنید که operatingAccount شرایط خدمات «تطابق مشتری» را پذیرفته است.

2. در هر AudienceMember در فهرست audienceMembers، فیلد داده را براساس نوع داده‌ای که بارگذاری شامل آن است تنظیم کنید:

   • اگر بارگذاری حاوی اطلاعات تماس، داده‌های نشانی IP، یا هر دو باشد، فیلد compositeData را روی شیء CompositeData تنظیم کنید. برای اطلاعات تماس، فیلد userData آن را روی شیء UserData تنظیم کنید و ورودی جداگانه‌ای در فهرست userIdentifiers برای هر شناسه عضو مخاطب اضافه کنید. برای داده‌های نشانی IP، یک ورودی IpData در فهرست ipData برای هر نشانی IP عضو مخاطب اضافه کنید.

     درحالی‌که userData هنوز پشتیبانی می‌شود، توصیه می‌کنیم از compositeData استفاده کنید تا مطمئن شوید ادغام شما برای بهبودهای آینده آماده است. برای جزئیات، داده‌های ترکیبی را ببینید.

   • اگر بارگذاری حاوی شناسه‌های تلفن همراه است، فیلد mobileData را روی پیام MobileData تنظیم کنید. برای هر شناسه تلفن همراه عضو مخاطب، ورودی جداگانه‌ای در فهرست mobileIds اضافه کنید.

   • اگر بارگذاری حاوی شناسه‌های کاربر است، فیلد userIdData را روی پیام a 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"
  }
}