Importer des audiences de ciblage par liste de clients

Vous pouvez créer des audiences de ciblage par liste de clients en utilisant les coordonnées des clients importés ou des ID d'appareil mobile, à l'aide de l'API Display & Video 360. Cette page explique 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 :Vérifiez que les fonctionnalités d'importation de données ont été approuvées pour le partenaire parent de l'audience proposée. Pour ce faire, commencez par essayer de créer une audience de ciblage par liste de clients sous un annonceur approprié dans l'interface utilisateur. Si l'importation des données n'a pas été activée, toute tentative de création ou de mise à jour d'audiences de ciblage par liste de clients renvoie une erreur. Les utilisateurs disposant d'un accès au niveau du partenaire peuvent demander une approbation à l'aide de ce formulaire de demande d'accès Partenaire.

Préparer les données utilisateur

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

Hachage de données sensibles

Certaines audiences de ciblage par liste de clients sont créées à l'aide de coordonnées client sensibles. Dans Display & Video 360, les données sensibles doivent être hachées à l'aide de l'algorithme SHA256 avant d'être importées. Les champs de données suivants doivent être hachés avant l'importation:

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

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

Avant de hacher les données, vérifiez les conditions suivantes:

• Tout espace blanc doit être supprimé des valeurs de prénom, de nom et d'adresse e-mail.
• Toutes les valeurs doivent être en minuscules.
• Tous les numéros de téléphone doivent respecter le format E.164 et inclure l'indicatif de 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 l'un des champs de l'objet Consent est défini sur CONSENT_STATUS_DENIED, une erreur est renvoyée.

Avertissement :Vous devez envoyer des signaux de consentement lorsque vous importez des membres d'audiences de 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 utilisateur de l'EEE pour renseigner les audiences de ciblage par liste de clients.

Les signaux de consentement sont définis pour tous les utilisateurs ajoutés dans une seule requête firstAndThirdPartyAudiences.create ou firstAndThirdPartyAudiences.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 firstAndThirdPartyAudiences.create. L'audience doit être déclarée comme étant propriétaire et le audienceType doit être 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é du champ d'union members.

Remarque :Le champ membershipDurationDays est obligatoire lorsque vous créez des audiences de ciblage par liste de clients. Vous pouvez activer une durée de validité illimitée en définissant la valeur du champ sur 10 000.

Voici un exemple de création d'une audience de ciblage par liste de clients avec coordonnées avec une durée de validité illimitée à l'aide d'une liste de numéros de téléphone hachés fournie:

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

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

Si vous avez identifié des clients supplémentaires que vous souhaitez cibler, si vous devez renouveler l'adhésion de clients existants 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 à l'aide de la méthode firstAndThirdPartyAudiences.editCustomerMatchMembers. Vous pouvez ajouter des clients à une liste à l'aide du champ d'union added_members et supprimer des clients d'une liste avec le champ d'union removed_members.

Une seule requête firstAndThirdPartyAudiences.editCustomerMatchMembers permet uniquement d'ajouter des membres à une liste ou d'en supprimer. Une seule requête tentant d'effectuer les deux aboutit à une erreur INVALID_ARGUMENT.

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

Voici un exemple d'ajout d'un seul client en tant que membre à une audience de ciblage par liste de clients avec coordonnées 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
        .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']
);