本頁面由 Cloud Translation API 翻譯而成。

建立轉換動作

本指南將說明您可以採用的各種轉換動作類型請使用 Google Ads API 建立、瞭解這些對應如何對應到 Google Ads 網頁的相關資訊介面，以及詳細的程式碼範例，讓您可以瞭解如何建立新的轉換動作。

如要評估轉換，請設定 ConversionAction 用於 type/ 您要追蹤的轉換動作例如線上購物和手機來電需要不同的轉換動作

在 API 中設定新轉換動作的最佳方式，就是使用在下方新增轉換動作程式碼範例。樣本控點並逐步解說如何建立 ConversionAction。

大多數的轉換動作也需要您採取額外步驟才能追蹤具體做法是指示 Kubernetes 建立並維護一或多個代表這些 Pod 的物件舉例來說，若要追蹤網站上的轉換，您必須加入程式碼名為代碼的程式碼片段將使用者帶往網站的轉換頁。其他轉換動作相關規定，請參閱說明中心文章。

網站轉換

網站轉換可讓您追蹤線上銷售、連結點擊次數、網頁瀏覽次數和註冊人數。

若要追蹤網站上的轉換，您必須建立 ConversionAction 使用 ConversionActionType 設為 WEBPAGE，並在轉換中加入一個名為標記的程式碼片段網站上的網頁。

ConversionAction 包含可以區分出不同類型的網站轉換類型每個路徑中的 type 欄位 TagSnippet列於 tag_snippets 欄位 ConversionAction。

TagSnippet 會提供追蹤程式碼，加進網站，以便追蹤轉換動作。「網站」和「電話號碼點擊」轉換需要收集 event_snippet, 則應放置於指定轉換動作的網頁上，例如結帳確認或待開發客戶表單提交頁面 global_site_tag, 這個 API 必須安裝在網站的每個網頁上您可以擷取使用 ConversionActionService。退房日說明中心。

下表列出了各參數適用的對等 API 參數 Google Ads 網頁介面中的資料來源：

追蹤程式碼類型	Google Ads 來源
`WEBPAGE`	網站、網站 (Google Analytics (GA4))
`WEBPAGE_ONCLICK`	網站、網站 (Google Analytics (GA4))
`CLICK_TO_CALL`	電話號碼點擊
`---`	網站 (Google Analytics)

應用程式轉換

應用程式轉換可讓您追蹤下列來源帶來的行動應用程式安裝或應用程式內購： Google Play 商店。

下表列出了 ConversionActionType 用於 Google Ads 網頁介面中的每個「來源」的 API 參數：

轉換動作類型	Google Ads 來源
`GOOGLE_PLAY_DOWNLOAD`	Google Play >安裝次數
`GOOGLE_PLAY_IN_APP_PURCHASE`	Google Play >應用程式內購

如要使用 Google Analytics 4 追蹤其他行動應用程式動作資源或第三方應用程式數據分析。請參閱「其他轉換動作類型」一文。

來電轉換

來電轉換追蹤追蹤廣告轉接來電、網站上電話號碼獲得的來電行動網站上的電話號碼獲得的點擊。

下表列出了 ConversionActionType 用於 Google Ads 網頁介面中的每個「來源」的 API 參數：

轉換動作類型	Google Ads 來源
`AD_CALL`	來電額外資訊或來電專用廣告所獲得的來電
`WEBSITE_CALL`	您網站上的電話號碼所獲得的來電
`CLICK_TO_CALL`	您行動網站上電話號碼獲得的點擊

CLICK_TO_CALL 類型與 AD_CALL 類型不同不會追蹤實際的來電。CLICK_TO_CALL 只會追蹤使用者透過行動裝置的電話號碼。如果您無法使用用於追蹤來電的 Google 轉接號碼。

`AD_CALL`

一個 AD_CALL 轉換動作會顯示為來自 Google Ads 轉換網頁介面上。建立「AD_CALL」轉換動作後，請指定轉換動作建立 Deployment 時call_conversion_action CallAsset。電話資產可讓您直接在廣告中加入電話號碼。

如果來電通話時間超過指定時間長度，就會計為一次轉換。預設值為 60 秒。

`WEBSITE_CALL`

A 罩杯 WEBSITE_CALL 轉換動作會顯示為 個網站轉換 Google Ads 網頁介面。

取消喜歡 AD_CALL, 這個追蹤器需要 event_snippet 和 global_site_tag 會新增到您的網站，擷取用於通話追蹤的動態 Google 轉接號碼網站上列出的電話號碼此外，您必須設定通話資產和客戶、廣告活動或廣告群組層級

匯入離線轉換

下表列出了 ConversionActionType 用於 Google Ads 網頁介面中的每個「來源」的 API 參數以及各種特定轉換動作類型的說明文件連結：

轉換動作類型	Google Ads 來源	API 設定指南
`UPLOAD_CLICKS`	追蹤點擊和強化轉換所帶來的轉換待開發客戶	上傳點擊指南加強型待開發客戶轉換指南
`UPLOAD_CALLS`	追蹤來電所帶來的轉換	API 設定指南
`STORE_SALES`	追蹤轉換商店銷售	API 設定指南

