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

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

אלה השלבים להגדרה ולשליחה של הבקשה:

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

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

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

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

    • אם ההעלאה מכילה מזהים של ניידים, צריך להגדיר את mobileData להודעה MobileData. מוסיפים רשומה נפרדת לרשימה mobileIds לכל מזהה נייד של חבר בקהל.

    • אם ההעלאה מכילה מזהי משתמשים, צריך להגדיר את userIdData להודעה UserIdData, ולהגדיר את userId למזהה המשתמש של חבר הקהל.

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