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

คุณสร้างกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าได้โดยใช้ข้อมูลติดต่อของลูกค้าที่อัปโหลด ข้อมูลหรือรหัสอุปกรณ์เคลื่อนที่ที่ใช้ Display & API ของวิดีโอ 360 หน้านี้อธิบายวิธีการ เพื่อสร้างกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าเริ่มต้น และเพิ่มข้อมูลลูกค้าใหม่ในส่วน กลุ่มเป้าหมายที่มีอยู่โดยใช้เครือข่ายดิสเพลย์และ API ของวิดีโอ 360

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

จัดเตรียมข้อมูลผู้ใช้

ข้อมูลผู้ใช้ที่ใช้ป้อนข้อมูลกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้ามีความละเอียดอ่อนและจําเป็นต้องมี อย่างเหมาะสมก่อนอัปโหลด

ข้อมูลที่ละเอียดอ่อนของแฮช

กลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าบางรายการสร้างขึ้นโดยใช้ข้อมูลติดต่อของลูกค้าที่มีความละเอียดอ่อน ดิสเพลย์และ Video 360 กำหนดให้มีการแฮชข้อมูลที่ละเอียดอ่อนโดยใช้ อัลกอริทึม SHA256 ก่อนที่จะอัปโหลด ต้องแฮชช่องข้อมูลต่อไปนี้ ก่อนอัปโหลด

ชื่อ
นามสกุล
อีเมล
หมายเลขโทรศัพท์

ไม่ควรแฮชรหัสไปรษณีย์และรหัสประเทศก่อนอัปโหลด กำลังพยายาม เกิดข้อผิดพลาดในการอัปโหลดข้อมูลลูกค้าที่ไม่ได้แฮช

ก่อนแฮชข้อมูล โปรดตรวจสอบเงื่อนไขต่อไปนี้

ต้องนำช่องว่างออกจากชื่อ นามสกุล และอีเมล
ค่าทั้งหมดต้องเป็นตัวพิมพ์เล็ก
หมายเลขโทรศัพท์ทั้งหมดต้องอยู่ในรูปแบบที่ใช้รูปแบบ E.164 และ ใส่รหัสประเทศในการโทร

ตั้งค่าความยินยอมของผู้ใช้

เมื่ออัปโหลดข้อมูลผู้ใช้ ให้ใช้ช่อง consent ใน ContactInfoList หรือ MobileDeviceIdList ออบเจ็กต์เพื่อส่งสัญญาณความยินยอม ที่ได้รับจากผู้ใช้ที่รวมอยู่

กำลังตั้งค่าช่องใดช่องหนึ่งในออบเจ็กต์ Consent เป็น CONSENT_STATUS_DENIED ทำให้เกิดข้อผิดพลาด

ระบบตั้งค่าสัญญาณความยินยอมสําหรับผู้ใช้ทั้งหมดที่เพิ่มในรายการเดียวแล้ว firstAndThirdPartyAudiences.create หรือ firstAndThirdPartyAudiences.editCustomerMatchMembers อีกครั้ง ต้องอัปโหลดผู้ใช้ที่มีสัญญาณความยินยอมที่แตกต่างกันแยกกัน คำขอ

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

สามารถสร้างกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าได้โดยใช้ firstAndThirdPartyAudiences.create กลุ่มเป้าหมายต้อง ได้รับการประกาศเป็นกลุ่มเป้าหมายบุคคลที่หนึ่งและต้องมี audienceType จาก CUSTOMER_MATCH_CONTACT_INFO หรือ CUSTOMER_MATCH_DEVICE_ID ข้อมูลการจับคู่ข้อมูลลูกค้าต้องเป็น ที่ระบุโดยใช้ฟิลด์ที่เหมาะสมภายในฟิลด์สหภาพ members

ต่อไปนี้เป็นตัวอย่างวิธีการสร้างการจับคู่ข้อมูลลูกค้าสำหรับข้อมูลติดต่อใหม่ ผู้ชมที่มีระยะเวลาการเป็นสมาชิกไม่จำกัดโดยใช้รายการที่มีการแฮชที่มีให้ หมายเลขโทรศัพท์:

Java

