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

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

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

สร้างUserList ทรัพยากร ช่องที่พบบ่อยซึ่งต้องตั้งค่ามีดังนี้

displayName

ต้องระบุ ชื่อที่แสดงของรายการ ชื่อต้องไม่ซ้ำกันในรายการทั้งหมด ของบัญชี

description

คำอธิบายรายการโดยย่อ

integrationCode

รหัสจากระบบ

membershipDuration

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

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

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

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

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

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

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

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

uploadKeyTypes

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

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

contactIdInfo

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

รายการรหัสมือถือ

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

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

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

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

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 Explorer

{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

รหัสมือถือ

เปิดใน API Explorer

{
    "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 Explorer

{
    "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 ที่สร้างขึ้น จดค่าในช่องเหล่านี้ไว้เนื่องจากคุณจะต้องใช้ค่าดังกล่าวในคำขอเพื่อเพิ่มสมาชิกกลุ่มเป้าหมาย ลงในกลุ่มเป้าหมาย

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