الإحالات الناجحة

تحدث الإحالة الناجحة في "إعلانات Google" عندما يتخذ المستخدم إجراءً معيّنًا بعد النقر على إعلان أو مشاهدة إعلان على الشبكة الإعلانية، مثل شراء منتج أو تثبيت تطبيق متوافق مع الأجهزة الجوّالة أو الاشتراك في قائمة لعناوين البريد الإلكتروني.

توفّر ميزة تتبُّع الإحالات الناجحة إحصاءات أساسية عن إجراءات المستخدمين بعد مشاهدة إعلان أو النقر عليه. يمكنك تتبّع المستخدمين الذين يتصلون ويشترون منتجًا ويثبّتون تطبيقًا متوافقًا مع الأجهزة الجوّالة والمزيد.

إجراءات الإحالة الناجحة

لقياس الإحالات الناجحة، عليك إعداد ConversionAction لنوع إجراء الإحالة الناجحة الذي تريد تتبُّعه. على سبيل المثال، تتطلب عملية الشراء على الإنترنت وإجراء مكالمة هاتفية إجراءات إحالة ناجحة مختلفة.

تتطلّب معظم إجراءات الإحالة الناجحة أيضًا خطوات إضافية من جانبك لتتبُّعها. على سبيل المثال، يتطلّب تتبُّع إجراءات الإحالات الناجحة على موقعك الإلكتروني إنشاء ConversionAction مع ضبط ConversionActionType على النحو WEBPAGE ومقتطف رمز يُسمّى العلامة التي تضيفها إلى صفحة الإحالات الناجحة في موقعك الإلكتروني.

تجدر الإشارة إلى أنّ المصدر المرتبط بالمكالمات في واجهة ويب "إعلانات Google" (النقرات على رقم الهاتف والمكالمات من الإعلانات والمكالمات من المواقع الإلكترونية) يتم ربط كلٍّ منهما برقم ConversionActionType مختلف في Google Ads API:

• النقرات على رقم الهاتف تتوافق مع CLICK_TO_CALL
• المكالمات من الإعلانات تتوافق مع AD_CALL
• المكالمات من المواقع الإلكترونية تتوافق مع WEBSITE_CALL

الإحالات الناجحة للمكالمات الهاتفية

يتطلب تتبع المكالمات الهاتفية من إضافات المكالمات ConversionAction مع نوع AD_CALL. تستخدم هذه الأرقام رقم توجيه المكالمات من Google وتحدّد إجراء الإحالة الناجحة في إضافة المكالمة الهاتفية FeedItem. في واجهة "إعلانات Google" على الويب، يُطلق على هذا النوع من الإحالات الناجحة اسم المكالمات من الإعلانات.

يتم الإبلاغ عن المكالمة كإحالة ناجحة إذا استمرت لمدة أطول من المحددة. المدة التلقائية هي 60 ثانية.

الإحالات الناجحة عبر الاتصال الهاتفي من الموقع الإلكتروني

يرتبط نوع إجراء الإحالة الناجحة WEBSITE_CALL بالمكالمات من موقع إلكتروني في واجهة "إعلانات Google" على الويب.

وعلى عكس AD_CALL، تتطلّب أداة التتبُّع هذه إضافةevent_snippet وglobal_site_tag إلى موقعك الإلكتروني لاسترداد رقم توجيه المكالمات الديناميكي من Google لتتبُّع المكالمات على الأرقام المدرَجة في موقعك الإلكتروني. إضافةً إلى ذلك، يجب إعداد إضافة مكالمة وإرفاقها بالحملة أو المجموعات الإعلانية التي تريد تتبُّع مكالماتها على الموقع الإلكتروني.

الإحالات الناجحة من الموقع الإلكتروني

يتضمّن الحقل ConversionAction أنواعًا متعدّدة من الإحالات الناجحة للموقع الإلكتروني، ويتم تمييزها ضمن واجهة برمجة التطبيقات من خلال حقل type في TagSnippet.

يعرض الجدول التالي مَعلمات واجهة برمجة التطبيقات المكافئة التي سيتم استخدامها لكل مصدر في واجهة الويب على "إعلانات Google":

تتطلب الإحالات الناجحة من الموقع الإلكتروني والنقرات على رقم الهاتف event_snippet، الذي يجب وضعه على صفحات الويب التي تشير إلى إجراء إحالة ناجحة، مثل تأكيد الدفع أو صفحة إرسال العميل المحتمل وglobal_site_tag التي يجب تثبيتها على كل صفحة من موقعك الإلكتروني. يمكنك استرداد كلتا السمتَين باستخدام ConversionActionService.

