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

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

รายการ 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

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

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

uploadKeyTypes

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

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

สร้างคำขอ

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

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

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

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

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

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

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

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

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