تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

البدء

يجب تفعيل ميزة تتبُّع الإحالات الناجحة في حساب تتبّع الإحالات الناجحة على "إعلانات Google" من أجل تسجيل الإحالات الناجحة. يقدّم هذا الدليل تفاصيل حول كيفية التأكّد من تفعيل ميزة تتبُّع الإحالات الناجحة، وتفعيلها إذا لم تكن مفعّلة، واسترداد معلومات حول إجراءات الإحالات الناجحة الحالية.

تتطلّب معظم إجراءات الإحالات الناجحة أيضًا اتّخاذ خطوات إضافية من جانبك لتتبُّعها. لمزيد من المعلومات عن أنواع إجراءات الإحالات الناجحة المختلفة ومتطلباتها، اطّلِع على فئات إجراءات الإحالات الناجحة وإنشاء إجراءات إحالات ناجحة.

الاستعداد لتقديم الموافقة

عند استيراد الإحالات الناجحة أو بيانات المستخدِمين، يجب التأكّد من أنّ لديك الإذن بمشاركة بيانات الإحالات الناجحة مع Google. يمكنك إجراء ذلك بإحدى الطريقتَين التاليتَين:

ضبط إعدادات الموافقة التلقائية على مستوى الحساب في واجهة مستخدم "إعلانات Google"، انقر على الأدوات > إدارة بيانات إعلانات Google > إعدادات الموافقة > إعدادات الموافقة التلقائية.
اضبط حقل الموافقة على كل حمولة بيانات مستورَدة للإحالات الناجحة أو بيانات المستخدمين (على سبيل المثال، ClickConversion.consent أو CallConversion.consent أو UserData.consent).

إعداد موقعك الإلكتروني لتتبُّع الإحالات الناجحة

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

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

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

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

استرداد معلومات عن إعداد ميزة تتبُّع الإحالات الناجحة

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

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

يشير الحقل google_ads_conversion_customer إلى حساب "إعلانات Google" الذي ينشئ الإحالات الناجحة ويديرها لهذا العميل. بالنسبة إلى العملاء الذين يستخدمون ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، هذا هو رقم تعريف الحساب الإداري. يجب تقديم رقم تعريف العميل للإحالة الناجحة في "إعلانات Google" كـ customer_id في طلبات Google Ads API لإنشاء الإحالات الناجحة وإدارتها. يُرجى العِلم أنّه تتم تعبئة هذا الحقل حتى إذا لم يتم تفعيل ميزة تتبُّع الإحالات الناجحة.

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

إنشاء إجراء إحالة ناجحة ضمن عميل الإحالة الناجحة في "إعلانات Google"

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

يُرجى العِلم أنّه يتم تفعيل ميزة "الإحالات الناجحة المحسّنة" تلقائيًا عند إرسالها من خلال Google Ads API، ولكن يمكن إيقافها من خلال واجهة مستخدم "إعلانات Google".

مثال على الرمز

جافا

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

#C

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V25.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

PHP

    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

Python

def main(client: GoogleAdsClient, customer_id: str) -> None:
    conversion_action_service: ConversionActionServiceClient = (
        client.get_service("ConversionActionService")
    )

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

    # Create conversion action.
    conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = (
        conversion_action.value_settings
    )
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

    # Add the conversion action.
    conversion_action_response: MutateConversionActionsResponse = (
        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

Ruby

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}."
endadd_conversion_action.rb

Perl

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::V25::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V25::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V25::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

curl

تأكَّد من ضبط قيمة type على قيمة ConversionActionType الصحيحة. للحصول على مزيد من الإرشادات حول إنشاء إجراءات إحالات ناجحة في Google Ads API، يُرجى الاطّلاع على مقالة إنشاء إجراءات إحالات ناجحة.

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

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

SELECT
  conversion_action.id,
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.category,
  conversion_action.status
FROM conversion_action

WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'

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

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

تفعيل ميزة "تتبُّع الإحالات الناجحة في جميع الحسابات" في Google Ads API

يمكنك استخدام Google Ads API لتفعيل ميزة تتبُّع الإحالات الناجحة على مستوى حسابات متعدّدة عند إنشاء حسابات عملاء أو تعديلها.