يختلف النوع CLICK_TO_CALL عن النوع AD_CALL في ConversionAction.type من حيث عدم تتبُّع المكالمات الهاتفية. وبدلاً من ذلك، فإنها تتتبّع النقرات على رقم هاتف فقط من جهاز جوّال. ويُعد هذا مفيدًا عندما لا تتمكن من استخدام رقم توجيه المكالمات من Google لتتبع المكالمات الهاتفية الفعلية.

الإحالات الناجحة للتطبيق

تتناول ConversionActionType عمليات تثبيت التطبيقات المتوافقة مع الأجهزة الجوّالة والإجراءات داخل التطبيق في Android. يوضّح الجدول التالي معلمات واجهة برمجة التطبيقات المكافئة التي يمكن استخدامها لكل مصدر في واجهة ويب "إعلانات Google":

إحالات SKAdNetwork الناجحة

إذا كنت تدير حملات تطبيقات iOS ونفذت SKAdNetwork، يمكنك الوصول إلى بيانات SKAdNetwork المقدَّمة إلى Google على المستوىَين Customer وCampaign باستخدام الموارد التالية:

يمكنك أيضًا حفظ عملية ربط قيمة إحالة SKAdNetwork لعملاء محدّدين مرتبطين بتطبيقات iOS من خلال CustomerSkAdNetworkConversionValueSchema.

#!/usr/bin/env python
# Copyright 2019 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

import argparse
import sys

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException


def main(client, customer_id):
    """Adds a keyword plan, campaign, ad group, etc. to the customer account.

    Also handles errors from the API and prints them.

    Args:
        client: An initialized instance of GoogleAdsClient
        customer_id: A str of the customer_id to use in requests.
    """

    res = update_skan_cv_schema(
        client, customer_id, "my_app_id", "account_link_id"
    )
    print(res)


def update_skan_cv_schema(client, customer_id, app_id, account_link_id):
    skan_service = client.get_service(
        "CustomerSkAdNetworkConversionValueSchemaService"
    )

    req = client.get_type(
        "MutateCustomerSkAdNetworkConversionValueSchemaRequest"
    )
    operation = client.get_type(
        "CustomerSkAdNetworkConversionValueSchemaOperation"
    )
    schema_instance = client.get_type(
        "CustomerSkAdNetworkConversionValueSchema"
    )

    new_schema = operation.update
    new_schema.resource_name = (
        skan_service.customer_sk_ad_network_conversion_value_schema_path(
            "customer_id", "account_link_id"
        )
    )
    new_schema.schema.app_id = app_id
    new_schema.schema.measurement_window_hours = 48

    skan_cv_mapping = (
        schema_instance.SkAdNetworkConversionValueSchema.FineGrainedConversionValueMappings()
    )
    skan_cv_mapping.fine_grained_conversion_value = 0  # 0 - 63
    skan_cv_mapping.conversion_value_mapping.min_time_post_install_hours = 0
    skan_cv_mapping.conversion_value_mapping.max_time_post_install_hours = 48

    skan_cv_event = schema_instance.SkAdNetworkConversionValueSchema.Event()
    skan_cv_event.mapped_event_name = "TEST"
    skan_cv_event.event_revenue_value = 10

    skan_cv_mapping.conversion_value_mapping.mapped_events.append(skan_cv_event)
    new_schema.schema.fine_grained_conversion_value_mappings.append(
        skan_cv_mapping
    )

    req.operation = operation
    req.customer_id = customer_id

    res = skan_service.mutate_customer_sk_ad_network_conversion_value_schema(
        req
    )
    return res


if __name__ == "__main__":
    # GoogleAdsClient will read the google-ads.yaml configuration file in the
    # home directory if none is specified.
    googleads_client = GoogleAdsClient.load_from_storage(
        version="v14"
    )

    parser = argparse.ArgumentParser(
        description="Creates a keyword plan for specified customer."
    )
    # The following argument(s) should be provided to run the example.
    parser.add_argument(
        "-c",
        "--customer_id",
        type=str,
        required=True,
        help="The Google Ads customer ID.",
    )
    args = parser.parse_args()

    try:
        main(googleads_client, args.customer_id)
    except GoogleAdsException as ex:
        print(
            f'Request with ID "{ex.request_id}" failed with status '
            f'"{ex.error.code().name}" and includes the following errors:'
        )
        for error in ex.failure.errors:
            print(f'\tError with message "{error.message}".')
            if error.location:
                for field_path_element in error.location.field_path_elements:
                    print(f"\t\tOn field: {field_path_element.field_name}")
        sys.exit(1)
  

الإحالات الناجحة بلا إنترنت

يمكن استخدام إجراءات الإحالات الناجحة لتحميل الإحالات الناجحة النقر أو الاتصال بلا اتصال بالإنترنت إلى "إعلانات Google" من خلال ضبط نوع إجراء الإحالة الناجحة على UPLOAD_CLICKS أو UPLOAD_CALLS.

أنواع الإحالات الناجحة الإضافية

