Zielgruppen zum Kundenabgleich hochladen

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.

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