העלאת חברים לקהל

כדי להעלות חברים לקהל מסוג "התאמה ללקוחות", שולחים בקשת IngestAudienceMembersRequest.

כדי להגדיר ולשלוח את הבקשה, מבצעים את השלבים הבאים:

1. מגדירים את השדה termsOfService להודעה מסוג TermsOfService, כשהשדה customerMatchTermsOfServiceStatus מוגדר לערך ACCEPTED, כדי לאשר שהחשבון operatingAccount אישר את התנאים וההגבלות של ההתאמה ללקוחות.

2. בכל AudienceMember ברשימה audienceMembers, מגדירים את שדה הנתונים לפי סוג הנתונים שההעלאה מכילה:

   • אם ההעלאה מכילה פרטים ליצירת קשר, נתונים של כתובות IP או את שניהם, מגדירים את השדה compositeData לאובייקט CompositeData. כדי להוסיף פרטים ליצירת קשר, מגדירים את השדה userData כאובייקט UserData ומוסיפים רשומה נפרדת ברשימה userIdentifiers לכל מזהה של המשתמש מקהל היעד. כדי להוסיף נתונים של כתובות IP, מוסיפים רשומת IpData ברשימה ipData לכל כתובת IP של משתמש מקהל היעד.

     למרות שעדיין יש תמיכה ב-userData, מומלץ להשתמש ב-compositeData כדי לוודא שהשילוב שלכם מוכן לשיפורים עתידיים. פרטים נוספים זמינים במאמר נתונים מורכבים.

   • אם ההעלאה מכילה Mobile ID (mID), מגדירים את השדה mobileData להודעה מסוג MobileData. מוסיפים לרשימה mobileIds רשומה נפרדת לכל Mobile ID (mID) של משתמש מקהל היעד.

   • אם ההעלאה מכילה מזהי משתמשים, מגדירים את השדה 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"
  }
}