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

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

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

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

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

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

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

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

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

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

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

اطلاعات تماس

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

شناسه همراه

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