網站強化轉換

強化轉換網頁可讓您傳送 WEBPAGE 個轉換動作的第一方轉換資料，效期為 24 小時內而不是同時完成轉換事件如此一來來自客戶資料庫或客戶關係管理等各種來源的第一方資料有些人會將 Cloud Storage 視為檔案系統但實際上不是

其他轉換動作類型

Google Ads API 在報表中提供其他類型的轉換動作但可能會限製或禁止建立或修改這類行為。

SKAdNetwork 轉換

若您放送 iOS 應用程式廣告活動而且已經導入 SKAdNetwork 透過CustomerCampaign 以下資源：

報表欄位	說明
`metrics.sk_ad_network_installs`	Apple 回報的安裝次數。這項指標只能區隔任意的 `segments.sk_ad_network_conversion_value` 和日期相關區隔
`metrics.sk_ad_network_total_conversions`	轉換總次數，包括安裝和其他類型的轉換次數。這項指標只能依據 SKAdNetwork 相關區隔和日期相關區隔。
`segments.sk_ad_network_ad_event_type`	特定轉換發生的事件類型。
`segments.sk_ad_network_attribution_credit`	系統如何分配特定轉換的功勞。
`segments.sk_ad_network_fine_conversion_value`	Apple 記錄的轉換價值。無法套用這個區隔套用至 `metrics.sk_ad_network_installs` 以外的任何指標 `metrics.sk_ad_network_total_conversions`和只能與日期相關區隔合併如果 Apple 回報 `0` 的值為 `0`，否則無任何值。查看欄位是否存在，以區分這兩種情況。
`segments.sk_ad_network_coarse_conversion_value`	個別轉換的粗略價值。
`segments.sk_ad_network_postback_sequence_index`	特定轉換的回傳順序 (以順序排列)。
`segments.sk_ad_network_source_app.sk_ad_network_source_app_id`	帶來 iOS Store Kit Kit Network Network 安裝的廣告的應用程式 ID 。
`segments.sk_ad_network_source_domain`	促成 iOS Store Kit Kit Network Network 安裝的廣告的網站之前。如果值為空值，表示這個區隔不適用。舉例來說，非 iOS 廣告活動，或未出現在 Apple 傳送的任何回傳中。
`segments.sk_ad_network_source_type`	促成 iOS Store Kit Kit Network Network 安裝的廣告來源類型。如果值為空值，表示這個區隔不適用。舉例來說，非 iOS 廣告活動，或來源網域和來源應用程式皆不存在由 Apple 傳送的所有回傳。
`segments.sk_ad_network_user_type`	產生特定轉換的使用者類型。
`segments.sk_ad_network_redistributed_fine_conversion_value`	這個區隔中的轉換價值包含重新分配到轉換價值。這個區隔代表觀察到的精確轉換價值 (由 Apple 傳回) 和模擬的空值都是由 Google 開發的
`segments.sk_ad_network_version`	所用的 iOS Store Kit Ad Network API 版本。

您也可以針對特定已連結的特定連結，儲存 SKAdNetwork 轉換價值對應透過 CustomerSkAdNetworkConversionValueSchema 使用 iOS 版應用程式的客戶。

Python 程式碼範例

#!/usr/bin/env python
# Copyright 2019 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

import argparse
import sys

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException

def main(client, customer_id):
    """Adds a keyword plan, campaign, ad group, etc. to the customer account.

    Also handles errors from the API and prints them.

    Args:
        client: An initialized instance of GoogleAdsClient
        customer_id: A str of the customer_id to use in requests.
    """

    res = update_skan_cv_schema(
        client, customer_id, "my_app_id", "account_link_id"
    )
    print(res)

def update_skan_cv_schema(client, customer_id, app_id, account_link_id):
    skan_service = client.get_service(
        "CustomerSkAdNetworkConversionValueSchemaService"
    )

    req = client.get_type(
        "MutateCustomerSkAdNetworkConversionValueSchemaRequest"
    )
    operation = client.get_type(
        "CustomerSkAdNetworkConversionValueSchemaOperation"
    )
    schema_instance = client.get_type(
        "CustomerSkAdNetworkConversionValueSchema"
    )

    new_schema = operation.update
    new_schema.resource_name = (
        skan_service.customer_sk_ad_network_conversion_value_schema_path(
            "customer_id", "account_link_id"
        )
    )
    new_schema.schema.app_id = app_id
    new_schema.schema.measurement_window_hours = 48

    skan_cv_mapping = (
        schema_instance.SkAdNetworkConversionValueSchema.FineGrainedConversionValueMappings()
    )
    skan_cv_mapping.fine_grained_conversion_value = 0  # 0 - 63
    skan_cv_mapping.conversion_value_mapping.min_time_post_install_hours = 0
    skan_cv_mapping.conversion_value_mapping.max_time_post_install_hours = 48

    skan_cv_event = schema_instance.SkAdNetworkConversionValueSchema.Event()
    skan_cv_event.mapped_event_name = "TEST"
    skan_cv_event.event_revenue_value = 10

    skan_cv_mapping.conversion_value_mapping.mapped_events.append(skan_cv_event)
    new_schema.schema.fine_grained_conversion_value_mappings.append(
        skan_cv_mapping
    )

    req.operation = operation
    req.customer_id = customer_id

    res = skan_service.mutate_customer_sk_ad_network_conversion_value_schema(
        req
    )
    return res

