Suba públicos de Segmentación por clientes

Puedes crear públicos de Segmentación por clientes con la información de contacto del cliente que subiste o los IDs de dispositivos móviles con la API de Display & Video 360. En esta página, se describe cómo crear un público inicial de Segmentación por clientes y agregar datos de clientes nuevos al público existente con la API de Display & Video 360.

Advertencia: Para verificar que se hayan aprobado las funciones de carga de datos para el socio superior del público propuesto, primero intenta crear un público de Segmentación por clientes en un anunciante relevante en la IU. Si no se habilitó la carga de datos, los intentos de crear o actualizar públicos de Segmentación por clientes mostrarán un error. Los usuarios con acceso a nivel de socio pueden solicitar la aprobación mediante este formulario de solicitud de acceso de socios.

Prepara los datos del usuario

Los datos del usuario que se usan para propagar los públicos de Segmentación por clientes son sensibles y deben prepararse correctamente antes de subirse.

Cómo codificar datos sensibles

Algunos públicos de Segmentación por clientes se crean con información de contacto sensible de los clientes. Display & Video 360 requiere que los datos sensibles se codifiquen con el algoritmo SHA256 antes de subirlos. Los siguientes campos de datos deben tener un hash antes de la carga:

• Nombre
• Apellido
• Direcciones de correo electrónico
• Números de teléfono

Los códigos postales y los códigos de país no deben contener codificación hash antes de la carga. Si intentas subir datos de clientes sin hash, se generará un error.

Antes de generar un hash de los datos, asegúrate de que se cumplan las siguientes condiciones:

• Se deben quitar los espacios en blanco de los valores de nombre, apellido y dirección de correo electrónico.
• Todos los valores deben estar en minúsculas.
• Todos los números de teléfono deben tener el formato E.164 y deben incluir el código de país.

Configura el consentimiento del usuario

Cuando subas datos del usuario, usa los campos consent en los objetos ContactInfoList o MobileDeviceIdList proporcionados para pasar los indicadores de consentimiento otorgados por los usuarios incluidos.

Si configuras cualquiera de los campos del objeto Consent en CONSENT_STATUS_DENIED, se produce un error.

Advertencia: Debes enviar indicadores de consentimiento cuando subas miembros del público de la Segmentación por clientes del Espacio Económico Europeo (EEE) para cumplir con la Política de Consentimiento de Usuarios de la UE y usar los datos de los usuarios del EEE para propagar los públicos de la Segmentación por clientes.

Los indicadores de consentimiento se establecen para todos los usuarios que se agregan en una sola solicitud de firstAndThirdPartyAudiences.create o firstAndThirdPartyAudiences.editCustomerMatchMembers. Los usuarios con diferentes indicadores de consentimiento se deben subir en solicitudes separadas.

Cómo crear un público de Segmentación por clientes

Puedes crear un público de Segmentación por clientes con el método firstAndThirdPartyAudiences.create. El público debe declararse como público propio y debe tener un audienceType de CUSTOMER_MATCH_CONTACT_INFO o CUSTOMER_MATCH_DEVICE_ID. Los datos de la Segmentación por clientes deben proporcionarse con el campo adecuado dentro del campo de unión members.

Nota: El campo membershipDurationDays es obligatorio cuando se crean públicos de Segmentación por clientes. Las membresías individuales vencerán después de la duración si no se vuelven a subir al público con firstAndThirdPartyAudiences.editCustomerMatchMembers.

A continuación, se muestra un ejemplo de cómo crear un nuevo público de Segmentación por clientes basada en la información de contacto con una duración de membresía de 540 días usando una lista proporcionada de números de teléfono con codificación hash:

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(540L);

// 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': 540,
    '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(540);

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

Actualiza la membresía de un público de Segmentación por clientes

Si identificaste clientes adicionales para segmentar tus anuncios, necesitas renovar las membresías existentes de los clientes en el público o quieres quitar clientes de un público, puedes actualizar los datos de clientes de un público de Segmentación por clientes existente con el método firstAndThirdPartyAudiences.editCustomerMatchMembers. Puedes agregar clientes a una lista con el campo de unión added_members y quitar clientes de una lista con el campo de unión removed_members.

Una sola solicitud de firstAndThirdPartyAudiences.editCustomerMatchMembers solo puede agregar o quitar miembros de una lista. Una sola solicitud que intente hacer ambas acciones genera un error INVALID_ARGUMENT.

Nota: Los campos de metadatos de los públicos de Segmentación por clientes por ID de dispositivo y de información de contacto, como displayName o membershipDurationDays, se pueden actualizar con el método firstAndThirdPartyAudiences.patch.

Este es un ejemplo de cómo agregar un solo cliente como miembro a un público de Segmentación por clientes de información de contacto existente con los datos de la dirección de correo proporcionada:

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