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

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

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

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

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

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

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

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

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

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

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

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

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

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

تتبُّع إجراءات أخرى لتطبيقات الأجهزة الجوّالة باستخدام إحصاءات Google 4 المواقع أو إحصاءات التطبيقات التابعة لجهات خارجية: راجِع أنواع إجراءات الإحالات الناجحة الإضافية.

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

تتبُّع الإحالات الناجحة للمكالمات الهاتفية تتيح لك تتبُّع المكالمات من الإعلانات والمكالمات إلى رقم على موقعك الإلكتروني النقرات على الأرقام في مواقع الأجهزة الجوّالة

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

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

AD_CALL

إنّ AD_CALL يظهر إجراء الإحالة الناجحة على أنه مكالمات من إحالة ناجحةمن "إعلانات Google" في "إعلانات Google" وواجهة الويب. بعد إنشاء إجراء الإحالة الناجحة "AD_CALL"، حدِّد في الحقل call_conversion_action عند إنشاء CallAsset إجراء مكالمة مواد العرض إظهار رقم الهاتف في إعلاناتك مباشرةً.

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

WEBSITE_CALL

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

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

استيراد الإحالات الناجحة خارج إطار الإنترنت

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

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

الإحالات الناجحة المحسّنة في الويب تتيح لك إرسال بيانات الإحالات الناجحة للطرف الأول لإجراءَي إحالة ناجحة (WEBPAGE) خلال 24 ساعة من حدث إحالة ناجحة بدلاً من أن يحدث في الوقت نفسه. هذا يجعل من الممكن تحديد بيانات الطرف الأول من مجموعة متنوعة من المصادر، مثل قاعدة بيانات العملاء أو إدارة علاقات العملاء .

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

تُوفّر Google Ads API أنواعًا إضافية من إجراءات الإحالات الناجحة في التقارير. ولكن قد تحدّ من إنشاء تلك الإجراءات أو تعديلها أو تحظرها.

إحالات 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="v17"
    )

    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

تتضمّن الإحالات الناجحة من موقع مرتبط على "إحصاءات Google" أحد العناصر التالية: قيم type:

• الإحالة الناجحة للموقع على "إحصاءات Google 4":

  • GOOGLE_ANALYTICS_4_CUSTOM
  • GOOGLE_ANALYTICS_4_PURCHASE

  يمكنك أيضًا استرداد رقم تعريف موقع "إحصاءات Google 4" واسم الموقع واسم الحدث من الـ google_analytics_4_settings .

• الإحالة الناجحة للموقع على Universal Analytics:

  • UNIVERSAL_ANALYTICS_GOAL
  • UNIVERSAL_ANALYTICS_TRANSACTION

يمكنك إجراء التغييرات التالية على إحالة ناجحة للموقع على "إحصاءات Google 4":

• عليك استيراد الإحالة الناجحة من موقعك على "إحصاءات Google 4" إلى حسابك على "إعلانات Google" من خلال تم تعديل الحقل status من HIDDEN إلى ENABLED.
• يمكنك تعديل حقلَي primary_for_goal وcategory لتوضيح كيفية التنفيذ. التأثير في عروض الأسعار والتقارير في "إعلانات Google"
• يجب تعديل name أو value_settings.
• أزِل الإحالة الناجحة من حسابك على "إعلانات Google" باستخدام عملية remove.

أيّ محاولة لتعديل سمات أخرى لإحالة ناجحة تمّ استيرادها من "إحصاءات Google 4" أو أي تؤدّي سمات إحالة ناجحة مستورَدة من Universal Analytics إلى خطأ MUTATE_NOT_ALLOWED. لا يمكنك إجراء هذه التغييرات إلا باستخدام واجهة مستخدم "إعلانات Google".

Firebase وإحصاءات التطبيقات التابعة لجهات خارجية

للاستيراد إحصاءات التطبيقات التابعة لجهات خارجية أو Firebase تغيير status ConversionAction من HIDDEN إلى ENABLED باستخدام طريقة mutate ConversionActionService. جارٍ تحديث لا يمكن استخدام app_id لهذه اللغات إجراءات الإحالات الناجحة.

• FIREBASE_ANDROID_FIRST_OPEN
• FIREBASE_ANDROID_IN_APP_PURCHASE
• FIREBASE_ANDROID_CUSTOM
• FIREBASE_IOS_FIRST_OPEN
• FIREBASE_IOS_IN_APP_PURCHASE
• FIREBASE_IOS_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

