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

با ارسال 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 را روی پیام UserIdData تنظیم کنید، و فیلد userId آن را روی شناسه کاربر برای عضو مخاطب تنظیم کنید.

3. داده‌های «مطابقت مشتری» را بااستفاده از مراحل موجود در ارسال اعضای مخاطب ارسال کنید.

نمونه اعضای مخاطب

مثال‌های زیر نحوه ساختاردهی شیء AudienceMember را برای هر نوع داده عضو نشان می‌دهد. هر AudienceMember در یک درخواست باید نوع یکسانی از مجموعه داده شناسه داشته باشد (compositeData، mobileData، یا userIdData):

اطلاعات تماس

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

داده‌های نشانی IP

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

داده‌های تماس و IP

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