API ของคู่ค้า
ข้อมูลอ้างอิง API

ตัวเลือกที่ 2: ซิงค์ลูกค้าและกลุ่มเป้าหมาย

ภาพรวม

ผู้ค้าปลีกที่มีห้องข้อมูลที่ปลอดภัยหรือเซ็กเมนต์กลุ่มเป้าหมายที่จัดการด้วยตนเองสามารถซิงโครไนซ์ข้อมูลลูกค้าและเซ็กเมนต์เพื่อให้สามารถจัดส่งกลุ่มเป้าหมายที่กำหนดเองสำหรับผู้ลงโฆษณาชั้นนำและกลุ่มกลุ่มเป้าหมายทั่วไปได้อย่างเป็นทางการ การผสานรวมนี้เกี่ยวข้องกับการใช้ CDP ของคุณเพื่อจัดหาข้อมูลลูกค้า/เซ็กเมนต์ให้กับ Epsilon ไม่ว่าจะโดย API หรือไฟล์

ข้อกําหนดการผสานการทํางาน

  • การรวมมาตรฐานในสถานที่จะต้องรวมรหัสลูกค้าในทุกจุดสัมผัสที่เกี่ยวข้อง (หากมีอยู่)
  • ฟีดรหัสลูกค้าสำหรับลูกค้า โดยใช้ API หรือฟีดไฟล์
  • แบ่งเซ็กเมนต์ฟีดตาม API หรือฟีดไฟล์

วิธีการทํางาน

CDP หรือแพลตฟอร์มกลุ่มเป้าหมายจัดหาข้อมูลลูกค้าและกลุ่มเป้าหมายให้กับ Epsilon โดยใช้การอัปโหลดไฟล์หรือ API รหัสลูกค้าที่รวมอยู่ในคำขอโฆษณาจะถูกจับคู่กับเซ็กเมนต์กลุ่มเป้าหมายและแคมเปญที่เกี่ยวข้อง สิ่งนี้ช่วยให้สามารถกำหนดเป้าหมายได้อย่างแม่นยำตามคำจำกัดความของกลุ่มเป้าหมายที่กำหนดเองหรือทั่วไป

ตัวอย่างการผสานรวม

ตัวอย่างคำขอโฆษณา: คำขอโฆษณาที่มีรหัสลูกค้า:

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "options": {
        "filterMode": "AndOr"
    },
    "maxNumberOfAds": 3
}

📘

คำขอโฆษณาของคุณต้องมีข้อมูลต่อไปนี้ customerIdไม่ว่าคุณจะผสานรวมผ่านไฟล์หรือ API ก็ตาม

การผสานไฟล์ฟีด (ที่แนะนำ)

เมื่อซิงค์ลูกค้าและเซ็กเมนต์ตามไฟล์ เราต้องการไฟล์สองไฟล์:

  • ไฟล์เซ็กเมนต์
  • ไฟล์ลูกค้า

ไฟล์เซ็กเมนต์

ไฟล์เซ็กเมนต์ใช้เพื่อระบุรหัสเซ็กเมนต์ที่แสดงใน UI ชื่อ และคำอธิบาย นอกจากนี้ยังสามารถใช้เพื่อระบุ team_id เฉพาะที่สามารถดูเซ็กเมนต์ได้ ช่วยให้คุณสามารถจัดเซ็กเมนต์สำหรับผู้ลงโฆษณาเฉพาะได้

segment_idชื่อคำอธิบายteam_ids
general-segment-1นักช้อปที่มีค่าใช้จ่ายสูงผู้ซื้อที่มีปริมาณการซื้อของต่อสัปดาห์โดยเฉลี่ยอยู่ในกลุ่ม 15% สูงสุด
general-segment-2ผู้ซื้อที่ให้ความสำคัญกับคุณค่าผู้ซื้อที่มีสัดส่วนร้อยละของผลิตภัณฑ์ที่มีมูลค่าสูงในตะกร้าสินค้า
general-segment-3ลูกค้าประจำผู้ซื้อที่ซื้อสินค้าทุกสัปดาห์โดยเฉลี่ย
custom-segment-1กำหนดเอง: BrandCo ที่มีการซื้อล่าสุดสูงลูกค้าที่ซื้อ BrandCo ในช่วง 30 วันที่ผ่านมา["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"]

