כדי להעלות חברים לקהל מסוג "התאמה ללקוחות", שולחים בקשת IngestAudienceMembersRequest.
כדי להגדיר ולשלוח את הבקשה, מבצעים את השלבים הבאים:
מגדירים את השדה
termsOfServiceלהודעה מסוגTermsOfService, כשהשדהcustomerMatchTermsOfServiceStatusמוגדר לערךACCEPTED, כדי לאשר שהחשבוןoperatingAccountאישר את התנאים וההגבלות של התאמה ללקוחות.בכל
AudienceMemberברשימהaudienceMembers, מגדירים את שדה הנתונים בהתאם לסוג הנתונים שההעלאה מכילה:אם ההעלאה מכילה פרטים ליצירת קשר, מגדירים את השדה
compositeDataלאובייקטCompositeData, ומגדירים את השדהuserDataשלו לאובייקטUserData. מוסיפים לרשימהuserIdentifiersרשומה נפרדת לכל מזהה של משתמש מקהל היעד.עדיין יש תמיכה ב-
userData, אבל מומלץ להשתמש ב-compositeDataכדי לוודא שהשילוב מוכן לשיפורים עתידיים. פרטים נוספים זמינים במאמר נתונים מורכבים.אם ההעלאה מכילה מזהי Mobile ID, צריך להגדיר את השדה
mobileDataלהודעה מסוגMobileData. מוסיפים לרשימהmobileIdsרשומה נפרדת לכל Mobile ID (mID) של משתמש מקהל היעד.
שולחים את נתוני ההתאמה ללקוחות לפי השלבים שמפורטים בקטע שליחת משתמשים מקהל היעד.
משתמשים לדוגמה מקהל היעד
בדוגמאות הבאות מוסבר איך ליצור אובייקט AudienceMember לכל סוג של נתוני חברים. לכל AudienceMember בבקשה אחת חייב להיות אותו סוג של נתוני מזהה (compositeData, mobileData):
פרטים ליצירת קשר
{
"compositeData": {
"userData": {
"userIdentifiers": [
{
"emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
},
{
"phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
}
]
}
}
}
Mobile ID (mID)
{
"mobileData": {
"mobileIds": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
}