כדי להעלות חברים לקהל מסוג 'התאמה ללקוחות', שולחים IngestAudienceMembersRequest.
אלה השלבים להגדרה ולשליחה של הבקשה:
מגדירים את
termsOfServiceלערךTermsOfServicemessage עםcustomerMatchTermsOfServiceStatusשמוגדר לערךACCEPTEDכדי לציין שהתנאים וההגבלות של התאמה ללקוחות אושרו ב-operating_account.בכל
AudienceMemberברשימהaudienceMembers, מגדירים את שדה הנתונים על סמך סוג הנתונים שההעלאה מכילה.אם ההעלאה מכילה פרטי איש קשר, צריך להגדיר את השדה
compositeDataכCompositeDataאובייקט, ואת השדהuserDataשלו כאובייקטUserData. מוסיפים רשומה נפרדת ברשימהuserIdentifiersלכל מזהה של חבר בקהל.למרות שעדיין יש תמיכה ב-
userDataמומלץ להשתמש ב-compositeDataכדי לוודא שהשילוב מוכן לשיפורים עתידיים. פרטים נוספים זמינים במאמר בנושא נתונים מורכבים.אם ההעלאה מכילה מזהים של ניידים, צריך להגדיר את
mobileDataלהודעהMobileData. מוסיפים רשומה נפרדת לרשימהmobileIdsלכל מזהה נייד של חבר בקהל.אם ההעלאה מכילה מזהי משתמשים, צריך להגדיר את
userIdDataלהודעהUserIdData, ולהגדיר אתuserIdלמזהה המשתמש של חבר הקהל.
כדי לשלוח נתונים של התאמה ללקוחות, פועלים לפי השלבים שמפורטים במדריך לקהלים.