ایجاد مخاطب «مطابقت مشتری»

با ارسال کردن CreateUserListRequest، مخاطب «انطباق مشتری» ایجاد کنید.

توجه: عملیاتی که فهرست‌های کاربر را ایجاد، به‌روزرسانی، یا حذف می‌کنند باید از خط‌مشی «مقررات آگهی‌های سیاسی اتحادیه اروپا» (EU PAR) پیروی کنند و اگر حساب اظهارنامه موردنیاز را نداشته باشد، ممکن است خطای EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED برگردانند.

ساختن متن درخواست

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

displayName

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

description

شرح مختصری از فهرست.

integrationCode

مدرک شناسایی از سیستم شما.

membershipDuration

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

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

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

فیلدهای الزامی برای «تطابق مشتری»

فیلد ingestedUserListInfo برای مخاطب «مطابقت مشتری» الزامی است.

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

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

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

uploadKeyTypes

روی فهرستی تنظیم کنید که حاوی نوع کلید بارگذاری CONTACT_ID باشد.

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

contactIdInfo

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

فهرست شناسه همراه

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

uploadKeyTypes

روی فهرستی تنظیم کنید که حاوی نوع کلید بارگذاری MOBILE_ID باشد.

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

mobileIdInfo

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

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

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

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

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

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

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

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

uploadKeyTypes

روی فهرستی تنظیم کنید که حاوی نوع کلید بارگذاری USER_ID باشد.

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

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

برای ایجاد مخاطب «تطابق مشتری»، create درخواستی برای منبع UserList بسازید.

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

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

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

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

اطلاعات تماس

باز کردن در API Explorer

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

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

باز کردن در API Explorer

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

{
    "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 تکمیل‌شده است. مقادیر این فیلدها را یادداشت کنید زیرا در درخواست‌های افزودن اعضای مخاطب به مخاطب به آن‌ها نیاز دارید.

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