Fazer upload de públicos-alvo segmentados por lista de clientes

Você pode criar públicos-alvo segmentados por lista de clientes usando os dados de contato do cliente enviados. ou IDs de dispositivos móveis usando as APIs Display & API Video 360. Nesta página, descrevemos como para criar um público-alvo segmentado por lista de clientes e anexar novos dados de clientes ao público-alvo atual usando as campanhas API Video 360.

Aviso :verifique se os recursos de upload de dados foram aprovados para a o principal parceiro do público-alvo ao tentar criar um público-alvo segmentado por lista de clientes em um anunciante relevante na interface. Se o upload de dados não estiver ativado, tentar criar ou atualizar públicos-alvo segmentados por lista de clientes retornará um erro. Os usuários com acesso no nível do parceiro podem solicitar aprovação usando este Formulário de solicitação de acesso a parceiros.

Preparar dados do usuário

Os dados do usuário usados para preencher os públicos-alvo segmentados por lista de clientes são sensíveis e precisam ser preparados corretamente antes de serem enviados.

Gerar hash de dados sensíveis

Alguns públicos-alvo segmentados por lista de clientes são criados usando contatos sensíveis de clientes informações imprecisas ou inadequadas. Rede de Display e O Video 360 exige que os dados sensíveis sejam criptografados com hash usando o o algoritmo SHA256 antes do upload. Os campos de dados a seguir precisam ser criptografados com hash antes do upload:

• Nome
• Sobrenome
• Endereços de e-mail
• Números de telefone

Os códigos postais e de países não devem ser criptografados com hash antes do upload. Tentando o upload de dados do cliente sem hash resulta em erro.

Antes de gerar hash dos dados, verifique estas condições:

• Remova todos os espaços em branco do nome, sobrenome e endereço de e-mail e a distribuição dos valores dos dados.
• Todos os valores precisam estar em letras minúsculas.
• Todos os números de telefone precisam estar no formato E.164 e incluir o código de chamada do país.

Definir o consentimento do usuário

Ao fazer o upload de dados do usuário, use os campos consent nos ContactInfoList ou Objetos MobileDeviceIdList para transmitir indicadores de consentimento concedidas pelos usuários incluídos.

Definir um dos campos no objeto Consent como CONSENT_STATUS_DENIED resulta em erro.

Aviso :é necessário enviar indicadores de consentimento ao fazer o upload do Espaço Econômico Europeu Os membros do público-alvo segmentado por lista de clientes (EEE) precisam obedecer ao consentimento de usuários da UE e use dados de usuários do EEE para preencher públicos-alvo segmentados por lista de clientes.

Os indicadores de consentimento são definidos para todos os usuários adicionados em uma única firstAndThirdPartyAudiences.create ou firstAndThirdPartyAudiences.editCustomerMatchMembers solicitação. O upload de usuários com indicadores de consentimento diferentes precisa ser feito separadamente solicitações.

Criar um público-alvo segmentado por lista de clientes

Para criar um público-alvo segmentado por lista de clientes, método firstAndThirdPartyAudiences.create. O público-alvo precisa ser declarado como público-alvo primário e ter audienceType de CUSTOMER_MATCH_CONTACT_INFO ou CUSTOMER_MATCH_DEVICE_ID. Os dados da Segmentação por lista de clientes precisam ser fornecido usando o campo apropriado no campo union members

Observação: o campo membershipDurationDays é para criar públicos-alvo segmentados por lista de clientes. Assinatura ilimitada pode ser ativada definindo o valor do campo como 10000.

Veja um exemplo de como criar novos dados de contato para a Segmentação por lista de clientes público-alvo com duração de associação ilimitada usando uma lista fornecida de públicos-alvo com hash Números de telefone:

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']);

Atualizar a associação de um público-alvo segmentado por lista de clientes

Se você identificou outros clientes que gostaria de segmentar, é necessário renovar os clientes associações de públicos-alvo atuais ou remover clientes de um público-alvo, atualize os dados de um cliente atual Corresponder o público-alvo às firstAndThirdPartyAudiences.editCustomerMatchMembers . Você pode adicionar clientes a uma lista usando o added_members de união e remover clientes de um lista com o campo de união removed_members.

Um único firstAndThirdPartyAudiences.editCustomerMatchMembers solicitação só pode adicionar ou remover membros de uma lista. Uma única solicitação tenta para fazer os dois resulta em um erro INVALID_ARGUMENT.

Observação :campos de metadados de dados de contato e Segmentação por lista de clientes de ID do dispositivo públicos-alvo, como displayName ou membershipDurationDays, podem ser atualizadas usando o método firstAndThirdPartyAudiences.patch.

Este é um exemplo de como adicionar um único cliente como membro a uma dados de contato do público-alvo segmentado por lista de clientes usando os dados de endereço de correspondência fornecidos:

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']
);