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

Yüklenen müşteri iletişim bilgilerini kullanarak Müşteri Eşleştirme kitleleri oluşturabilirsiniz Display &Video 360 kullanarak bilgileri veya mobil cihaz kimliklerini Video 360 API. Bu sayfada, ilk Müşteri Eşleştirme kitlesi oluşturun ve Görüntülü Reklam Ağı ve Video 360 API.

Kullanıcı verilerini hazırlama

Müşteri Eşleştirme kitlelerini doldurmak için kullanılan kullanıcı verileri hassastır ve hazırlıklı olmanızı sağlar.

Hassas veri karması oluşturun

Bazı Müşteri Eşleştirme kitleleri, hassas müşteri iletişim bilgileri kullanılarak oluşturulur ekleyebilirsiniz. Görüntülü Reklam ve Video 360, hassas verilere Yüklenmeden önce SHA256 algoritması. Aşağıdaki veri alanlarına karma oluşturma işlemi uygulanmalıdır Yüklemeden önce:

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

Yüklemeden önce posta kodlarına ve ülke kodlarına karma oluşturma işlemi uygulanmamalıdır. Şunları yapmaya çalışılıyor: Karma oluşturma işlemi uygulanmamış müşteri verileri yükleme, hataya neden olabilir.

Verilere karma oluşturma işlemi uygulamadan önce aşağıdaki koşulların sağlandığından emin olun:

  • Ad, soyadı ve e-posta adresinden tüm boşluklar kaldırılmalıdır değerler.
  • Tüm değerler küçük harfle yazılmalıdır.
  • Tüm telefon numaraları E.164 biçimi kullanılarak biçimlendirilmelidir ve ülke telefon kodunu eklemeniz gerekir.

Kullanıcı verilerini yüklerken, sağlanan consent alanlarını kullanın ContactInfoList veya İzin sinyallerini ileten MobileDeviceIdList nesne dahil olan kullanıcılar tarafından izin verildi.

Consent nesnesindeki iki alan da CONSENT_STATUS_DENIED hataya neden oluyor.

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

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

Müşteri Eşleştirme kitlesi, firstAndThirdPartyAudiences.create yöntemini kullanabilirsiniz. Kitle, birinci taraf kitle olarak belirtilmesi ve audienceType / CUSTOMER_MATCH_CONTACT_INFO veya CUSTOMER_MATCH_DEVICE_ID. Müşteri Eşleştirme verileri birleşim alanındaki uygun alan kullanılarak sağlanır members.

Aşağıda, yeni bir müşteri eşleştirme bilgilerinin nasıl oluşturulacağına ilişkin bir örnek verilmiştir: sağlanan karma oluşturma işlemi uygulanmış bir liste kullanarak sınırsız üyelik süresine sahip kitle telefon numaraları:

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

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

Hedeflemek istediğiniz başka müşteriler belirlediyseniz müşterilerin yenileme Mevcut kitle üyeliklerini veya müşterileri kaldırmak istiyorsanız mevcut bir Müşterinin müşteri verilerini güncellemek için Kitleyi firstAndThirdPartyAudiences.editCustomerMatchMembers yöntemidir. Bir listeye müşteri eklemek için added_members birleşim alanına gidin ve removed_members birleşim alanı olan listeye girin.

Tek firstAndThirdPartyAudiences.editCustomerMatchMembers isteği yalnızca bir listeye üye ekleyip kaldırabilir. Deneme amaçlı tek bir istek kullanırsanız INVALID_ARGUMENT hatası alırsınız.

kullanın.

Burada, tek bir müşteriyi mevcut bir iletişim bilgileri: Sağlanan posta adresi verilerini kullanarak Müşteri Eşleştirme kitlesi:

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