이 페이지는 Cloud Translation API를 통해 번역되었습니다.

웹용 향상된 전환 시작하기

웹용 향상된 전환의 작동 방식

웹용 향상된 전환을 사용하려면 Google Ads에 주문 ID(예: GCLID)와 주문 ID를 제공합니다. 전환을 유도할 수 있습니다. Google Google 태그 관리자는 Google 태그 또는 Google Ads API입니다. Google Ads API를 사용하면 퍼스트 파티 전환 데이터를 24시간 이내에 전송할 수 몇 시간 동안 녹화할 수 있는지를 알아야 합니다. 이렇게 하면 이를 통해 고객 데이터베이스 또는 CRM 시스템입니다.

Google Ads API의 웹용 향상된 전환은 다음 항목의 3단계를 보완합니다. 있습니다.

향상된 전환:
웹

사용자가 전환할 때 태그는 해싱된 사용자 정보를 전송하는 대신 GCLID와 주문 ID만 전송하고 광고주가 해싱된 사용자 정보를 전송합니다. 나중에 해싱된 데이터와 함께 주문 ID를 업로드합니다.

기본 요건 구현

향상된 전환을 제대로 설정하려면 몇 가지 기본 요건이 있습니다. 구현을 진행하기 전에 모든 기본 요건을 충족해야 합니다.

Google Ads 전환 고객의 전환 추적을 사용 설정합니다.
고객 데이터 약관에 동의합니다.
태그 지정을 구성합니다.

1. Google Ads 전환 고객의 전환 추적 사용 설정하기

전환 추적 설정에 대한 정보 가져오기

계정의 전환 추적 설정을 확인하고 전환을 확인할 수 있습니다. 추적은 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 Ads 계정을 나타냅니다. 이 고객에 대한 전환을 생성하고 관리합니다. 다음을 사용하는 고객의 경우: 교차 계정 전환 추적 관리자 계정의 ID입니다. Google Ads 전환 고객 ID는 다음과 같아야 합니다. 전환을 생성하고 관리하기 위한 Google Ads API 요청에서 customer_id로 제공됩니다. 이 필드는 전환 추적을 사용 설정하지 않은 경우에도 채워집니다.

이 conversion_tracking_status 드림 전환 추적의 사용 설정 여부와 계정 교차 계정 전환 추적을 사용하는 경우

Google Ads 전환 고객 아래에 전환 액션 생성

conversion_tracking_status 값이 NOT_CONVERSION_TRACKED인 경우 계정에 전환 추적을 사용 설정하지 않은 경우 전환 추적 사용 하나 이상의 ConversionAction을(를) 만들어 Google Ads 전환 계정에 연결할 수 있습니다 또는 다음 안내에 따라 UI에서 전환 액션을 만들 수 있습니다. 고객센터에서 전환 유형을 선택합니다.

향상된 전환은 Google Ads API를 통해 제공되지만 Google Ads UI를 통해 사용 중지할 수 있습니다.

</ph> 중요: 웹용 향상된 전환의 경우 conversion_action_type는 WEBPAGE로 설정해야 합니다. 또한 <ph type="x-smartling-placeholder">conversion_action_category</ph> 카테고리를 추가하세요.

코드 예

자바

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

Perl

sub add_conversion_action {
  my ($api_client, $customer_id) = @_;

  # Note that conversion action names must be unique.
  # If a conversion action already exists with the specified conversion_action_name,
  # the create operation fails with error ConversionActionError.DUPLICATE_NAME.
  my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid();

  # Create a conversion action.
  my $conversion_action =
    Google::Ads::GoogleAds::V17::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V17::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에서 전환 액션을 만드는 방법을 자세히 알아보려면 전환 액션 만들기를 참고하세요.

기존 전환 액션 가져오기

기존 전환 액션의 세부정보를 검색하려면 찾을 수 있습니다. 요청의 고객 ID가 Google Ads로 설정되어 있는지 확인합니다. 전환 액션 유형이 설정되어 있음 올바른 ConversionActionType 드림 값으로 사용됩니다.

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

2. 고객 데이터 약관 동의

향상된 전환을 사용하려면 먼저 고객 데이터 약관에 동의해야 합니다. 웹용입니다. 다음에서 고객 데이터 약관에 동의했는지 확인할 수 있습니다. Google Ads 전환 고객에 대해 다음 쿼리를 실행합니다.

SELECT
  customer.id,
  customer.conversion_tracking_setting.accepted_customer_data_terms
FROM customer

accepted_customer_data_terms이 false인 경우 다음 안내를 따르세요. 고객센터 수료해야 합니다

3. 태그 구성

다음 안내에 따라 웹사이트에 태그를 구성할 수 있습니다. 고객센터.

또한 거래 ID(주문 ID라고도 함)를 전환에 추가해야 합니다. 도움말 센터의 안내에 따라 추적 태그를 실행하십시오. 중앙으로 이동합니다. Google Ads에서는 다음이 필요합니다. 이를 통해 향상할 전환을 찾을 수 있습니다.

다음 단계

기본 요건을 충족하면 고급 기능을 구현할 준비가 된 것입니다. 웹용 전환 Google Ads API

개요

구현