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

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

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

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

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

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

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

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

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

Mobile ID (mID)

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

מזהי משתמשים

{
  "userIdData": {
    "userId": "user_987654321"
  }
}