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 listeye eklendikten sonra listede kaldığı süre. Değer, tam günlere karşılık gelmelidir. Ayarlanmazsa varsayılan olarak maksimum değer kullanılır.

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

Protokol arabelleği biçimini kullanıyorsanız gün sayısına göre Duration nesnesi oluşturmak için kolaylık yöntemini (böyle bir yöntem varsa) kullanın. Örneğin, Java için protobuf-java-util kitaplığında fromDays() kolaylık yöntemi vardır. Aksi takdirde, gün cinsinden süreyi 86400 (günde saniye sayısı) ile çarparak saniye sayısını hesaplayın ve sonucu kullanarak Duration nesnesinin seconds alanını ayarlayı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 nesnesinde 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 listeye ayarlanmalıdır.

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

contactIdInfo

dataSourceType, DataSourceType enum'undan uygun değere ayarlanmış şekilde bir ContactIdInfo mesajına ayarlayın.

Mobile ID 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 listeye ayarlanmalıdır.

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

mobileIdInfo

MobileIdInfo mesajı olarak ayarla:

  • dataSourceType değerini DataSourceType enum'undaki uygun değere ayarlayın.

  • keySpace değerini 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 listeye ayarlanmalıdır.

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 create isteği oluşturun.

  1. parent alanını hesabın kaynak adı olarak ayarlayın. Kaynak adı accountTypes/{accountType}/accounts/{account} biçimine uygun olmalıdır.

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

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

Farklı kullanıcı bilgisi türleri için JSON biçimindeki örnek istekleri aşağıda bulabilirsiniz. Her istek, membershipDuration değerini 2592000s olarak ayarlar. Burada 2592000, 30 günün saniye cinsinden değeridir. Bir isteğ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"
}

Mobile ID'ler

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önder

İsteği gönderin ve gerekirse login-account veya linked-account gibi istek başlıklarını ekleyin.

İstek başarılı olursa yanıt, yalnızca çıkış içeren id ve name alanları doldurulmuş şekilde oluşturulan UserList öğesini içerir.

İstek başarısız olursa hatanı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