Müşteri Eşleştirme kitlelerini yükleme

Yüklenen müşteri iletişim bilgilerini veya mobil cihaz kimliklerini kullanarak Display & Video 360 API'yi kullanarak Müşteri Eşleştirme kitleleri oluşturabilirsiniz. Bu sayfada, ilk Müşteri Eşleştirme kitlesinin nasıl oluşturulacağı ve Display & Video 360 API'si kullanılarak mevcut kitleye yeni müşteri verilerinin nasıl ekleneceği açıklanmaktadır.

Kullanıcı verilerini hazırlama

Müşteri Eşleştirme kitlelerini doldurmak için kullanılan kullanıcı verileri hassastır ve yüklenmeden önce uygun şekilde hazırlanması gerekir.

Hassas verileri karma oluşturma

Bazı Müşteri Eşleştirme kitleleri, hassas müşteri iletişim bilgileri kullanılarak oluşturulur. Display & Video 360, hassas verilerin yüklenmeden önce SHA256 algoritması kullanılarak karma oluşturma işlemine tabi tutulmasını zorunlu kılar. Aşağıdaki veri alanları yüklenmeden önce karma oluşturma işlemine tabi tutulmalıdır:

  • Ad
  • Soyadı
  • E-posta adresleri
  • Telefon numaraları

Posta kodları ve ülke kodlarına yüklemeden önce karma oluşturma işlemi uygulanmamalıdır. Karma oluşturma işlemi uygulanmamış müşteri verilerini yüklemeye çalışmak hatayla sonuçlanır.

Verileri karma oluşturmadan önce aşağıdaki koşulların karşılandığından emin olun:

  • Ad, soyadı ve e-posta adresi değerlerindeki boşluklar kaldırılmalıdır.
  • Tüm değerler küçük harfle yazılmalıdır.
  • Tüm telefon numaraları E.164 biçimiyle biçimlendirilmeli ve ülke arama kodunu içermelidir.

Kullanıcı verilerini yüklerken, dahil edilen kullanıcılar tarafından verilen izin sinyallerini iletmek için sağlanan ContactInfoList veya MobileDeviceIdList nesnelerindeki consent alanlarını kullanın.

Consent nesnesinde bir alanın CONSENT_STATUS_DENIED olarak ayarlanması hatayla sonuçlanır.

İzin sinyalleri, tek bir firstAndThirdPartyAudiences.create veya firstAndThirdPartyAudiences.editCustomerMatchMembers isteğinde eklenen tüm kullanıcılar için ayarlanır. Farklı rıza sinyallerine sahip kullanıcılar ayrı isteklerde yüklenmelidir.

Müşteri Eşleştirme Kitlesi oluşturma

firstAndThirdPartyAudiences.create yöntemi kullanılarak Müşteri Eşleştirme kitlesi oluşturulabilir. Kitle, birinci taraf kitle olarak tanımlanmış olmalı ve CUSTOMER_MATCH_CONTACT_INFO veya CUSTOMER_MATCH_DEVICE_ID audienceType değerine sahip olmalıdır. Müşteri Eşleştirme verileri, birleştirme alanındaki uygun alan members kullanılarak sağlanmalıdır.

Karma oluşturma işlemi uygulanmış telefon numaralarının sağlandığı bir liste kullanılarak 540 günlük üyelik süresi olan yeni bir iletişim bilgileri Müşteri Eşleştirme kitlesi oluşturma örneği aşağıda verilmiştir:

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(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.
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': 540,
    '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(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->firstAndThirdPartyAudiences->create(
    $audience,
    array('advertiserId' => advertiser-id)
);

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

Müşteri Eşleştirme kitlesinin üyeliğini güncelleme

Hedeflemek istediğiniz başka müşteriler belirlediyseniz, müşterilerin mevcut kitle üyeliklerini yenilemeniz gerekiyorsa veya müşterileri bir kitleden kaldırmak istiyorsanız mevcut bir Müşteri Eşleştirme kitlesinin müşteri verilerini firstAndThirdPartyAudiences.editCustomerMatchMembers yöntemiyle güncelleyebilirsiniz. added_members birleştirme alanını kullanarak müşterileri bir listeye ekleyebilir ve removed_members birleştirme alanını kullanarak müşterileri bir listeden kaldırabilirsiniz.

Tek bir firstAndThirdPartyAudiences.editCustomerMatchMembers istek yalnızca bir listeden üye ekleyebilir veya kaldırabilir. Her ikisini de yapmaya çalışan tek bir istek INVALID_ARGUMENT hatasıyla sonuçlanır.

Aşağıda, sağlanan posta adresi verilerini kullanarak tek bir müşterinin mevcut bir iletişim bilgileri Müşteri Eşleştirme kitlesine üye olarak nasıl ekleneceğini gösteren bir örnek verilmiştir:

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']
);
Önceki
Hedef kitleler