مبيعات المتجر

رغم أنّه لا يمكنك إنشاء STORE_SALES أو STORE_SALES_DIRECT_UPLOAD إجراءات الإحالات الناجحة باستخدام Google Ads API، تتيح واجهة برمجة التطبيقات تحميل متجر معاملات المبيعات.

• STORE_SALES
• STORE_SALES_DIRECT_UPLOAD

خيارات متنوعة

إنّ أنواع إجراءات الإحالات الناجحة التالية هي للقراءة فقط في Google Ads API ويتم توفيرها لأغراض إعداد التقارير.

• ANDROID_APP_PRE_REGISTRATION
• ANDROID_INSTALLS_ALL_OTHER_APPS
• FLOODLIGHT_ACTION
• FLOODLIGHT_TRANSACTION
• GOOGLE_HOSTED
• LEAD_FORM_SUBMIT
• SALESFORCE
• SEARCH_ADS_360
• SMART_CAMPAIGN_AD_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_DIRECTIONS
• SMART_CAMPAIGN_TRACKED_CALLS
• STORE_VISITS
• WEBPAGE_CODELESS

غير معروف

إذا كان حسابك على "إعلانات Google" يتضمّن أنواعًا أخرى من إجراءات الإحالات الناجحة، قد تجد تؤدي طلبات البحث والتقارير إلى عرض إجراءات إحالات ناجحة ConversionAction.type UNKNOWN. لا تتيح واجهة برمجة التطبيقات إدارة إجراءات الإحالات الناجحة هذه، ولكن يتم عرضها لتقديم نتائج كاملة لمقاييس التحويل الرئيسية مثل "metrics.conversions" وmetrics.conversions_value"

مثال على الرمز البرمجي

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

تنطبق الإعدادات التلقائية التالية:

• تحدد واجهة برمجة التطبيقات مع "إعلانات Google" حقل primary_for_goal ولكن يمكنك تعيين هذا الحقل بشكل صريح للتحكم في كيفية يؤثّر إجراء الإحالة الناجحة في إعداد التقارير وتقديم عروض الأسعار في حسابك عند دمجه معًا مع أهداف إحالاتك الناجحة

• تحدد واجهة برمجة التطبيقات مع "إعلانات Google" counting_type تلقائيًا إلى MANY_PER_CLICK. راجِع لمحة عن خيارات احتساب الإحالات الناجحة لمزيد من التفاصيل.

