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

สร้างกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้าโดยส่ง 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 ต้องมีรายการเพียง รายการเดียว

contactIdInfo

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

รายการ Mobile ID

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

uploadKeyTypes

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

รายการ uploadKeyTypes ต้องมีรายการเพียง รายการเดียว

mobileIdInfo

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

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

  • ตั้งค่า 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 ต้องมีรายการเพียง รายการเดียว

สร้างคำขอ

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

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

  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"
}

รหัสมือถือ

เปิดในโปรแกรมสำรวจ 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"
}

ส่งคำขอ

ส่งคำขอและใส่ส่วนหัวของคำขอ (หากจำเป็น)

หากคำขอสำเร็จ การตอบกลับจะมี UserList ที่สร้างขึ้นพร้อมข้อมูลใน id และ name โปรดจดค่าในฟิลด์เหล่านี้ไว้ เนื่องจากคุณจะต้องใช้ค่าดังกล่าวในคำขอเพื่อเพิ่มสมาชิกกลุ่มเป้าหมายลงในกลุ่มเป้าหมาย

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

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