البدء

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

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

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

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

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

Java

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());
    }
  }
}
      

#C

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

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
        );
    }
}
      

Python

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}".'
    )
      

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}."
end
      

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

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

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

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

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

SELECT
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'

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

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

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

اعتبارًا من v19.1، يمكنك استخدام Google Ads API لتفعيل ميزة تتبُّع الإحالات الناجحة على مستوى الحسابات عندما تنشئ حسابات عملاء.

عند إنشاء Customer جديد، اضبط conversion_tracking_setting.google_ads_conversion_customer على اسم المورد الخاص بالحساب الإداري الذي يجب أن يدير إجراءات الإحالات الناجحة نيابةً عن حساب العميل. يجب أن يكون هذا الحساب الإداري أيضًا هو الحساب الذي يرسل طلب create لإنشاء حساب العميل الجديد.

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

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

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

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

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

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

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

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

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

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

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

Java

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());
    }
  }
}
      

#C

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

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
        );
    }
}
      

Python

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}".'
    )
      

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}."
end
      

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

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

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

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

تتيح "إعلانات 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 مضبوطًا على true.always_use_default_value يؤدي تحديد قيمة false عند إنشاء هذه القيمة أو تعديلها إلى حدوث خطأ INVALID_VALUE.

view_through_lookback_window_days

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

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