Importer des audiences de ciblage par liste de clients

Vous pouvez créer des audiences de ciblage par liste de clients à l'aide des contacts client importés. ou des identifiants d'appareil mobile via le bouton l'API Video 360. Cette page explique comment pour créer une audience de ciblage par liste de clients initiale et ajouter les nouvelles données client votre audience existante via les campagnes display l'API Video 360.

Avertissement :Vérifiez que les fonctionnalités d'importation de données ont été approuvées pour les partenaire parent de l'audience en essayant d'abord de créer une audience de ciblage par liste de clients sous un annonceur pertinent dans l'interface utilisateur. Si l'importation de données n'est pas activée, les tentatives de création ou de mise à jour d'audiences de ciblage par liste de clients renvoient une erreur. Les utilisateurs disposant d'un accès au niveau du partenaire peuvent envoyer une demande d'approbation via ce formulaire de demande d'accès pour les partenaires.

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 avant de les mettre en ligne.

Hacher les données sensibles

Certaines audiences de ciblage par liste de clients sont créées à l'aide de contacts client sensibles des informations. Display & Dans Video 360, les données sensibles doivent être hachées à l'aide de la méthode Algorithme SHA256 avant l'importation. Les champs de données suivants doivent être hachés avant la mise en ligne:

• 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. Tentative de l'importation de données client non hachées entraîne une erreur.

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

• Vous devez supprimer tout espace blanc du prénom, du nom et de l'adresse e-mail valeurs.
• 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 la ContactInfoList ou Objets MobileDeviceIdList pour transmettre les signaux de consentement accordé par les utilisateurs inclus.

Définir l'un des champs de l'objet Consent sur CONSENT_STATUS_DENIED génère une erreur.

Avertissement :Vous devez envoyer des signaux de consentement lorsque vous importez des données dans l'Espace économique européen les membres de l'audience de ciblage par liste de clients (EEE) doivent respecter le consentement de l'utilisateur dans l'UE. règles et d'utiliser les données utilisateur dans 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 firstAndThirdPartyAudiences.create ou firstAndThirdPartyAudiences.editCustomerMatchMembers requête. Les utilisateurs ayant des signaux de consentement différents doivent être importés dans des requêtes.

Créer une audience de ciblage par liste de clients

Vous pouvez créer une audience de ciblage par liste de clients à l'aide des firstAndThirdPartyAudiences.create. Le public doit être déclarée comme audience propriétaire et doit disposer d'un audienceType sur CUSTOMER_MATCH_CONTACT_INFO ou CUSTOMER_MATCH_DEVICE_ID Les données de ciblage par liste de clients doivent être en utilisant le champ approprié dans le champ "union" members

Remarque :Le champ membershipDurationDays est lorsque vous créez des audiences de ciblage par liste de clients. Abonnement illimité la durée peut être activée en définissant la valeur du champ sur 10 000.

Voici un exemple illustrant comment créer un ciblage par liste de clients avec des coordonnées avec une durée de validité illimitée à l'aide d'une liste fournie de numéros de téléphone:

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 souhaitez cibler d'autres clients, renouveler les données des clients à des audiences existantes ou si vous souhaitez supprimer des clients d'une audience, vous pouvez mettre à jour les données client Faites correspondre l'audience avec le firstAndThirdPartyAudiences.editCustomerMatchMembers . Vous pouvez ajouter des clients à une liste à l'aide des le champ d'union added_members et supprimer les clients d'un contenant le champ d'union removed_members.

Une seule firstAndThirdPartyAudiences.editCustomerMatchMembers peut uniquement ajouter ou supprimer des membres d'une liste. Une seule tentative de requête si vous ne faites pas les deux, une erreur INVALID_ARGUMENT est renvoyée.

Remarque :Champs de métadonnées des coordonnées et du ciblage par liste de clients des ID d'appareil comme displayName ou membershipDurationDays, peut être mis à jour à l'aide de la méthode firstAndThirdPartyAudiences.patch.

Voici un exemple illustrant comment ajouter un seul client en tant que membre d'un coordonnées Audience de ciblage par liste de clients utilisant les 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']
);