更新用户名单

重要提示： 将目标客户匹配工作流程升级到 Data Manager API，可获享更好的开发者体验并使用更多功能。我们不建议使用 Display & Video 360 API 来实现新的目标客户匹配工作流程。

使用 editCustomerMatchMembers 请求更新现有受众群体中的用户。您可以使用此方法添加新用户或移除现有用户。

提示： 如果用户已在您的受众群体中，添加其数据会续订其会员资格。

以下是使用邮寄地址数据向现有受众群体添加新用户的方法：

Java

// Provide the parent advertiser ID of the audience.
long advertiserId = advertiser-id;

// Provide the ID of the audience to update.
long audienceId = audience-id;

// Provide the signals of consent for the customer.
String adUserDataConsent = ad-user-data-consent;
String adPersonalizationConsent = ad-personalization-consent;

// Provide the hashed first and last names of the customer.
String hashedFirstName = hashed-first-name;
String hashedLastName = hashed-last-name;

// Provide the zip and country code of the customer.
String zipCode = zip-code;
String countryCode = country-code;

// Build list of ContactInfo objects.
List<ContactInfo> contactInfos = new ArrayList<>();
contactInfos.add(
    new ContactInfo()
        .setHashedFirstName(hashedFirstName)
        .setHashedLastName(hashedLastName)
        .setCountryCode(countryCode)
        .setZipCodes(Arrays.asList(zipCode)));

EditCustomerMatchMembersRequest editCustomerMatchMembersRequest =
    new EditCustomerMatchMembersRequest()
        .setAdvertiserId(advertiserId)
        .setAddedContactInfoList(
            new ContactInfoList()
                .setContactInfos(contactInfos)
                .setConsent(
                    new Consent()
                        .setAdUserData(adUserDataConsent)
                        .setAdPersonalization(adPersonalizationConsent)));

// Update the audience membership.
EditCustomerMatchMembersResponse response =
    service
        .firstPartyAndPartnerAudiences()
        .editCustomerMatchMembers(audienceId, editCustomerMatchMembersRequest)
        .execute();

// Display ID of the updated the customer match audience ID.
System.out.printf(
    "Updated the membership of the Customer Match audience with ID %s.",
    response.getFirstPartyAndPartnerAudienceId());

Python

# Provide the parent advertiser ID of the audience.
advertiser_id = advertiser-id

# Provide the ID of the audience to update.
audience_id = audience-id

# Provide the signals of consent for the customer.
ad_user_data_consent = ad-user-data-consent
ad_personalization_consent = ad-personalization-consent

# Provide the hashed first and last names of the customer.
hashed_first_name = hashed-first-name
hashed_last_name = hashed-last-name

# Provide the zip and country code of the customer.
zip_code = zip-code
country_code = country-code

# Create the edit members object.
edit_members_request_obj = {
    "advertiserId": advertiser_id,
    "addedContactInfoList": {
        "contactInfos": [{
            "hashedFirstName": hashed_first_name,
            "hashedLastName": hashed_last_name,
            "countryCode": country_code,
            "zipCodes": [zip_code],
        }],
        "consent": {
            "adUserData": ad_user_data_consent,
            "adPersonalization": ad_personalization_consent,
        },
    },
}

# Build and execute request.
edit_members_response = (
    service.firstPartyAndPartnerAudiences()
    .editCustomerMatchMembers(
        firstPartyAndPartnerAudienceId=audience_id,
        body=edit_members_request_obj,
    )
    .execute()
)

# Print ID of updated audience.
print(
    f"Updated the membership of the Customer Match audience with ID "
    f'{edit_members_response["firstPartyAndPartnerAudienceId"]}.'
)

PHP

// Provide the parent advertiser ID to create the audience under.
$advertiserId = advertiser-id;

// Provide the ID of the audience to update.
$audienceId = audience-id;

// Provide the signals of consent for the customer.
$adUserDataConsent = ad-user-data-consent;
$adPersonalizationConsent = ad-personalization-consent;

// Provide the hashed first and last names of the customer.
$hashedFirstName = hashed-first-name;
$hashedLastName = hashed-last-name;

// Provide the zip and country code of the customer.
$zipCode = zip-code;
$countryCode = country-code;

// Build the ContactInfo object.
$contactInfos = array();
$contactInfo = new Google_Service_DisplayVideo_ContactInfo();
$contactInfo->setHashedFirstName($hashedFirstName);
$contactInfo->setHashedLastName($hashedLastName);
$contactInfo->setCountryCode($countryCode);
$contactInfo->setZipCodes(array($zipCode));
$contactInfos[] = $contactInfo;

$consent = new Google_Service_DisplayVideo_Consent();
$consent->setAdUserData($adUserDataConsent);
$consent->setAdPersonalization($adPersonalizationConsent);

$contactInfoList = new Google_Service_DisplayVideo_ContactInfoList();
$contactInfoList->setContactInfos($contactInfos);
$contactInfoList->setConsent($consent);

// Build the edit request
$editCustomerMatchAudienceRequest = new Google_Service_DisplayVideo_EditCustomerMatchMembersRequest();
$editCustomerMatchAudienceRequest->setAdvertiserId($advertiserId);
$editCustomerMatchAudienceRequest->setAddedContactInfoList($contactInfoList);

// Call the API, updating the audience.
try {
    $result = $this->service->firstPartyAndPartnerAudiences->editCustomerMatchMembers($audienceId,$editCustomerMatchAudienceRequest);
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Print the ID of the updated audience.
printf(
    '<p>The membership of Customer Match audience %s was updated.</p>',
    $result['firstPartyAndPartnerAudienceId']);