ดูคู่มืออ้างอิงเซ็กเมนต์ ที่นี่

ไฟล์ลูกค้า

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

customer_idเซ็กเมนต์
cust_12345["general-segment-3", "general-segment-4"]
cust_67890["general-segment-3"]

ดูคู่มืออ้างอิงลูกค้า ที่นี่

การรวมการซิงค์ API

เมื่อซิงค์ลูกค้าและเซ็กเมนต์ผ่าน API มีสามการดำเนินการที่จำเป็นต้องทำให้เสร็จสิ้น

  1. สร้างเซ็กเมนต์
  2. ไม่บังคับ: การเข้าถึงเซ็กเมนต์ของผู้จัดการ
  3. สร้างลูกค้า
  4. จัดการการเชื่อมโยงระหว่างเซ็กเมนต์และลูกค้า

การสร้างเซ็กเมนต์ผ่าน API

สิ่งแรกที่คุณควรทําคือสร้างเซ็กเมนต์ของคุณเพื่อเชื่อมโยงลูกค้า

คุณต้องระบุรหัสเซ็กเมนต์ที่แสดงใน UI ชื่อ คําอธิบาย รวมถึงทีมผู้ค้าปลีกของคุณ

📘

สำคัญ: API ของเซ็กเมนต์ใช้การอนุญาตแบบผู้ถือ Partner API ใช้ คุณจะต้องสร้างโทเค็นแบบผู้ถือและใช้งาน เรียนรู้เพิ่มเติม: คำขอการรับรองความถูกต้อง

POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
  "segment":{
        "segmentId": "general-segment-4",
        "sourceId": "DEFAULT_SOURCE_ID",
        "name": "Value Shoppers",
        "description": "Shoppers that have a higher basket % of value driven products.",
        "retailerTeamId": "13c84def-41cb-4f99-a3fc-6788264f79fe"
  }
}

ดูข้อมูลอ้างอิงสำหรับเอนพอยต์สร้างเซ็กเมนต์ ที่นี่

ไม่บังคับ: จัดการการเข้าถึงเซ็กเมนต์

คุณสามารถใช้ฟังก์ชันจัดการสิทธิ์การเข้าถึงเพื่อมอบสิทธิ์การเข้าถึงให้กับผู้ลงโฆษณาที่เลือกไว้เพื่อดูเซ็กเมนต์ ซึ่งจะช่วยให้คุณสามารถสร้างเซ็กเมนต์สำหรับผู้ลงโฆษณาเฉพาะรายได้

POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
  "accessTeamIds":[
        "90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
        ]
}

ดูการอ้างอิงสำหรับการจัดการการเข้าถึงเอนพอยต์เซ็กเมนต์เฉพาะ ที่นี่

การสร้างลูกค้าผ่าน API

📘

API ลูกค้าใช้การให้สิทธิ์พื้นฐานที่ Integration API ใช้

POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customers": [
        {
            "id": "cust_12345"
        },
        {
            "id": "cust_67890"
        }
        }
    ]
}

เมื่อเสร็จสิ้นแล้ว คุณจำเป็นต้องสร้างเซ็กเมนต์เพื่อเชื่อมโยงลูกค้า คุณสามารถสร้างลูกค้าได้สูงสุด 100 รายต่อคำขอ

ดูข้อมูลจำเพาะสำหรับ API เพื่อสร้างหรืออัปเดตลูกค้า ที่นี่

เชื่อมโยงลูกค้ากับเซ็กเมนต์ผ่าน API

หลังจากสร้างเซ็กเมนต์แล้ว ให้ใช้ API /customers/manage-segments เพื่อเชื่อมโยงลูกค้ากับเซ็กเมนต์

POST $BASE_URL/v1/customers/manage-segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "cust_12345",
    "teamId":"13c84def-41cb-4f99-a3fc-6788264f79fe",
    "segments": {
        "segmentIds":[
        "general-segment-4","general-segment-3"
        ]
    }
}

📘

teamId ในคำขอนี้คือรหัสทีมผู้ค้าปลีกของคุณ

ดูข้อมูลจำเพาะสำหรับ API เพื่อจัดการเซ็กเมนต์และลูกค้า ที่นี่