يجب تفعيل ميزة تتبُّع الإحالات الناجحة في حساب الإحالات الناجحة على "إعلانات 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
.
تنطبق الإعدادات التلقائية التالية:
تضبط 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()); } } }
#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
.