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