// Create Customer Match audience object.
FirstAndThirdPartyAudience customerMatchAudience =
    new FirstAndThirdPartyAudience()
        .setDisplayName(display-name)
        .setFirstAndThirdPartyAudienceType(
            "FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY"
        )
        .setAudienceType("CUSTOMER_MATCH_CONTACT_INFO")
        .setMembershipDurationDays(10000L);

// Build list of contact information objects.
ContactInfoList contactInfoList = new ContactInfoList();
ArrayList<ContactInfo> contactInfos = new ArrayList<ContactInfo>();
for (String hashedPhoneNumber : list-of-hashed-phone-numbers) {
  ContactInfo contactInfo = new ContactInfo();
  ArrayList<String> phoneNumberList = new ArrayList<String>();
  phoneNumberList.add(hashedPhoneNumber);
  contactInfo.setHashedPhoneNumbers(phoneNumberList);
  contactInfos.add(contactInfo);
}
contactInfoList.setContactInfos(contactInfos);

// Build consent object for passing consent if granted by the end user.
Consent consent =
    new Consent()
        .setAdUserData(ad-user-data-consent)
        .setAdPersonalization(ad-personalization-consent);
ContactInfoList.setConsent(consent);

// Assign contact info list to Customer Match audience.
customerMatchAudience.setContactInfoList(contactInfoList);

// Create Customer Match audience.
FirstAndThirdPartyAudience response =
    service
        .firstAndThirdPartyAudiences()
        .create(customerMatchAudience)
        .setAdvertiserId(advertiser-id)
        .execute();

// Display name of new audience.
System.out.printf(
    "Customer Match audience %s was created.",
    response.getName()
);

Python

# Build list of Contact Info objects
contact_infos = []
for hashed_phone_number in list-of-hashed-phone-numbers:
  contact_infos.append({'hashedPhoneNumbers': [hashed_phone_number]})

# Create a Customer Match first- and third-party audience object.
audience_obj = {
    'displayName': display-name,
    'firstAndThirdPartyAudienceType':
        'FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY',
    'audienceType': 'CUSTOMER_MATCH_CONTACT_INFO',
    'membershipDurationDays': 10000,
    'contactInfoList': {
        'contactInfos': [
            contact_infos
        ],
        'consent': {
            'adUserData': ad-user-data-consent,
            'adPersonalization': ad-personalization-consent
        }
    }
}

# Build and execute request.
audience = service.firstAndThirdPartyAudiences().create(
    advertiserId=advertiser-id,
    body=audience_obj
).execute()

# Display name of new audience.
print('Customer Match audience %s was created.' % audience["name"])

PHP

// Create a Customer Match first- and third-party audience object.
$audience = new Google_Service_DisplayVideo_FirstAndThirdPartyAudience();
$audience->setDisplayName(display-name);
$audience->setFirstAndThirdPartyAudienceType(
    'FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY'
);
$audience->setAudienceType('CUSTOMER_MATCH_CONTACT_INFO');
$audience->setMembershipDurationDays(10000);

// Build list of contact information objects.
$contactInfoList = new Google_Service_DisplayVideo_ContactInfoList();
$contactInfos = array();
foreach (list-of-hashed-phone-numbers as $hashedPhoneNumber) {
    $contactInfo = new Google_Service_DisplayVideo_ContactInfo();
    $contactInfo->setHashedPhoneNumbers(array($hashedPhoneNumber));
    $contactInfos[] = $contactInfo;
}
$contactInfoList->setContactInfos($contactInfos);

// Build consent object for passing consent if granted by the end user.
$consent = new Google_Service_DisplayVideo_Consent();
$consent->setAdUserData(ad-user-data-consent);
$consent->setAdPersonalization(ad-personalization-consent);
$contactInfoList->setConsent($consent);

// Assign contactInfoList to audience object.
$audience->setContactInfoList($contactInfoList);

// Call the API, creating the audience.
$result = $this->service->firstAndThirdPartyAudiences->create(
    $audience,
    array('advertiserId' => advertiser-id)
);

// Display name of new audience.
printf('Customer Match audience %s was created.', $result['name']);

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

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

