بررسی اجمالی
این صفحه نحوه پیکربندی tcrm_bq_to_ads_cm_v2
و tcrm_gcs_to_ads_cm_v2
و نحوه آمادهسازی دادهها را راهنمایی میکند.
Customer Match به شما امکان می دهد از داده های آنلاین و آفلاین خود برای دسترسی و تعامل مجدد با مشتریان خود در جستجو، برگه خرید، Gmail، YouTube و Display استفاده کنید. با استفاده از اطلاعاتی که مشتریان شما با شما به اشتراک گذاشته اند، Customer Match تبلیغات را برای آن مشتریان و سایر مشتریانی مانند آنها هدف قرار می دهد.
برای جزئیات، لطفاً به درباره مطابقت مشتری مراجعه کنید
متغیرهای جریان هوا را پیکربندی کنید
ایجاد متغیرهای جدید مورد نیاز tcrm_bq_to_ads_cm_v2
DAG
بخش زیر نشان می دهد که کدام متغیرها برای اجرای tcrm_bq_to_ads_cm_v2
DAG مورد نیاز هستند. فقط اگر قصد دارید از BigQuery به عنوان منبع داده خود استفاده کنید، باید این متغیرها را تنظیم کنید.
نام متغیر | مقدار نمونه | اطلاعات متغیر |
---|---|---|
tcrm_bq_to_ads_cm_v2_bq_dataset_id | my_dataset | نام مجموعه داده BigQuery حاوی دادهها. |
tcrm_bq_to_ads_cm_v2_bq_table_id | my_table | نام جدول BigQuery حاوی داده ها. |
tcrm_bq_to_ads_cm_v2_google_ads_yaml_credentials | اطلاعات احراز هویت برای Google Ads API، لطفاً برای اطلاعات بیشتر به Google Ads API Overview مراجعه کنید. | |
tcrm_bq_to_ads_cm_v2_ads_cm_user_list_name | my_name_list | نام لیست کاربر مطابقت مشتری. |
tcrm_bq_to_ads_cm_v2_ads_upload_key_type | CONTACT_INFO | نوع کلید آپلود که از بین CONTACT_INFO ، CRM_ID ، یا MOBILE_ADVERTISING_ID انتخاب میشود. لطفاً به User List در Google Ads مراجعه کنید |
tcrm_bq_to_ads_cm_v2_ads_cm_create_list | False | درست/نادرست، نشاندهنده ایجاد یک لیست جدید در زمانی که لیست موجود نیست. |
tcrm_bq_to_ads_cm_v2_ads_cm_membership_lifespan_in_days | 30 | تعداد روزهایی که کوکی کاربر می ماند. |
tcrm_bq_to_ads_cm_v2_ads_cm_app_id | شناسه برنامه موبایل برای ایجاد لیست کاربران. فقط زمانی لازم است که ads_upload_key_type MOBILE_ADVERTISING_ID باشد. |
ایجاد متغیرهای جدید مورد نیاز tcrm_gcs_to_ads_cm_v2
DAG
بخش زیر نشان می دهد که کدام متغیرها برای اجرای tcrm_gcs_to_ads_cm_v2
DAG مورد نیاز هستند. فقط اگر قصد دارید از Google Cloud Storage به عنوان منبع داده خود استفاده کنید، باید این متغیرها را تنظیم کنید.
نام متغیر | مقدار نمونه | اطلاعات متغیر |
---|---|---|
tcrm_gcs_to_ads_cm_v2_gcs_bucket_name | my_bucket | نام سطل ذخیرهسازی ابری. |
tcrm_gcs_to_ads_cm_v2_gcs_bucket_prefix | folder/sub_folder | مسیر پوشه داده در داخل سطل. |
tcrm_gcs_to_ads_cm_v2_gcs_content_type (اختیاری) | JSON یا CSV . | نوع محتوای Cloud Storage. |
tcrm_gcs_to_ads_cm_v2_google_ads_yaml_credentials | اطلاعات احراز هویت برای Google Ads API، لطفاً برای اطلاعات بیشتر به Google Ads API Overview مراجعه کنید. | |
tcrm_gcs_to_ads_cm_v2_ads_cm_user_list_name | my_name_list | نام لیست کاربر مطابقت مشتری. |
tcrm_gcs_to_ads_cm_v2_ads_upload_key_type | CONTACT_INFO | نوع کلید آپلود که از بین CONTACT_INFO ، CRM_ID ، یا MOBILE_ADVERTISING_ID انتخاب میشود. لطفاً به User List در Google Ads مراجعه کنید |
tcrm_gcs_to_ads_cm_v2_ads_cm_create_list | False | درست/نادرست، نشاندهنده ایجاد یک لیست جدید در زمانی که لیست موجود نیست. |
tcrm_gcs_to_ads_cm_v2_ads_cm_membership_lifespan_in_days | 30 | تعداد روزهایی که کوکی کاربر می ماند. |
tcrm_gcs_to_ads_cm_v2_ads_cm_app_id | شناسه برنامه موبایل برای ایجاد لیست کاربران. فقط زمانی لازم است که ads_upload_key_type MOBILE_ADVERTISING_ID باشد. |
داده ها را برای ارسال به Google Ads Customer Match آماده کنید
برای هر upload_key_type
، طرح داده کمی متفاوت است.
- اطلاعات تماس
3 زیرنوع طرحواره داده وجود دارد:
مطابقت با hashedEmail
:
شناسه مشتری | hashedEmail |
---|---|
1234567890 | dadbbbb93... |
مطابقت بر اساس hashedPhoneNumber
:
شناسه مشتری | hashedEmail |
---|---|
1234567890 | dadbbbb93... |
مطابقت با addressInfo
:
شناسه مشتری | hashedFirstName | hashedLastName | کد کشور | کد پستی |
---|---|---|---|---|
1234567890 | dadbbb9337941ad | abcd97af923499 | JP | 1031103 |
- MOBILE_ADVERTISING_ID
مطابقت با mobileId
شناسه مشتری | شناسه موبایل |
---|---|
1234567890 | 12345678-1234-1234-abcdef123456 |
- CRM_ID
مطابقت با thirdPartyUserId
شناسه مشتری | IIIPartyUserId |
---|---|
1234567890 | id_defined_in_your_organization |
برای ذخیره سازی داده ها، 2 نوع وجود دارد، جدول BigQuery یا Google Cloud Storage
از BigQuery با استفاده از
tcrm_bq_to_ads_cm_v2
DAG در قالب جدول SQL. (داده های نمونه به دلیل طول عمدا کوتاه شده اند.)شناسه مشتری hashedEmail 1234567890 dadbbbb93... از Google Cloud Storage با استفاده از
tcrm_gcs_to_ads_cm_v2
DAG در قالب JSON.{'customerId': '1234567890', 'hashedEmail': 'f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a'}
از Google Cloud Storage با استفاده از
tcrm_gcs_to_ads_cm_v2
DAG در قالب CSV.customerId,hashedEmail 1234567890,dadbbb9327c711e4b626f7820fb299871d23d6020683bbd1e08d37e0246c7e90
DAG خود را اجرا کنید
در کنسول Airflow روی گزینه DAGs
از نوار منوی بالا کلیک کنید. DAG را که می خواهید اجرا کنید در لیست سمت چپ پیدا کنید. سپس با کلیک بر روی دکمه Play
در سمت راست لیست، آن را اجرا کنید.
خواندن گزارش های DAG
لطفاً به خواندن گزارشهای DAG در پرسشهای متداول مراجعه کنید.