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

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

Note: Operations that create, update, or delete user lists must comply with the EU Political Ads Regulation (EU PAR) policy and may return an EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED error if the account lacks the required declaration.

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

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

displayName

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

description

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

integrationCode

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

membershipDuration

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

If using JSON, calculate the number of seconds by multiplying the duration days by 86400 (the number of seconds per day). Then set the value to the multiplication result, followed by s . For example, if you want a membership duration of 90 days, use the value 7776000s since 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 را روی رشته‌ای تنظیم کنید که به طور منحصر به فرد، برنامه‌ی موبایلی که داده‌ها از آن جمع‌آوری شده‌اند را مشخص می‌کند.

  • For iOS, the ID string is the 9 digit string that appears at the end of the App Store URL. For example, 476943146 for the "Flood-It!" app with App Store link https://apps.apple.com/us/app/flood-it/id476943146 .

  • For Android, the ID string is the application's package name. For example, com.labpixies.flood for the "Flood-It!" app with Google Play link 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} پیروی کند.

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

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

Here are sample requests in JSON for the different types of user information. Each request sets the membershipDuration to 2592000s , where 2592000 is the number of seconds in 30 days. Click the Open in API Explorer button to try a request.

اطلاعات تماس

باز کردن در کاوشگر 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"
}

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

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

If the request succeeds, the response contains the created UserList with the id and name populated. Make note of the values in these fields since you need them in requests to add audience members to the audience.

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