คำขอ firstAndThirdPartyAudiences.editCustomerMatchMembers สามารถเพิ่มหรือนำสมาชิกออกจากรายการได้เท่านั้น มีคำขอเดียวที่พยายาม ให้ทำทั้ง 2 อย่างจะทำให้เกิดข้อผิดพลาด INVALID_ARGUMENT

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

Java

// Create an edit members request object.
EditCustomerMatchMembersRequest editCustomerMatchMembersRequest =
    new EditCustomerMatchMembersRequest()
        .setAdvertiserId(advertiser-id);

// Build contact information object to add to audience.
ContactInfoList contactInfoList = new ContactInfoList();
ArrayList<ContactInfo> contactInfos = new ArrayList<ContactInfo>();
ContactInfo contactInfo =
    new ContactInfo()
        .setHashedFirstName(hashed-customer-first-name)
        .setHashedLastName(hashed-customer-last-name)
        .setZipCodes(customer-zip-codes-list)
        .setCountryCode(customer-country-code);
contactInfos.add(contactInfo);
contactInfoList.setContactInfos(contactInfos);

// Build consent object for passing consent if granted by the end user.
Consent consent =
    new Consent()
        .setAdUserData(ad-user-data-consent)
        .setAdPersonalization(ad-personalization-consent);
ContactInfoList.setConsent(consent);

// Assign contact info list to request body.
editCustomerMatchMembersRequest.setAddedContactInfoList(contactInfoList);

// Edit Customer Match audience membership.
EditCustomerMatchMembersResponse response =
    service
        .firstAndThirdPartyAudiences()
        .editCustomerMatchMembers(
            audience-id,
            editCustomerMatchMembersRequest
        )
        .execute();

// Display ID of updated audience.
System.out.printf(
    "The membership of Customer Match audience ID %s was edited.",
    response.getFirstAndThirdPartyAudienceId()
);

Python

# Create an edit members request object.
edit_member_request_obj = {
    'advertiserId': advertiser-id,
    'addedContactInfoList': {
        'contactInfos': [
            {
                'hashedFirstName': hashed-customer-first-name,
                'hashedLastName': hashed-customer-last-name,
                'countryCode': customer-country-code,
                'zipCodes': customer-zip-codes-list
            }
        ],
        'consent': {
          'adUserData': ad-user-data-consent,
          'adPersonalization': ad-personalization-consent
        }
    }
}

# Build and execute request.
response = service.firstAndThirdPartyAudiences().editCustomerMatchMembers(
    firstAndThirdPartyAudienceId=audience-id,
    body=edit_member_request_obj
).execute()

# Display ID of updated audience.
print('The membership of the Customer Match audience ID %s was updated.'
      % response["firstAndThirdPartyAudienceId"])

PHP

// Create an edit members request object.
$editMemberRequest =
    new Google_Service_DisplayVideo_EditCustomerMatchMembersRequest();
$editMemberRequest->setAdvertiserId(advertiser-id);

// Build contact information object to add to audience.
$contactInfoList = new Google_Service_DisplayVideo_ContactInfoList();
$contactInfos = array();
$contactInfo = new Google_Service_DisplayVideo_ContactInfo();
$contactInfo->setHashedFirstName(hashed-customer-first-name);
$contactInfo->setHashedLastName(hashed-customer-last-name);
$contactInfo->setCountryCode(customer-country-code);
$contactInfo->setZipCodes(array(customer-zip-codes-list));
$contactInfos[] = $contactInfo;
$contactInfoList->setContactInfos($contactInfos);

// Build consent object for passing consent if granted by the end user.
$consent = new Google_Service_DisplayVideo_Consent();
$consent->setAdUserData(ad-user-data-consent);
$consent->setAdPersonalization(ad-personalization-consent);
$contactInfoList->setConsent($consent);

// Assign contactInfoList to edit members request body.
$editMemberRequest->setAddedContactInfoList($contactInfoList);

// Call the API, editing the audience membership.
$response = $this
    ->service
    ->firstAndThirdPartyAudiences
    ->editCustomerMatchMembers(
        audience-id,
        $editMemberRequest
    );

// Display ID of updated audience.
printf(
    'The membership of Customer Match audience ID %s was edited',
    $result['firstAndThirdPartyAudienceId']
);

กำหนดเป้าหมายผู้ชม