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

CreateUserListRequest göndererek Müşteri Eşleştirme kitlesi oluşturun.

İstek gövdesini oluşturma

UserList kaynağı oluşturun. Aşağıda, ayarlanacak ortak alanlar verilmiştir.

displayName
Zorunlu Listenin görünen adı. Ad, hesaba ait tüm listeler arasında benzersiz olmalıdır.
description
Listenin kısa bir açıklaması.
integrationCode
Sisteminizdeki bir kimlik.
membershipDuration

Bir kitle üyesinin eklendikten sonra listede kalma süresi. Değer, tam günlere karşılık gelmelidir. Ayarlanmamışsa varsayılan olarak maksimum değer kullanılır.

JSON kullanıyorsanız süreyi (gün) 86400 (günde saniye sayısı) ile çarparak saniye sayısını hesaplayın. Ardından değeri çarpma sonucuna ve s işaretine ayarlayın. Örneğin, 90 günlük bir üyelik süresi istiyorsanız 7776000s değerini kullanın.90 * 86400 = 7776000

Protokol arabellek biçimini kullanıyorsanız gün sayısına göre Duration nesnesi oluşturmak için kolaylık yöntemini kullanın (varsa). Örneğin, Java için protobuf-java-util kitaplığında fromDays() kolaylık yöntemi bulunur. Aksi takdirde, saniye sayısını hesaplamak için sürenin gün olarak ifade edildiği değeri 86400 (günde saniye sayısı) ile çarpın ve sonucu Duration nesnesinin seconds alanını ayarlamak için kullanın.

Müşteri Eşleştirme için zorunlu alanlar

Müşteri Eşleştirme kitlesi için ingestedUserListInfo alanı zorunludur.

Kitle üyelerini listeye eklemek için kullanmak istediğiniz veri türüne göre IngestedUserListInfo üzerinde ayarlanacak alanlar şunlardır:

İletişim bilgileri listesi

Kitle üyelerinizi tanımlamak için iletişim bilgilerini (karma oluşturma işlemi uygulanmış e-posta adresleri, telefon numaraları veya adresler) kullanmak istiyorsanız aşağıdaki alanları ayarlayın:

uploadKeyTypes

CONTACT_ID yükleme anahtarı türünü içeren bir liste olarak ayarlayın.

uploadKeyTypes listesi yalnızca bir giriş içermelidir.

contactIdInfo

ContactIdInfo ile dataSourceType öğesi DataSourceType numarasından uygun değere ayarlanmış bir mesaj olarak ayarlayın.

Mobil kimlik listesi

Kitle üyelerinizi tanımlamak için mobil kimlikleri kullanmak istiyorsanız aşağıdaki alanları ayarlayın:

uploadKeyTypes

MOBILE_ID yükleme anahtarı türünü içeren bir liste olarak ayarlayın.

uploadKeyTypes listesi yalnızca bir giriş içermelidir.

mobileIdInfo

Bir MobileIdInfo mesajı olarak ayarlama:

  • dataSourceType öğesini DataSourceType enum'ındaki uygun değere ayarlayın.

  • keySpace öğesini IOS veya ANDROID olarak ayarlayın.

  • appId parametresini, verilerin toplandığı mobil uygulamayı benzersiz şekilde tanımlayan dizeye ayarlayın.

Kullanıcı kimliği listesi

Kitle üyelerinizi tanımlamak için kullanıcı kimliklerini kullanmak istiyorsanız aşağıdaki alanları ayarlayın:

uploadKeyTypes

USER_ID yükleme anahtarı türünü içeren bir liste olarak ayarlayın.

uploadKeyTypes listesi yalnızca bir giriş içermelidir.

İsteği oluşturma

Müşteri Eşleştirme kitlesi oluşturmak için UserList kaynağına yönelik bir createistek oluşturun.

  1. parent alanını hesabın kaynak adına ayarlayın. Kaynak adı, accountTypes/{accountType}/accounts/{account_id} biçiminde olmalıdır.

  2. İsteğin gövdesi için oluşturduğunuz UserList öğesini kullanın.

  3. Kimlik bilgileriniz, parent üzerinde kullanıcı olan bir Google Hesabı'na ait değilse Hedefleri ve başlıkları yapılandırma bölümünde açıklandığı şekilde başlıkları ayarlayın.

Farklı kullanıcı bilgisi türleri için JSON biçiminde örnek istekleri aşağıda bulabilirsiniz. Her istek, membershipDuration değerini 2592000s olarak ayarlar. Burada 2592000, 30 gündeki saniye sayısıdır. İsteği denemek için API Gezgini'nde aç düğmesini tıklayın.

İletişim bilgileri

API Gezgini'nde aç 
{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Mobil kimlikler

API Gezgini'nde aç 
{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

User ID'ler

API Gezgini'nde aç 
{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

İsteği gönderin

İsteği gönderin ve gerekirse istek başlıklarını ekleyin.

İstek başarılı olursa yanıt, id ve name alanları doldurulmuş olarak oluşturulan UserList öğesini içerir. Kitleye kitle üyeleri ekleme isteklerinde bu alanlardaki değerlere ihtiyacınız olacağından bunları not edin.

İstek başarısız olursa başarısızlığın nedenini belirlemek için hataları inceleyin, sorunları düzeltmek için isteği ve üstbilgileri güncelleyin, ardından güncellenen isteği ve üstbilgileri gönderin.

Önceki
Genel bakış
Sonraki
Kitleye üye yükleme