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

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

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

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

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

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

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

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

3. שולחים את נתוני ההתאמה ללקוחות לפי השלבים שמפורטים בקטע שליחת משתמשים מקהל היעד.

משתמשים לדוגמה מקהל היעד

בדוגמאות הבאות מוסבר איך ליצור אובייקט AudienceMember לכל סוג של נתוני חברים. כל AudienceMember בבקשה אחת חייב להיות עם אותו סוג של נתוני מזהה (compositeData, ‏ mobileData):

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

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