علامات DAG للإحالات الناجحة خارج إطار الإنترنت

نظرة عامة

ستقدّم لك الصفحة إرشادات حول كيفية إعداد DAG tcrm_bq_to_ads_oc_v2 وtcrm_gcs_to_ads_oc_v2، وكيفية إعداد البيانات.

في بعض الأحيان، لا يؤدي الإعلان إلى عملية بيع عبر الإنترنت مباشرةً، ولكنه يقود العميل إلى مسار يؤدي في النهاية إلى إتمام عملية بيع في العالم غير المتصل بالإنترنت، كما يحدث في مكتبك أو عبر الهاتف. ومن خلال استيراد التحويلات التي تتم دون اتصال بالإنترنت، يمكنك قياس ما يحدث بشكل ملموس بعيدًا عن عالم الإنترنت بعد أن يؤدي إعلانك إلى النقر على موقع نشاطك التجاري على الويب أو الاتصال بالنشاط التجاري نفسه.

لمعرفة التفاصيل، يُرجى الرجوع إلى لمحة عن استيراد الإحالات الناجحة خارج إطار الإنترنت

تهيئة متغيرات تدفق الهواء

إنشاء متغيّرات DAG جديدة لازمة tcrm_bq_to_ads_oc_v2

يوضّح القسم التالي المتغيّرات اللازمة لتشغيل DAG tcrm_bq_to_ads_oc_v2. لا تحتاج إلى إعداد هذه المتغيرات إلا إذا كنت تخطط لاستخدام BigQuery كمصدر بياناتك.

اسم المتغيّر مثال للقيمة معلومات المتغيّر
tcrm_bq_to_ads_oc_v2_bq_dataset_id my_dataset اسم مجموعة بيانات BigQuery التي تحتوي على البيانات.
tcrm_bq_to_ads_oc_v2_bq_table_id my_table اسم جدول BigQuery الذي يحتوي على البيانات.
tcrm_bq_to_ads_OC_v2_google_ads_yaml_credentials للاطلاع على معلومات المصادقة بشأن إعلانات Google API، يُرجى الرجوع إلى نظرة عامة على إعلانات Google API لمزيد من المعلومات.

إنشاء tcrm_gcs_to_ads_oc_v2 متغير DAG جديد مطلوب

يوضّح القسم التالي المتغيّرات اللازمة لتشغيل DAG tcrm_gcs_to_ads_oc_v2. لا تحتاج إلى إعداد هذه المتغيرات إلا إذا كنت تخطط لاستخدام Google Cloud Storage كمصدر للبيانات.

اسم المتغيّر مثال للقيمة معلومات المتغيّر
tcrm_gcs_to_ads_oc_v2_gcs_bucket_name my_bucket اسم حزمة Cloud Storage
tcrm_gcs_to_ads_oc_v2_gcs_bucket_prefix folder/sub_folder المسار إلى مجلد البيانات داخل الحزمة.
tcrm_gcs_to_ads_oc_v2_gcs_content_type (اختياري) إما JSON أو CSV. نوع محتوى Cloud Storage.
tcrm_gcs_to_ads_oc_v2_google_ads_yaml_credentials للاطلاع على معلومات المصادقة بشأن إعلانات Google API، يُرجى الرجوع إلى نظرة عامة على إعلانات Google API لمزيد من المعلومات.

تحضير البيانات لإرسالها إلى الإحالة الناجحة خارج إطار الإنترنت في "إعلانات Google"

توضيحات حقل البيانات:

customerId هو الرقم التعريفي للعميل الذي ينفِّذ عملية التحميل.

conversionActionId هو رقم تعريف إجراء الإحالة الناجحة المرتبط بهذه الإحالة الناجحة. يمكنك العثور على المعرف في عنوان URL لتحويل معين. يُرجى الرجوع إلى لقطة الشاشة. لعرض الصفحة. انقر على TOOLS AND SETTINGS في القائمة العلوية > انقر على Conversion ضمن MEASUREMENT في النافذة المنبثقة > انقر على Conversion action حيث سيتم إرسال الإحالات الناجحة للنقرات في وضع عدم الاتصال.

يجب أن يكون conversionDateTime بنمط yyyy-mm-dd hh:mm:ss+|-hh:mm

لإرسال بياناتك إلى "إعلانات Google"، يمكنك الاختيار من بين الخيارات الثلاثة التالية:

  1. من BigQuery باستخدام DAG tcrm_bq_to_ads_oc_v2 بتنسيق جدول SQL.

    مخطط الجدول:

    اسم الحقل النوع
    الرقم التعريفي للعميل سلسلة
    معرّف الإحالة الناجحة سلسلة
    gclid سلسلة
    قيمة الإحالة الناجحة سلسلة
    تاريخ الإحالة الناجحة سلسلة

    مثال على الجدول:

    الرقم التعريفي للعميل معرّف الإحالة الناجحة gclid قيمة الإحالة الناجحة تاريخ الإحالة الناجحة
    1234567890 123456789 gclick_id_1 0.1 2022-01-11 18:00:00+0900
    1234567890 123456789 gclick_id_2 0.2 12-01-2022 18:00:00+0900
    1234567890 123456789 gclick_id_3 0.3 13-01-2022 18:00:00+0900
    1234567890 123456789 gclick_id_4 0.4 14/01/2022 18:00:00+0900

  2. من Google Cloud Storage باستخدام DAG tcrm_gcs_to_ads_oc_v2 بتنسيق JSON

    {"customerId": "1234567890", "conversionActionId": "123456789", "gclid": "gclick_id_1", "conversionValue":"0.1", "conversionDateTime": "2022-01-11 18:00:00+0900"}
{"customerId": "1234567890", "conversionActionId": "123456789", "gclid": "gclick_id_2", "conversionValue":"0.2", "conversionDateTime": "2022-01-12 18:00:00+0900"}
{"customerId": "1234567890", "conversionActionId": "123456789", "gclid": "gclick_id_3", "conversionValue":"0.3", "conversionDateTime": "2022-01-13 18:00:00+0900"}
{"customerId": "1234567890", "conversionActionId": "123456789", "gclid": "gclick_id_4", "conversionValue":"0.4", "conversionDateTime": "2022-01-14 18:00:00+0900"}

  3. من Google Cloud Storage باستخدام علامة DAG tcrm_gcs_to_ads_oc_v2 بتنسيق CSV.

    customerId,conversionActionId,googleClickId,conversionValue,conversionTime
1234567890,123456789,gclick_id_1,0.1,2022-01-11 18:00:00+0900
1234567890,123456789,gclick_id_2,0.2,2022-01-12 18:00:00+0900
1234567890,123456789,gclick_id_3,0.3,2022-01-13 18:00:00+0900
1234567890,123456789,gclick_id_4,0.4,2022-01-14 18:00:00+0900

تشغيل DAG

في وحدة تحكم Airflow، انقر على الخيار DAGs من أعلى شريط القوائم. ابحث عن DAG الذي ترغب في تشغيله في القائمة على اليمين. وبعد ذلك، يمكنك تشغيلها بالنقر على الزر Play في الجانب الأيسر من القائمة.

قراءة سجلات DAG

يُرجى الرجوع إلى قراءة سجلات DAG في الأسئلة الشائعة.