Sie können Zielgruppen zum Kundenabgleich mit hochgeladenen Kundenkontaktdaten erstellen. oder Mobilgeräte-IDs mithilfe der Funktion Video 360 API Auf dieser Seite wird beschrieben, um eine erste Zielgruppe zum Kundenabgleich zu erstellen und der bestehenden Zielgruppe die Display- und Video 360 API
Nutzerdaten vorbereiten
Die zum Ausfüllen von Zielgruppen zum Kundenabgleich verwendeten Daten sind sensibel und müssen für den Upload sorgfältig vorbereitet.
Sensible Daten hashen
Einige Zielgruppen zum Kundenabgleich werden mit vertraulichen Kundenkontaktdaten erstellt Informationen. Display- und Bei Video 360 müssen sensible Daten mithilfe des SHA256-Algorithmus. Die folgenden Datenfelder müssen gehasht werden vor dem Upload:
- Vorname
- Nachname
- E‑Mail-Adressen
- Telefonnummern
Postleitzahlen und Ländercodes sollten vor dem Hochladen nicht gehasht werden. Es wird versucht, nicht gehashte Kundendaten hochladen, wird ein Fehler ausgegeben.
Prüfen Sie vor dem Hashen der Daten die folgenden Bedingungen:
- Alle Leerzeichen aus dem Vornamen, Nachnamen und der E-Mail-Adresse müssen entfernt werden. Werte.
- Alle Werte müssen in Kleinbuchstaben geschrieben werden.
- Alle Telefonnummern müssen dem E.164-Format entsprechen und die Landesvorwahl enthalten.
Nutzereinwilligung festlegen
Verwenden Sie beim Hochladen von Nutzerdaten die consent
-Felder im bereitgestellten
ContactInfoList
oder
MobileDeviceIdList
-Objekte zur Weitergabe von Einwilligungssignalen
der einbezogenen Nutzer gewährt wird.
Festlegen eines der Felder im Consent
-Objekt auf
CONSENT_STATUS_DENIED
führt zu einem Fehler.
Einwilligungssignale werden für alle Nutzer festgelegt, die in einem
firstAndThirdPartyAudiences.create
oder
firstAndThirdPartyAudiences.editCustomerMatchMembers
Nutzer mit unterschiedlichen Einwilligungssignalen müssen separat hochgeladen werden
-Anfragen.
Zielgruppe zum Kundenabgleich erstellen
Eine Zielgruppe zum Kundenabgleich kann mit dem
firstAndThirdPartyAudiences.create
-Methode. Die Zielgruppe muss
Zielgruppe mit selbst erhobenen Daten bestimmt werden und eine
audienceType
von
CUSTOMER_MATCH_CONTACT_INFO
oder
CUSTOMER_MATCH_DEVICE_ID
Daten zum Kundenabgleich müssen
mit dem entsprechenden Feld innerhalb des Union-Felds
members
Hier sehen Sie ein Beispiel für das Erstellen eines neuen Kundenabgleichs mit Kontaktdaten eine Zielgruppe mit unbegrenzter Gültigkeitsdauer, die mithilfe einer bereitgestellten Hash-Liste Telefonnummern:
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']);
Zugehörigkeit zu einer Zielgruppe zum Kundenabgleich aktualisieren
Wenn Sie weitere Kunden identifiziert haben,
Kunden verlängern vorhandene Zielgruppenmitgliedschaften haben oder Kunden entfernen möchten,
aus einer Zielgruppe stammen, können Sie die Kundendaten eines
Zielgruppe mit den
firstAndThirdPartyAudiences.editCustomerMatchMembers
. Sie können einer Liste Kunden hinzufügen, indem Sie die
added_members
Union-Feld und entfernen Kunden aus einem
mit dem removed_members
-Union-Feld.
Eine einzelne
firstAndThirdPartyAudiences.editCustomerMatchMembers
-Anfrage kann nur Mitglieder zu einer Liste hinzugefügt oder daraus entfernt werden. Eine einzelne Anfrage, die versucht,
beide zu einem INVALID_ARGUMENT
-Fehler führen.
Hier sehen Sie ein Beispiel für das Hinzufügen eines einzelnen Kunden als Mitglied zu einem vorhandenen Kontaktdaten für die Zielgruppe zum Kundenabgleich unter Verwendung der angegebenen Postanschriften:
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'] );