สร้างกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้า

สร้างกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าโดยส่ง CreateUserListRequest

สร้างเนื้อหาคำขอ

สร้างทรัพยากร UserList ต่อไปนี้เป็นช่องทั่วไปที่ต้องตั้งค่า

displayName
ต้องระบุ ชื่อที่แสดงของรายการ ชื่อต้องไม่ซ้ำกับรายการทั้งหมดที่บัญชีเป็นเจ้าของ
description
คำอธิบายสั้นๆ ของรายการ
integrationCode
รหัสจากระบบของคุณ
membershipDuration

ระยะเวลาที่สมาชิกในกลุ่มเป้าหมายจะยังคงอยู่ในรายการหลังจากเพิ่มแล้ว ค่าต้องสอดคล้องกับจำนวนวันเต็ม หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ค่าสูงสุดเป็นค่าเริ่มต้น

หากใช้ JSON ให้คำนวณจำนวนวินาทีโดยคูณจำนวนวันด้วย 86400 (จำนวนวินาทีต่อวัน) จากนั้นตั้งค่าเป็นผลลัพธ์ของการคูณ ตามด้วย s ตัวอย่างเช่น หากต้องการให้ระยะเวลาการเป็นสมาชิกเท่ากับ 90 วัน ให้ใช้ค่า 7776000s เนื่องจาก 90 * 86400 = 7776000

หากใช้รูปแบบบัฟเฟอร์โปรโตคอล ให้ใช้วิธีที่สะดวกในการสร้างออบเจ็กต์ Duration ตามจำนวนวัน หากมีวิธีที่สะดวกดังกล่าว ตัวอย่างเช่น ไลบรารี protobuf-java-util สำหรับ Java มีเมธอดอำนวยความสะดวก fromDays() มิฉะนั้น ให้คำนวณจำนวนวินาทีโดยคูณจำนวนวันของระยะเวลาด้วย 86400 (จำนวนวินาทีต่อวัน) และใช้ผลลัพธ์เพื่อตั้งค่าช่อง seconds ของออบเจ็กต์ Duration

ช่องที่ต้องกรอกสำหรับการจับคู่ข้อมูลลูกค้า

ต้องระบุช่อง ingestedUserListInfo สำหรับกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้า

ช่องที่ต้องตั้งค่าใน IngestedUserListInfo จะขึ้นอยู่กับประเภทข้อมูลที่คุณต้องการใช้เพื่อเพิ่มสมาชิกลงในรายการกลุ่มเป้าหมาย

ข้อมูลรายชื่อติดต่อ

ตั้งค่าช่องต่อไปนี้หากต้องการใช้ข้อมูลติดต่อ (อีเมล หมายเลขโทรศัพท์ หรือที่อยู่ที่แฮช) เพื่อกำหนดสมาชิกในกลุ่มเป้าหมาย

uploadKeyTypes

ตั้งค่าเป็นรายการที่มีประเภทคีย์การอัปโหลด CONTACT_ID

รายการ uploadKeyTypes ต้องมีเพียง 1 รายการเท่านั้น

contactIdInfo

ตั้งค่าเป็นข้อความ ContactIdInfo โดยตั้งค่า dataSourceType เป็นค่าที่เหมาะสมจาก enum DataSourceType

รายการ Mobile ID

ตั้งค่าช่องต่อไปนี้หากต้องการใช้ Mobile ID เพื่อกำหนดสมาชิกในกลุ่มเป้าหมาย

uploadKeyTypes

ตั้งค่าเป็นรายการที่มีประเภทคีย์การอัปโหลด MOBILE_ID

รายการ uploadKeyTypes ต้องมีเพียง 1 รายการเท่านั้น

mobileIdInfo

ตั้งค่าเป็นข้อความ MobileIdInfo:

  • ตั้งค่า dataSourceType เป็นค่าที่เหมาะสมจาก enum DataSourceType

  • ตั้งค่า keySpace เป็น IOS หรือ ANDROID

  • ตั้งค่า appId เป็นสตริงที่ระบุแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ซึ่งเป็นแหล่งที่มาของข้อมูลที่รวบรวมไว้อย่างไม่ซ้ำกัน

    • สำหรับ iOS สตริงรหัสคือสตริง 9 หลักที่ปรากฏที่ส่วนท้ายของ URL ของ App Store ตัวอย่างเช่น 476943146 สำหรับแอป "Flood-It!" ที่มีลิงก์ App Store เป็น https://apps.apple.com/us/app/flood-it/id476943146

    • สำหรับ Android สตริงรหัสคือชื่อแพ็กเกจของแอปพลิเคชัน เช่น com.labpixies.flood สำหรับแอป "Flood-It!" ที่มีลิงก์ Google Play เป็น https://play.google.com/store/apps/details?id=com.labpixies.flood

รายการรหัสผู้ใช้

ตั้งค่าช่องต่อไปนี้หากต้องการใช้รหัสผู้ใช้เพื่อกำหนดสมาชิกในกลุ่มเป้าหมาย

uploadKeyTypes

ตั้งค่าเป็นรายการที่มีประเภทคีย์การอัปโหลด USER_ID

รายการ uploadKeyTypes ต้องมีเพียง 1 รายการเท่านั้น

สร้างคำขอ

หากต้องการสร้างกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้า ให้สร้างคำขอ create สำหรับทรัพยากร UserList

  1. ตั้งค่าช่อง parent เป็นชื่อทรัพยากรของบัญชี ชื่อทรัพยากรต้องเป็นไปตามรูปแบบ accountTypes/{accountType}/accounts/{account}

  2. ใช้ UserList ที่คุณสร้างขึ้นสำหรับเนื้อหาของคำขอ

  3. หากข้อมูลเข้าสู่ระบบของคุณไม่ใช่ของบัญชี Google ที่เป็นผู้ใช้ใน parent ให้ตั้งค่าส่วนหัวตามที่อธิบายไว้ในหัวข้อกำหนดค่าปลายทางและส่วนหัว

ต่อไปนี้คือตัวอย่างคำขอใน JSON สำหรับข้อมูลผู้ใช้ประเภทต่างๆ คำขอแต่ละรายการจะตั้งค่า membershipDuration เป็น 2592000s โดยที่ 2592000 คือจำนวนวินาทีใน 30 วัน คลิกปุ่มเปิดในโปรแกรมสำรวจ API เพื่อลองส่งคำขอ

ข้อมูลติดต่อ

เปิดในโปรแกรมสำรวจ API 
{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Mobile ID

เปิดในโปรแกรมสำรวจ API 
{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

รหัสผู้ใช้

เปิดในโปรแกรมสำรวจ API 
{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

ส่งคำขอ

ส่งคำขอและระบุส่วนหัวของคำขอ เช่น login-account หรือ linked-account หากจำเป็น

หากคำขอสำเร็จ การตอบกลับจะมี UserList ที่สร้างขึ้นพร้อมกับช่อง id และ name แบบเอาต์พุตเท่านั้น

หากคำขอล้มเหลว ให้ตรวจสอบข้อผิดพลาดเพื่อหาสาเหตุของความล้มเหลว อัปเดตคำขอและส่วนหัวเพื่อแก้ไขปัญหา แล้วส่งคำขอและส่วนหัวที่อัปเดตแล้ว

ก่อนหน้า
ภาพรวม
ถัดไป
อัปโหลดสมาชิกไปยังกลุ่มเป้าหมาย