في مورد Customer، اضبط الحقل conversion_tracking_setting.google_ads_conversion_customer على اسم مورد الحساب الإداري الذي يجب أن يدير إجراءات الإحالات الناجحة نيابةً عن حساب العميل.

يجب أن يرسل الطلبات التي تعدّل عميل الإحالة الناجحة لحساب عميل الحساب الإداري الذي سيصبح عميل الإحالة الناجحة الجديد للحساب. يمكنك إجراء ذلك من خلال ضبط login-customer-id على معرّف الحساب الإداري.

عند تفعيل ميزة تتبُّع الإحالات الناجحة في جميع الحسابات أو تبديل مدير تتبُّع الإحالات الناجحة لحساب عميل حالي، تنطبق التحذيرات نفسها كما لو كنت ستجري هذا التغيير في واجهة المستخدِم. على وجه التحديد:

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

استيراد الإحالات الناجحة على مستوى جميع الحسابات

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

لتحميل إحالة ناجحة بنجاح، يجب أن يكون لدى الحساب الذي يتم التحميل منه إذن الوصول إلى إجراء الإحالة الناجحة. في التدرّج الهرمي لتتبُّع الإحالات الناجحة في جميع الحسابات، يمكن للحساب الذي يتم تحميل البيانات منه الوصول إلى الإجراء إذا كان حسابًا رئيسيًا (إداريًا) أو حسابًا فرعيًا لحساب مالك إجراء الإحالة الناجحة في شجرة الحسابات.

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

بنية التفويض

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

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

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

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

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

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

مثال على الرمز

يوضّح مثال الرمز البرمجي التالي عملية إنشاء إجراء إحالة ناجحة جديد. على وجه التحديد، ينشئ إجراء إحالة ناجحة مع ضبط type على UPLOAD_CLICKS. يضبط هذا الإجراء أيضًا قيمة category على DEFAULT.

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

يضبط Google Ads API الحقل primary_for_goal تلقائيًا، ولكن يمكنك ضبط هذا الحقل بشكل صريح للتحكّم في تأثير إجراء الإحالة الناجحة في إعداد التقارير وتقديم عروض الأسعار في حسابك عند دمجه مع أهداف الإحالات الناجحة.
تضبط Google Ads API قيمة 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

#C

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V25.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

PHP

    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

Python

def main(client: GoogleAdsClient, customer_id: str) -> None:
    conversion_action_service: ConversionActionServiceClient = (
        client.get_service("ConversionActionService")
    )

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

    # Create conversion action.
    conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = (
        conversion_action.value_settings
    )
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

    # Add the conversion action.
    conversion_action_response: MutateConversionActionsResponse = (
        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

Ruby

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}."
endadd_conversion_action.rb

Perl

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::V25::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V25::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V25::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

curl

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

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

تتيح "إعلانات 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.

يجب أن تتراوح قيمة هذه السمة بين يوم واحد و60 يومًا لإجراء إحالة ناجحة من النوع AD_CALL أو WEBSITE_CALL. بالنسبة إلى معظم إجراءات الإحالات الناجحة الأخرى، يتراوح النطاق المسموح به بين يوم واحد و90 يومًا.

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. بالنسبة إلى معظم إجراءات الإحالات الناجحة، يتراوح النطاق المسموح به بين يوم واحد و30 يومًا.

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

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

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

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

الاستعداد لتقديم الموافقة

إعداد موقعك الإلكتروني لتتبُّع الإحالات الناجحة

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

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

استرداد معلومات عن إعداد ميزة تتبُّع الإحالات الناجحة

إنشاء إجراء إحالة ناجحة ضمن عميل الإحالة الناجحة في "إعلانات Google"

مثال على الرمز

جافا

#C

PHP

Python

Ruby

Perl

curl

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

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

تفعيل ميزة "تتبُّع الإحالات الناجحة في جميع الحسابات" في Google Ads API

استيراد الإحالات الناجحة على مستوى جميع الحسابات

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

مثال على الرمز

جافا

#C

PHP

Python

Ruby

Perl

curl

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

البدء