if __name__ == "__main__":
    # GoogleAdsClient will read the google-ads.yaml configuration file in the
    # home directory if none is specified.
    googleads_client = GoogleAdsClient.load_from_storage(
        version="v17"
    )

    parser = argparse.ArgumentParser(
        description="Creates a keyword plan for specified customer."
    )
    # The following argument(s) should be provided to run the example.
    parser.add_argument(
        "-c",
        "--customer_id",
        type=str,
        required=True,
        help="The Google Ads customer ID.",
    )
    args = parser.parse_args()

    try:
        main(googleads_client, args.customer_id)
    except GoogleAdsException as ex:
        print(
            f'Request with ID "{ex.request_id}" failed with status '
            f'"{ex.error.code().name}" and includes the following errors:'
        )
        for error in ex.failure.errors:
            print(f'\tError with message "{error.message}".')
            if error.location:
                for field_path_element in error.location.field_path_elements:
                    print(f"\t\tOn field: {field_path_element.field_name}")
        sys.exit(1)

Google Analytics

已連結 Google Analytics 資源的轉換包含下列其中一種 type 值：

GA4 資源轉換：
- GOOGLE_ANALYTICS_4_CUSTOM
- GOOGLE_ANALYTICS_4_PURCHASE
您也可以從以下位置擷取 GA4 資源 ID、資源名稱和事件名稱：這個 google_analytics_4_settings ] 欄位。
通用 Analytics 資源轉換：
- UNIVERSAL_ANALYTICS_GOAL
- UNIVERSAL_ANALYTICS_TRANSACTION

您可以對 GA4 資源轉換進行以下變更：

透過下列方式將轉換資料從 GA4 資源匯入 Google Ads 帳戶：將其 status 欄位從 HIDDEN 修改為 ENABLED。
修改其 primary_for_goal 和 category 欄位，表明應如何影響 Google Ads 出價和報表
更新其 name 或 value_settings。
使用 remove 作業，將轉換從 Google Ads 帳戶中移除。

任何嘗試修改已匯入 GA4 轉換的其他屬性或任何匯入的通用 Analytics 轉換屬性會產生 MUTATE_NOT_ALLOWED 錯誤。只能透過 Google Ads 使用者介面進行變更。

Firebase 和第三方應用程式數據分析

匯入第三方應用程式數據分析或 Firebase 轉換將 status 的 ConversionAction從 HIDDEN 到 ENABLED，使用 mutate 方法 ConversionActionService。更新 app_id不適用於這些國家/地區轉換動作。

FIREBASE_ANDROID_FIRST_OPEN
FIREBASE_ANDROID_IN_APP_PURCHASE
FIREBASE_ANDROID_CUSTOM
FIREBASE_IOS_FIRST_OPEN
FIREBASE_IOS_IN_APP_PURCHASE
FIREBASE_IOS_CUSTOM
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

商店銷售額

雖然您無法建立STORE_SALES或STORE_SALES_DIRECT_UPLOAD 轉換動作，且此 API 支援上傳商店銷售交易。

STORE_SALES
STORE_SALES_DIRECT_UPLOAD

其他

下列轉換動作類型在 Google Ads API 中為唯讀，且已提供以便製作報表

ANDROID_APP_PRE_REGISTRATION
ANDROID_INSTALLS_ALL_OTHER_APPS
FLOODLIGHT_ACTION
FLOODLIGHT_TRANSACTION
GOOGLE_HOSTED
LEAD_FORM_SUBMIT
SALESFORCE
SEARCH_ADS_360
SMART_CAMPAIGN_AD_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
SMART_CAMPAIGN_TRACKED_CALLS
STORE_VISITS
WEBPAGE_CODELESS

不明

如果 Google Ads 帳戶包含其他類型的轉換動作，您可能會看到在查詢和記錄中，系統會傳回 ConversionAction.type為 UNKNOWN。 API 不支援管理這些轉換動作，但會在並為重要轉換指標提供完整結果，例如《metrics.conversions》和《metrics.conversions_value》。

程式碼範例

以下程式碼範例將逐步引導您建立新的轉換動作。具體來說，這項功能會使用 type已設為 UPLOAD_CLICKS。這與使用以下 Google Ads UI 建立新轉換動作的流程相同： 匯入 >使用 API 或上傳功能手動匯入 >追蹤轉換來源點擊。它也會設定 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.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

小茹

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

您也可以在用戶端程式庫的「再行銷」資料夾中找到此範例在程式碼範例集合中：新增轉換動作程式碼範例。

驗證

Google Ads 和 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 Ads 僅支援 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

「WEBSITE_CALL」或「AD_CALL」轉換動作的value_settings必須將 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 錯誤。

開始使用

上傳點擊轉換