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

כדי להעלות חברים לקהל מסוג 'התאמה ללקוחות', שולחים 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"
  }
}