• تعيِّن Google Ads API نموذج الإحالة على البيانات الذي تتم قيادته من خلال ضبط attribution_model_settings إلى GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN القيمة AttributionModel

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {

  // Creates a ConversionAction.
  ConversionAction conversionAction =
      ConversionAction.newBuilder()
          // Note that conversion action names must be unique. If a conversion action already
          // exists with the specified conversion_action_name the create operation will fail with
          // a ConversionActionError.DUPLICATE_NAME error.
          .setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime())
          .setCategory(ConversionActionCategory.DEFAULT)
          .setType(ConversionActionType.WEBPAGE)
          .setStatus(ConversionActionStatus.ENABLED)
          .setViewThroughLookbackWindowDays(15L)
          .setValueSettings(
              ValueSettings.newBuilder()
                  .setDefaultValue(23.41)
                  .setAlwaysUseDefaultValue(true)
                  .build())
          .build();

  // Creates the operation.
  ConversionActionOperation operation =
      ConversionActionOperation.newBuilder().setCreate(conversionAction).build();

  try (ConversionActionServiceClient conversionActionServiceClient =
      googleAdsClient.getLatestVersion().createConversionActionServiceClient()) {
    MutateConversionActionsResponse response =
        conversionActionServiceClient.mutateConversionActions(
            Long.toString(customerId), Collections.singletonList(operation));
    System.out.printf("Added %d conversion actions:%n", response.getResultsCount());
    for (MutateConversionActionResult result : response.getResultsList()) {
      System.out.printf(
          "New conversion action added with resource name: '%s'%n", result.getResourceName());
    }
  }
}
AddConversionAction.java
      

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V17.ConversionActionService);

    // Note that conversion action names must be unique.
    // If a conversion action already exists with the specified name the create operation
    // will fail with a ConversionAction.DUPLICATE_NAME error.
    string ConversionActionName = "Earth to Mars Cruises Conversion #"
        + ExampleUtilities.GetRandomString();

    // Add a conversion action.
    ConversionAction conversionAction = new ConversionAction()
    {
        Name = ConversionActionName,
        Category = ConversionActionCategory.Default,
        Type = ConversionActionType.Webpage,
        Status = ConversionActionStatus.Enabled,
        ViewThroughLookbackWindowDays = 15,
        ValueSettings = new ConversionAction.Types.ValueSettings()
        {
            DefaultValue = 23.41,
            AlwaysUseDefaultValue = true
        }
    };

    // Create the operation.
    ConversionActionOperation operation = new ConversionActionOperation()
    {
        Create = conversionAction
    };

    try
    {
        // Create the conversion action.
        MutateConversionActionsResponse response =
            conversionActionService.MutateConversionActions(customerId.ToString(),
                    new ConversionActionOperation[] { operation });

        // Display the results.
        foreach (MutateConversionActionResult newConversionAction in response.Results)
        {
            Console.WriteLine($"New conversion action with resource name = " +
                $"'{newConversionAction.ResourceName}' was added.");
        }
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
AddConversionAction.cs
      

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    // Creates a conversion action.
    $conversionAction = new ConversionAction([
        // Note that conversion action names must be unique.
        // If a conversion action already exists with the specified conversion_action_name
        // the create operation will fail with a ConversionActionError.DUPLICATE_NAME error.
        'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(),
        'category' => ConversionActionCategory::PBDEFAULT,
        'type' => ConversionActionType::WEBPAGE,
        'status' => ConversionActionStatus::ENABLED,
        'view_through_lookback_window_days' => 15,
        'value_settings' => new ValueSettings([
            'default_value' => 23.41,
            'always_use_default_value' => true
        ])
    ]);

    // Creates a conversion action operation.
    $conversionActionOperation = new ConversionActionOperation();
    $conversionActionOperation->setCreate($conversionAction);

    // Issues a mutate request to add the conversion action.
    $conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient();
    $response = $conversionActionServiceClient->mutateConversionActions(
        MutateConversionActionsRequest::build($customerId, [$conversionActionOperation])
    );

    printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL);

    foreach ($response->getResults() as $addedConversionAction) {
        /** @var ConversionAction $addedConversionAction */
        printf(
            "New conversion action added with resource name: '%s'%s",
            $addedConversionAction->getResourceName(),
            PHP_EOL
        );
    }
}
AddConversionAction.php
      

def main(client, customer_id):
    conversion_action_service = client.get_service("ConversionActionService")

    # Create the operation.
    conversion_action_operation = client.get_type("ConversionActionOperation")

    # Create conversion action.
    conversion_action = conversion_action_operation.create

    # Note that conversion action names must be unique. If a conversion action
    # already exists with the specified conversion_action_name, the create
    # operation will fail with a ConversionActionError.DUPLICATE_NAME error.
    conversion_action.name = f"Earth to Mars Cruises Conversion {uuid.uuid4()}"
    conversion_action.type_ = (
        client.enums.ConversionActionTypeEnum.UPLOAD_CLICKS
    )
    conversion_action.category = (
        client.enums.ConversionActionCategoryEnum.DEFAULT
    )
    conversion_action.status = client.enums.ConversionActionStatusEnum.ENABLED
    conversion_action.view_through_lookback_window_days = 15

    # Create a value settings object.
    value_settings = conversion_action.value_settings
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

    # Add the conversion action.
    conversion_action_response = (
        conversion_action_service.mutate_conversion_actions(
            customer_id=customer_id,
            operations=[conversion_action_operation],
        )
    )

    print(
        "Created conversion action "
        f'"{conversion_action_response.results[0].resource_name}".'
    )
add_conversion_action.py
      

