یک مخاطب مطابقت با مشتری ایجاد کنید

با ارسال یک CreateUserListRequest یک مخاطب Customer Match ایجاد کنید.

ساخت بدنه درخواست

یک منبع UserList ایجاد کنید. در اینجا فیلدهای رایج برای تنظیم آمده است.

displayName

نام نمایشی لیست. این نام باید در بین تمام لیست‌های متعلق به حساب کاربری منحصر به فرد باشد.

description

توضیح مختصری در مورد فهرست.

integrationCode

یک شناسه از سیستم شما.

membershipDuration

مدت زمانی که یک عضو مخاطب پس از اضافه شدن در لیست باقی می‌ماند. مقدار باید معادل کل روزها باشد. اگر تنظیم نشود، به طور پیش‌فرض روی حداکثر تنظیم می‌شود.

اگر از JSON استفاده می‌کنید، تعداد ثانیه‌ها را با ضرب کردن مدت زمان روزها در 86400 (تعداد ثانیه‌ها در هر روز) محاسبه کنید. سپس مقدار را برابر با حاصل ضرب قرار دهید و به دنبال آن s بگذارید. به عنوان مثال، اگر می‌خواهید مدت عضویت ۹۰ روز باشد، از مقدار 7776000s استفاده کنید زیرا 90 * 86400 = 7776000 .

اگر از قالب بافر پروتکل استفاده می‌کنید، از روش راحتی برای ساخت یک شیء Duration بر اساس تعداد روزها، در صورت وجود چنین روش راحتی، استفاده کنید. برای مثال، کتابخانه protobuf-java-util برای جاوا دارای یک روش راحتی fromDays() است. در غیر این صورت، تعداد ثانیه‌ها را با ضرب کردن روزهای مدت زمان در 86400 (تعداد ثانیه در هر روز) محاسبه کنید و از نتیجه برای تنظیم فیلد seconds از شیء Duration استفاده کنید.

فیلدهای مورد نیاز برای تطابق مشتری

فیلد ingestedUserListInfo برای مخاطب Customer Match الزامی است.

در اینجا فیلدهایی برای تنظیم در IngestedUserListInfo بر اساس نوع داده‌ای که می‌خواهید برای افزودن اعضای مخاطب به لیست استفاده کنید، آورده شده است.

فهرست اطلاعات تماس

اگر می‌خواهید از اطلاعات تماس (آدرس‌های ایمیل هش شده، شماره تلفن یا آدرس‌ها) برای تعریف اعضای مخاطب خود استفاده کنید، فیلدهای زیر را تنظیم کنید:

uploadKeyTypes

روی لیستی حاوی نوع کلید آپلود CONTACT_ID تنظیم کنید.

لیست uploadKeyTypes باید فقط شامل یک ورودی باشد.

contactIdInfo

روی یک پیام ContactIdInfo تنظیم می‌شود و dataSourceType روی مقدار مناسب از شمارش DataSourceType تنظیم می‌شود.

فهرست شناسه‌های موبایل

اگر می‌خواهید از شناسه‌های موبایل برای تعریف اعضای مخاطب خود استفاده کنید، فیلدهای زیر را تنظیم کنید:

uploadKeyTypes

روی لیستی حاوی نوع کلید آپلود MOBILE_ID تنظیم کنید.

لیست uploadKeyTypes باید فقط شامل یک ورودی باشد.

mobileIdInfo

روی پیام MobileIdInfo تنظیم کنید:

• مقدار dataSourceType از نوع شمارشی DataSourceType روی مقدار مناسب تنظیم کنید.

• keySpace را روی IOS یا ANDROID تنظیم کنید.

• appId را روی رشته‌ای تنظیم کنید که به طور منحصر به فرد، برنامه‌ی موبایلی که داده‌ها از آن جمع‌آوری شده‌اند را مشخص می‌کند.

  • برای iOS، رشته شناسه، رشته‌ای ۹ رقمی است که در انتهای آدرس اینترنتی اپ استور ظاهر می‌شود. برای مثال، 476943146 برای برنامه "Flood-It!" با لینک اپ استور https://apps.apple.com/us/app/flood-it/id476943146 .

  • برای اندروید، رشته شناسه، نام بسته برنامه است. برای مثال، com.labpixies.flood برای برنامه "Flood-It!" با لینک گوگل پلی https://play.google.com/store/apps/details?id=com.labpixies.flood .

فهرست شناسه کاربری

اگر می‌خواهید از شناسه‌های کاربری برای تعریف اعضای مخاطب خود استفاده کنید، فیلدهای زیر را تنظیم کنید:

uploadKeyTypes

روی لیستی حاوی نوع کلید آپلود USER_ID تنظیم کنید.

لیست uploadKeyTypes باید فقط شامل یک ورودی باشد.

ساخت درخواست

برای ایجاد مخاطب Customer Match، یک درخواست create برای منبع UserList ایجاد کنید.

1. فیلد parent را روی نام منبع حساب تنظیم کنید. نام منبع باید از قالب accountTypes/{accountType}/accounts/{account_id} پیروی کند.

2. از UserList که برای بدنه درخواست ساخته‌اید استفاده کنید.

3. اگر اطلاعات کاربری شما برای حساب گوگلی که کاربر parent است، نیست، هدرها را همانطور که در پیکربندی مقصدها و هدرها توضیح داده شده است، تنظیم کنید.

در اینجا نمونه درخواست‌هایی در قالب JSON برای انواع مختلف اطلاعات کاربر ارائه شده است. هر درخواست، membershipDuration روی 2592000s تنظیم می‌کند، که در آن 2592000 تعداد ثانیه‌ها در ۳۰ روز است. برای امتحان کردن یک درخواست، روی دکمه Open in API Explorer کلیک کنید.

اطلاعات تماس

باز کردن در کاوشگر API

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

شناسه‌های موبایل

باز کردن در کاوشگر API

{
    "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"
}

شناسه‌های کاربری

باز کردن در کاوشگر API

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

درخواست را ارسال کنید

درخواست را ارسال کنید و در صورت لزوم، هدرهای درخواست را اضافه کنید.

اگر درخواست با موفقیت انجام شود، پاسخ شامل UserList ایجاد شده با id و name وارد شده است. مقادیر این فیلدها را یادداشت کنید زیرا در درخواست‌های افزودن اعضای مخاطب به فهرست مخاطبان به آنها نیاز دارید.

اگر درخواست با شکست مواجه شد، خطاها را بررسی کنید تا علت شکست را مشخص کنید، درخواست و هدرها را به‌روزرسانی کنید تا هرگونه مشکل را برطرف کنید و سپس درخواست و هدرهای به‌روزرسانی‌شده را ارسال کنید.