آگهی‌ها با DAG مطابقت با مشتری

بررسی اجمالی

این صفحه نحوه پیکربندی 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 ، طرح داده کمی متفاوت است.

  1. اطلاعات تماس

3 زیرنوع طرحواره داده وجود دارد:

مطابقت با hashedEmail :

شناسه مشتری hashedEmail
1234567890 dadbbbb93...

مطابقت بر اساس hashedPhoneNumber :

شناسه مشتری hashedEmail
1234567890 dadbbbb93...

مطابقت با addressInfo :

شناسه مشتری hashedFirstName hashedLastName کد کشور کد پستی
1234567890 dadbbb9337941ad abcd97af923499 JP 1031103
  1. MOBILE_ADVERTISING_ID

مطابقت با mobileId

شناسه مشتری شناسه موبایل
1234567890 12345678-1234-1234-abcdef123456
  1. CRM_ID

مطابقت با thirdPartyUserId

شناسه مشتری IIIPartyUserId
1234567890 id_defined_in_your_organization

برای ذخیره سازی داده ها، 2 نوع وجود دارد، جدول BigQuery یا Google Cloud Storage

  1. از BigQuery با استفاده از tcrm_bq_to_ads_cm_v2 DAG در قالب جدول SQL. (داده های نمونه به دلیل طول عمدا کوتاه شده اند.)

    شناسه مشتری hashedEmail
    1234567890 dadbbbb93...
  2. از Google Cloud Storage با استفاده از tcrm_gcs_to_ads_cm_v2 DAG در قالب JSON.

    {'customerId': '1234567890', 'hashedEmail': 'f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a'}
    
  3. از Google Cloud Storage با استفاده از tcrm_gcs_to_ads_cm_v2 DAG در قالب CSV.

    customerId,hashedEmail
    1234567890,dadbbb9327c711e4b626f7820fb299871d23d6020683bbd1e08d37e0246c7e90
    

DAG خود را اجرا کنید

در کنسول Airflow روی گزینه DAGs از نوار منوی بالا کلیک کنید. DAG را که می خواهید اجرا کنید در لیست سمت چپ پیدا کنید. سپس با کلیک بر روی دکمه Play در سمت راست لیست، آن را اجرا کنید.

خواندن گزارش های DAG

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