Importer des audiences de ciblage par liste de clients

Vous pouvez créer des audiences de ciblage par liste de clients à l'aide des coordonnées des clients ou des ID d'appareils mobiles importés à l'aide de l'API Display & Video 360. Cette page décrit comment créer une audience de ciblage par liste de clients initiale et ajouter de nouvelles données client à l'audience existante à l'aide de l'API Display & Video 360.

Avertissement : Assurez-vous que votre partenaire respecte les exigences concernant l'utilisation des importations de données pour le ciblage par liste de clients, comme indiqué dans notre règlement. Si votre partenaire ne répond pas aux exigences, toute tentative de création ou de mise à jour d'audiences de ciblage des clients générera une erreur.

Préparer les données utilisateur

Les données utilisateur utilisées pour remplir les audiences de ciblage par liste de clients sont sensibles et doivent être correctement préparées avant d'être importées.

Hacher les données sensibles

Certaines audiences de ciblage par liste de clients sont créées à l'aide d'informations sensibles sur les clients. Display & Video 360 exige que les données sensibles soient hachées à l'aide de l'algorithme SHA256 avant d'être importées. Les champs de données suivants doivent être hachés avant d'être importés :

• Prénom
• Nom
• Adresses e-mail
• Numéros de téléphone

Les codes postaux et les codes pays ne doivent pas être hachés avant l'importation. Toute tentative d'importer des données client non hachées génère une erreur.

Avant de hacher les données, assurez-vous que les conditions suivantes sont remplies :

• Tous les espaces doivent être supprimés des valeurs du prénom, du nom et de l'adresse e-mail.
• Toutes les valeurs doivent être en minuscules.
• Tous les numéros de téléphone doivent être au format E.164 et inclure l'indicatif téléphonique du pays.

Définir le consentement de l'utilisateur

Lorsque vous importez des données utilisateur, utilisez les champs consent dans les objets ContactInfoList ou MobileDeviceIdList fournis pour transmettre les signaux de consentement accordés par les utilisateurs inclus.

Si vous définissez l'un des champs de l'objet Consent sur CONSENT_STATUS_DENIED, une erreur se produit.

Avertissement : Vous devez envoyer des signaux de consentement lorsque vous importez des membres d'audience pour le ciblage par liste de clients dans l'Espace économique européen (EEE) afin de respecter les Règles relatives au consentement de l'utilisateur dans l'UE et d'utiliser les données des utilisateurs de l'EEE pour remplir les audiences de ciblage par liste de clients.

Les signaux de consentement sont définis pour tous les utilisateurs ajoutés dans une même requête firstPartyAndPartnerAudiences.create ou firstPartyAndPartnerAudiences.editCustomerMatchMembers. Les utilisateurs avec des signaux de consentement différents doivent être importés dans des demandes distinctes.

Créer une audience de ciblage par liste de clients

Vous pouvez créer une audience de ciblage par liste de clients à l'aide de la méthode firstPartyAndPartnerAudiences.create. L'audience doit être déclarée comme audience propriétaire et doit avoir un audienceType de CUSTOMER_MATCH_CONTACT_INFO ou CUSTOMER_MATCH_DEVICE_ID. Les données de ciblage par liste de clients doivent être fournies à l'aide du champ approprié dans le champ union members.

Remarque : Le champ membershipDurationDays est obligatoire lorsque vous créez des audiences de ciblage par liste de clients. Les souscriptions individuelles expirent au bout d'une certaine durée si elles ne sont pas réimportées dans l'audience à l'aide de firstPartyAndPartnerAudiences.editCustomerMatchMembers.

Voici un exemple de création d'une audience de ciblage des clients basée sur les coordonnées avec une durée d'appartenance de 540 jours à l'aide d'une liste fournie de numéros de téléphone hachés :

Java

// Create Customer Match audience object.
FirstPartyAndPartnerAudience customerMatchAudience =
    new FirstPartyAndPartnerAudience()
        .setDisplayName(display-name)
        .setFirstPartyAndPartnerAudienceType(
            "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.
FirstPartyAndPartnerAudience response =
    service
        .firstPartyAndPartnerAudiences()
        .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,
    'firstPartyAndPartnerAudienceType':
        '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.firstPartyAndPartnerAudiences().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-party and partner audience object.
$audience = new Google_Service_DisplayVideo_FirstPartyAndPartnerAudience();
$audience->setDisplayName(display-name);
$audience->setFirstPartyAndPartnerAudienceType(
    '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->firstPartyAndPartnerAudiences->create(
    $audience,
    array('advertiserId' => advertiser-id)
);

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

Modifier l'appartenance à une audience de ciblage par liste de clients

Si vous avez identifié d'autres clients que vous souhaitez cibler, si vous devez renouveler les appartenances à l'audience existantes des clients ou si vous souhaitez supprimer des clients d'une audience, vous pouvez mettre à jour les données client d'une audience de ciblage par liste de clients existante avec la méthode firstPartyAndPartnerAudiences.editCustomerMatchMembers. Vous pouvez ajouter des clients à une liste à l'aide du champ d'union added_members et en supprimer à l'aide du champ d'union removed_members.

Une seule requête firstPartyAndPartnerAudiences.editCustomerMatchMembers peut ajouter ou supprimer des membres d'une liste. Une requête unique qui tente d'effectuer les deux opérations génère une erreur INVALID_ARGUMENT.

Remarque : Les champs de métadonnées des audiences de ciblage des clients basées sur les coordonnées et les ID d'appareil, tels que displayName ou membershipDurationDays, peuvent être mis à jour à l'aide de la méthode firstPartyAndPartnerAudiences.patch.

Voici un exemple de procédure pour ajouter un client à une audience de ciblage par liste de clients existante à l'aide des données d'adresse postale fournies :

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
        .firstPartyAndPartnerAudiences()
        .editCustomerMatchMembers(
            audience-id,
            editCustomerMatchMembersRequest
        )
        .execute();

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

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.firstPartyAndPartnerAudiences().editCustomerMatchMembers(
    firstPartyAndPartnerAudienceId=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["firstPartyAndPartnerAudienceId"])

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
    ->firstPartyAndPartnerAudiences
    ->editCustomerMatchMembers(
        audience-id,
        $editMemberRequest
    );

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