شروع به کار

برای ثبت تبدیل‌ها، باید ردیابی تبدیل را در حساب تبدیل گوگل ادز خود فعال کنید. این راهنما جزئیاتی در مورد نحوه تأیید فعال بودن ردیابی تبدیل، فعال کردن آن در صورت فعال نبودن و بازیابی اطلاعات مربوط به اقدامات تبدیل موجود ارائه می‌دهد.

اکثر اقدامات تبدیل همچنین به مراحل اضافی از طرف شما برای ردیابی آنها نیاز دارند. برای اطلاعات بیشتر در مورد انواع مختلف اقدامات تبدیل و الزامات آنها، به راهنمای ایجاد اقدامات تبدیل مراجعه کنید.

بسیار مهم است که تأیید کنید اجازه اشتراک‌گذاری داده‌های تبدیل با گوگل را دارید. این کار را می‌توان به یکی از دو روش زیر انجام داد:

  1. تنظیمات رضایت پیش‌فرض در سطح حساب را پیکربندی کنید. در رابط کاربری گوگل ادز ، روی ابزارها -> مدیر داده -> تنظیمات رضایت -> تنظیمات رضایت پیش‌فرض کلیک کنید.
  2. فیلد ClickConversion.consent را برای هر تبدیل وارد شده تنظیم کنید.

وب‌سایت خود را برای ردیابی تبدیل‌ها تنظیم کنید

اگر در حال شروع یکپارچه‌سازی واردات تبدیل آفلاین خود هستید، اولین قدم این است که مراحل موجود در راهنمای «پیکربندی برچسب گوگل برای تبدیل‌های پیشرفته برای سرنخ‌ها» را دنبال کنید تا وب‌سایت خود را برای ردیابی تبدیل‌های پیشرفته برای سرنخ‌ها پیکربندی کنید. همچنین می‌توانید با دنبال کردن مراحل موجود در راهنمای «پیکربندی برچسب گوگل برای تبدیل‌های پیشرفته برای سرنخ‌ها» ، از Google Tag Manager برای پیکربندی وب‌سایت خود استفاده کنید.

ردیابی تبدیل را در حساب تبدیل گوگل ادز خود فعال کنید

اطلاعات مربوط به تنظیمات ردیابی تبدیل خود را بازیابی کنید

شما می‌توانید تنظیمات ردیابی تبدیل حساب کاربری خود را بررسی کنید و با جستجوی منبع 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 نشان‌دهنده حساب کاربری گوگل ادز است که تبدیل‌ها را برای این مشتری ایجاد و مدیریت می‌کند. برای مشتریانی که از ردیابی تبدیل بین حساب‌های کاربری استفاده می‌کنند، این شناسه یک حساب کاربری مدیر است. شناسه مشتری تبدیل گوگل ادز باید به عنوان customer_id در درخواست‌های API گوگل ادز برای ایجاد و مدیریت تبدیل‌ها ارائه شود. توجه داشته باشید که این فیلد حتی اگر ردیابی تبدیل فعال نباشد، پر می‌شود.

فیلد conversion_tracking_status نشان می‌دهد که آیا ردیابی تبدیل فعال است و آیا حساب از ردیابی تبدیل بین حساب‌ها استفاده می‌کند یا خیر.

یک اقدام تبدیل در زیر بخش مشتری تبدیل گوگل ادز ایجاد کنید

اگر مقدار conversion_tracking_status NOT_CONVERSION_TRACKED باشد، ردیابی تبدیل برای حساب فعال نشده است. با ایجاد حداقل یک ConversionAction در حساب تبدیل گوگل ادز، مانند مثال زیر، ردیابی تبدیل را فعال کنید. همچنین می‌توانید با دنبال کردن دستورالعمل‌های موجود در مرکز راهنما برای نوع تبدیلی که می‌خواهید فعال کنید، یک عمل تبدیل در رابط کاربری ایجاد کنید.

توجه داشته باشید که تبدیل‌های پیشرفته هنگام ارسال از طریق API تبلیغات گوگل به طور خودکار فعال می‌شوند، اما می‌توان آنها را از طریق رابط کاربری تبلیغات گوگل غیرفعال کرد.

مثال کد

جاوا

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

سی شارپ

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

پی اچ پی

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