هناك عدة أنواع من إجراءات الإحالة الناجحة التي لا يمكن إنشاؤها باستخدام Google Ads API، ولكن لا يزال بإمكانك استرداد مقاييس الأداء في التقارير، وفي بعض الحالات، تعديل بعض سماتها.

أهداف الإحالات الناجحة

تساعدك أهداف الإحالات الناجحة في تنظيم إجراءات إحالاتك الناجحة حتى تتمكّن بسهولة أكبر من إجراء تحسين لتحقيق أهدافك الإعلانية. اطّلع على دليل الأهداف للحصول على مزيد من المعلومات.

قواعد قيمة الإحالة الناجحة

قواعد قيمة الإحالة الناجحة تتيح لك تحديد قواعد تعديل قيم إحالاتك الناجحة استنادًا إلى سمات مختلفة.

تفعيل ميزة تتبُّع الإحالات الناجحة

يمكنك التحقّق من إعداد ميزة تتبُّع الإحالات الناجحة في حسابك وتأكيد تفعيل ميزة تتبُّع الإحالات الناجحة من خلال إصدار طلب البحث التالي باستخدام GoogleAdsService.searchStream:

SELECT
  customer.conversion_tracking_setting.conversion_tracking_id,
  customer.conversion_tracking_setting.conversion_tracking_status,
  customer.conversion_tracking_setting.cross_account_conversion_tracking_id,
  customer.conversion_tracking_setting.google_ads_conversion_customer
FROM customer

يشير الحقل conversion_tracking_status إلى ما إذا كان قد تم تفعيل تتبُّع الإحالات الناجحة وما إذا كان الحساب يستخدم تتبُّع الإحالات الناجحة في جميع الحسابات.

NOT_CONVERSION_TRACKED

ميزة تتبُّع الإحالات الناجحة غير مفعّلة للحساب. فعِّل تتبُّع الإحالات الناجحة عن طريق إنشاء إجراء واحد على الأقل ConversionAction في الحساب الذي حدّده google_ads_conversion_customer.

بدءًا من الإصدار 12 من Google Ads API، ستكون conversion_tracking_id قيمة غير صفرية، حتى إذا كانت قيمة conversion_tracking_status هي NOT_CONVERSION_TRACKED. إذا كان تطبيقك يستخدم conversion_tracking_id لتحديد ما إذا كان سيتم تفعيل تتبُّع الإحالات الناجحة، يمكنك التبديل إلى استخدام conversion_tracking_status بدلاً من ذلك.

CONVERSION_TRACKING_MANAGED_BY_SELF

تم تفعيل تتبع الإحالات الناجحة، ويدير الحساب الإحالات الناجحة بدلاً من استخدام تتبع الإحالات الناجحة في جميع الحسابات.

CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER

تم تفعيل تتبع الإحالات الناجحة واستخدام الحساب لتتبُّع الإحالات الناجحة في جميع الحسابات. الحساب المحدّد في login-customer-id للطلب والمعروض في google_ads_conversion_customer في الرد يدير الإحالات الناجحة.

CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER

تم تفعيل تتبع الإحالات الناجحة واستخدام الحساب لتتبُّع الإحالات الناجحة في جميع الحسابات. ومع ذلك، الحساب الذي يُدير الإحالات الناجحة هو google_ads_conversion_customer، وليس login-customer-id في عنوان الطلب.

تتبّع الإحالات الناجحة في جميع الحسابات

إذا كنت تستخدم تتبُّع الإحالات الناجحة في جميع الحسابات، ستعرض ConversionActionService إجراءات الإحالات الناجحة التالية:

• كل إجراءات الإحالة الناجحة التي حدّدها الحساب الإداري الذي يستخدمه الحساب لتتبُّع الإحالات الناجحة في جميع الحسابات
• كل إجراءات الإحالة الناجحة التي تراكم عليها العميل إحصاءات، بما في ذلك الإجراءات التي يحدّدها النظام والإجراءات التي يملكها المدير حتى إذا ألغى ذلك المدير لاحقًا
• جميع الإجراءات التي حدّدها العميل في حسابه الخاص، بما في ذلك أهداف "إحصاءات Google" ومعاملاته التي تم إنشاؤها في الملفات الشخصية المرتبطة في "إحصاءات Google". ويتضمّن ذلك الإجراءات التي لم يتم استيرادها إلى "إعلانات Google"، والتي قد تكون حالتها HIDDEN ولا يمكن استيرادها إلا من خلال واجهة "إعلانات Google" على الويب.

يمكنك إعداد إجراءات الإحالات الناجحة في جميع الحسابات وتقديم طلبات بحث عنها باستخدام واجهة برمجة التطبيقات، ولكن عليك تفعيل ميزة تتبُّع الإحالات الناجحة في جميع الحسابات من الحساب الإداري.