def add_conversion_action(customer_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new


  # Add a conversion action.
  conversion_action = client.resource.conversion_action do |ca|
    ca.name = "Earth to Mars Cruises Conversion #{(Time.new.to_f * 100).to_i}"
    ca.type = :UPLOAD_CLICKS
    ca.category = :DEFAULT
    ca.status = :ENABLED
    ca.view_through_lookback_window_days = 15

    # Create a value settings object.
    ca.value_settings = client.resource.value_settings do |vs|
      vs.default_value = 15
      vs.always_use_default_value = true
    end
  end

  # Create the operation.
  conversion_action_operation = client.operation.create_resource.conversion_action(conversion_action)

  # Add the ad group ad.
  response = client.service.conversion_action.mutate_conversion_actions(
    customer_id: customer_id,
    operations: [conversion_action_operation],
  )

  puts "New conversion action with resource name = #{response.results.first.resource_name}."
end
add_conversion_action.rb
      

sub add_conversion_action {
  my ($api_client, $customer_id) = @_;

  # Note that conversion action names must be unique.
  # If a conversion action already exists with the specified conversion_action_name,
  # the create operation fails with error ConversionActionError.DUPLICATE_NAME.
  my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid();

  # Create a conversion action.
  my $conversion_action =
    Google::Ads::GoogleAds::V17::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V17::Services::ConversionActionService::ConversionActionOperation
    ->new({create => $conversion_action});

  # Add the conversion action.
  my $conversion_actions_response =
    $api_client->ConversionActionService()->mutate({
      customerId => $customer_id,
      operations => [$conversion_action_operation]});

  printf "New conversion action added with resource name: '%s'.\n",
    $conversion_actions_response->{results}[0]{resourceName};

  return 1;
}
add_conversion_action.pl
      

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

شروط التحقق من صحة القيمة

يدعم "إعلانات Google" وGoogle Ads API مجموعة كبيرة من إجراءات الإحالات الناجحة، لذا تختلف قواعد التحقّق بناءً على type الإجراء.

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

في ما يلي بعض النصائح حول ضبط حقول ConversionAction:

جميع حقول التعداد

عند محاولة تعيين أي حقل تعداد على UNKNOWN، تظهر خطأ "RequestError.INVALID_ENUM_VALUE".

app_id

السمة app_id غير قابلة للتغيير ولا يمكن ضبطها إلا عند إنشاء سمة جديدة إحالة ناجحة للتطبيق.

attribution_model_settings

تعيين هذا على متوقف نهائيًا الخيار يؤدي إلى CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS خطأ. لا تتيح "إعلانات Google" سوى استخدام GOOGLE_ADS_LAST_CLICK GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN

click_through_lookback_window_days

يؤدي تعيين هذه السمة على قيمة خارج النطاق المسموح به إلى خطأ RangeError.TOO_LOW أو RangeError.TOO_HIGH.

يجب أن تكون هذه السمة في النطاق [1,60] للسمة AD_CALL أو إجراء إحالة ناجحة واحد (WEBSITE_CALL). بالنسبة إلى معظم إجراءات الإحالات الناجحة الأخرى، النطاق المسموح به هو [1,30].

include_in_conversions_metric

يتعذُّر ضبط هذه القيمة في عملية create أو update باستخدام خطأ FieldError.IMMUTABLE_FIELD. بدلاً من ذلك، ضبط primary_for_goal كـ الموضّحة في دليل أهداف الإحالات الناجحة

phone_call_duration_seconds

محاولة ضبط هذه السمة على إجراء إحالة ناجحة غير مخصّص للمكالمات يؤدي إلى خطأ FieldError.VALUE_MUST_BE_UNSET.

type

السمة type غير قابلة للتغيير ولا يمكن ضبطها إلا عند إنشاء سمة جديدة تحويل.

تعديل إجراء إحالة ناجحة بقيمة type يساوي يؤدي UNKNOWN إلى خطأ MutateError.MUTATE_NOT_ALLOWED.

value_settings

يجب أن تكون السمة value_settings لإجراء الإحالة الناجحة WEBSITE_CALL أو AD_CALL تم ضبط always_use_default_value على true. تحديد قيمة false عند إنشاء هذه القيمة أو تعديلها، إلى ظهور خطأ INVALID_VALUE.

view_through_lookback_window_days

يؤدي تعيين هذه السمة على قيمة خارج النطاق المسموح به إلى خطأ RangeError.TOO_LOW أو RangeError.TOO_HIGH. لمعظم الإحالات الناجحة الإجراءات، فإن النطاق المسموح به هو [1,30].

لا يمكن ضبط هذه السمة على إحالة ناجحة واحدة (AD_CALL) أو إحالة ناجحة واحدة (WEBSITE_CALL) مناسبة. يؤدي تحديد قيمة إلى خطأ VALUE_MUST_BE_UNSET.