البدء

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

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

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

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

تفعيل ميزة تتبُّع الإحالات الناجحة في حساب الإحالات الناجحة على "إعلانات 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());
    }
  }
}
AddConversionAction.java
      

#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;
    }
}
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, 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
      

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
add_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::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;
}
add_conversion_action.pl
      

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

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

يمكنك استرداد تفاصيل إجراء إحالة ناجحة حالي عن طريق إصدار QUERY التالي: تأكّد من ضبط الرقم التعريفي للعميل في الطلب على العميل الذي أجرى الإحالة الناجحة في "إعلانات 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.

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

• تضبط 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. يُرجى الاطّلاع على مقالة مركز المساعدة هذه لمعرفة المزيد من المعلومات عن نماذج تحديد المصدر.

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

#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;
    }
}
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, 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
      

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
add_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::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;
}
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.