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

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

สร้างคําขอ

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

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

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

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

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

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

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

ส่งคําขอ

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

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

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