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

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

Mobile ID (mID)

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