สร้างการกระทําที่ถือเป็น Conversion

คู่มือนี้จะแสดงรายการการกระทำที่ถือเป็น Conversion ประเภทต่างๆ ที่คุณสามารถ สร้างโดยใช้ Google Ads API ซึ่งจะบอกวิธีแมปเหล่านี้ในเว็บ Google Ads ของอินเทอร์เฟซ และตัวอย่างโค้ดโดยละเอียดที่สาธิตวิธีการ สร้างการกระทำที่ถือเป็น Conversion รายการใหม่

ในการวัด Conversion ให้ตั้งค่า ConversionAction สำหรับ type จาก การกระทำที่ถือเป็น Conversion ที่ต้องการติดตาม เช่น การซื้อออนไลน์และโทรศัพท์ การโทรต้องมีการกระทำที่ถือเป็น Conversion ต่างกัน

วิธีที่ดีที่สุดในการสร้างการกระทำที่ถือเป็น Conversion ใหม่ใน API คือการใช้ เพิ่มตัวอย่างโค้ดการกระทำที่ถือเป็น Conversion ด้านล่าง แฮนเดิลตัวอย่าง งานการตรวจสอบสิทธิ์ในเบื้องหลังทั้งหมดให้กับคุณ และแนะนำคุณตลอดการสร้าง ConversionAction

การกระทำที่ถือเป็น Conversion ส่วนใหญ่จำเป็นต้องมีขั้นตอนเพิ่มเติมเพื่อติดตาม ให้พวกเขา เช่น คุณต้องเพิ่มโค้ดเพื่อติดตาม Conversion ในเว็บไซต์ ข้อมูลโค้ดที่เรียกว่าแท็ก ไปยังหน้า Conversion ในเว็บไซต์ของคุณ สำหรับการกระทำที่ถือเป็น Conversion อื่นๆ โปรดดู บทความในศูนย์ช่วยเหลือ

Conversion ของเว็บไซต์

Conversion ในเว็บไซต์ช่วยให้คุณติดตามการกระทำในเว็บไซต์ เช่น ยอดขายออนไลน์ การคลิกลิงก์ การดูหน้าเว็บ และการลงชื่อสมัครใช้

ในการติดตาม Conversion ในเว็บไซต์ คุณต้องสร้าง ConversionAction พร้อมด้วย ConversionActionType ตั้งค่าเป็น WEBPAGE แล้วเพิ่มข้อมูลโค้ดที่เรียกว่าแท็กลงใน Conversion เว็บไซต์ของคุณ

ConversionAction ครอบคลุม ประเภท Conversion ในเว็บไซต์โดยแยกความแตกต่างภายใน API ตาม ช่อง type ในแต่ละช่อง TagSnippet แสดงอยู่ใน tag_snippets ฟิลด์ ConversionAction

TagSnippet มีโค้ดติดตามที่ต้อง ลงในเว็บไซต์เพื่อติดตามการกระทำที่ถือเป็น Conversion Conversion เว็บไซต์และการคลิกหมายเลขโทรศัพท์ต้องมีค่า event_snippet, ซึ่งควรวางไว้บนหน้าเว็บที่ระบุการกระทำที่ถือเป็น Conversion เช่น การยืนยันการชำระเงินหรือหน้าการส่งแบบฟอร์มสำหรับรวบรวมข้อมูลลูกค้า และ global_site_tag, ซึ่งจะต้องติดตั้งในทุกหน้าของเว็บไซต์ คุณสามารถดึงข้อมูล เหล่านี้ด้วยแอตทริบิวต์ ConversionActionService เช็คเอาต์ ศูนย์ช่วยเหลือของเราเพื่อดูข้อมูลเพิ่มเติม ข้อมูลเกี่ยวกับวิธีติดแท็กหน้าเว็บ

ตารางต่อไปนี้แสดงพารามิเตอร์ API ที่เทียบเท่าซึ่งใช้สำหรับแต่ละ แหล่งที่มาในอินเทอร์เฟซเว็บของ Google Ads

Conversion ในแอป

Conversion ของแอปช่วยให้คุณติดตามการติดตั้งแอปบนอุปกรณ์เคลื่อนที่หรือการซื้อในแอปจาก Google Play Store

ตารางต่อไปนี้แสดงค่าที่เทียบเท่า ConversionActionType พารามิเตอร์ของ API ที่จะใช้สำหรับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads

หากต้องการติดตามการกระทําอื่นๆ ของแอปบนอุปกรณ์เคลื่อนที่โดยใช้ Google Analytics 4 พร็อพเพอร์ตี้ หรือ การวิเคราะห์แอปจากบุคคลที่สาม ดูประเภทการกระทำที่ถือเป็น Conversion เพิ่มเติม

Conversion การโทร

การวัด Conversion การโทร ช่วยให้คุณติดตามการโทรจากโฆษณา การโทรไปยังหมายเลขบนเว็บไซต์ และ คลิกหมายเลขในเว็บไซต์บนอุปกรณ์เคลื่อนที่

ตารางต่อไปนี้แสดงค่าที่เทียบเท่า ConversionActionType พารามิเตอร์ของ API ที่จะใช้สำหรับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads

ประเภท CLICK_TO_CALL แตกต่างจากประเภท AD_CALL ไม่ติดตามการโทรจริง แต่ CLICK_TO_CALL จะติดตามเฉพาะการคลิกบน หมายเลขโทรศัพท์จากอุปกรณ์เคลื่อนที่ ซึ่งจะเป็นประโยชน์เมื่อคุณไม่สามารถใช้ หมายเลขโอนสายของ Google สําหรับการติดตามการโทร

AD_CALL

CANNOT TRANSLATE AD_CALL การกระทำที่ถือเป็น Conversion แสดงเป็นการโทรจาก ads Conversion ใน Google Ads อินเทอร์เฟซเว็บ หลังจากสร้างการกระทำที่ถือเป็น Conversion AD_CALL รายการแล้ว ให้ระบุ ชื่อทรัพยากรในช่อง call_conversion_action เมื่อคุณสร้าง CallAsset โทร เนื้อหาจะช่วยให้คุณแสดง หมายเลขโทรศัพท์ในโฆษณาของคุณโดยตรง

ระบบจะรายงานการโทรเป็น Conversion หากมีระยะเวลานานกว่าระยะเวลาที่ระบุ ค่าเริ่มต้นคือ 60 วินาที

WEBSITE_CALL

ต WEBSITE_CALL การกระทำที่ถือเป็น Conversion แสดงเป็นการโทรจาก Conversion ของเว็บไซต์ใน อินเทอร์เฟซเว็บของ Google Ads

เลิกชอบ AD_CALL, อุปกรณ์ติดตามนี้ต้องใช้ event_snippet และ global_site_tag จะเพิ่มใน เว็บไซต์ของคุณเพื่อดึงข้อมูลหมายเลขโอนสายของ Google แบบไดนามิกสำหรับการติดตามการโทร จากหมายเลขที่แสดงในเว็บไซต์ของคุณ นอกจากนี้คุณต้องตั้งค่าการโทร ชิ้นงานและลิงก์ชิ้นงานที่ ระดับลูกค้า แคมเปญ หรือกลุ่มโฆษณา

นำเข้า Conversion ออฟไลน์

ตารางต่อไปนี้แสดงค่าที่เทียบเท่า ConversionActionType พารามิเตอร์ของ API ที่จะใช้สำหรับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads และลิงก์ไปยังเอกสารประกอบสำหรับการกระทำที่ถือเป็น Conversion แต่ละประเภท

Conversion ที่ปรับปรุงแล้วสําหรับเว็บ

Conversion ที่ปรับปรุงแล้วสำหรับ เว็บให้คุณส่ง ข้อมูล Conversion จากบุคคลที่หนึ่งสําหรับการกระทําที่ถือเป็น Conversion WEBPAGE รายการภายใน 24 ชั่วโมงนับจาก เหตุการณ์ Conversion แทนที่จะเกิดขึ้นในเวลาเดียวกัน ทำให้คุณสามารถระบุตำแหน่ง ข้อมูลจากบุคคลที่หนึ่งจากแหล่งที่มาต่างๆ เช่น ฐานข้อมูลลูกค้าหรือ CRM ระบบ

ประเภทการกระทำที่ถือเป็น Conversion เพิ่มเติม

Google Ads API ทําให้การกระทําที่ถือเป็น Conversion ประเภทอื่นๆ พร้อมใช้งานในรายงาน แต่อาจจำกัดหรือห้ามการสร้างหรือแก้ไขการกระทำเหล่านั้น

Conversion ของ SKAdNetwork

หากคุณใช้ App Campaign สำหรับ iOS และได้ดำเนินการ SKAdNetwork คุณสามารถเข้าถึง ข้อมูล SKAdNetwork ที่ให้ไว้กับ Google ที่ระดับ Customer และ Campaign โดยใช้ แหล่งข้อมูลต่อไปนี้

คุณยังบันทึกการแมปมูลค่า Conversion ของ SKAdNetwork สําหรับลิงก์ที่เจาะจงได้ด้วย ลูกค้าที่มีแอป iOS ผ่านทาง CustomerSkAdNetworkConversionValueSchema

#!/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

Conversion จากพร็อพเพอร์ตี้ Google Analytics ที่ลิงก์มีข้อใดข้อหนึ่งต่อไปนี้ ค่า type มีดังนี้

• Conversion ของพร็อพเพอร์ตี้ GA4:

  • GOOGLE_ANALYTICS_4_CUSTOM
  • GOOGLE_ANALYTICS_4_PURCHASE

  คุณยังดึงข้อมูลรหัสพร็อพเพอร์ตี้ ชื่อพร็อพเพอร์ตี้ และชื่อเหตุการณ์ GA4 จาก เวลา google_analytics_4_settings ด้วย

• Conversion ของพร็อพเพอร์ตี้ Universal Analytics:

  • UNIVERSAL_ANALYTICS_GOAL
  • UNIVERSAL_ANALYTICS_TRANSACTION

คุณสามารถทําการเปลี่ยนแปลงต่อไปนี้กับ Conversion ของพร็อพเพอร์ตี้ GA4

• นําเข้า Conversion จากพร็อพเพอร์ตี้ GA4 ไปยังบัญชี Google Ads โดย กำลังแก้ไขช่อง status จาก HIDDEN เป็น ENABLED
• แก้ไขช่อง primary_for_goal และ category เพื่อระบุวิธีการ ส่งผลต่อการเสนอราคาและรายงานของ Google Ads
• อัปเดตnameหรือvalue_settings
• นำ Conversion ออกจากบัญชี Google Ads โดยใช้การดำเนินการ remove

การพยายามแก้ไขแอตทริบิวต์อื่นๆ ของ Conversion ของ GA4 ที่นําเข้าหรือรายการใดก็ได้ ของ Conversion ของ Universal Analytics ที่นําเข้า ข้อผิดพลาด MUTATE_NOT_ALLOWED รายการ คุณจะทำการเปลี่ยนแปลงได้โดยใช้ UI ของ Google Ads เท่านั้น

การวิเคราะห์แอป Firebase และแอปของบุคคลที่สาม

วิธีนำเข้า การวิเคราะห์แอปจากบุคคลที่สาม หรือ Firebase เปลี่ยน status ของ ConversionAction จาก HIDDEN ถึง ENABLED โดยใช้เมธอด mutate ของ ConversionActionService กำลังอัปเดต app_id ไม่รองรับแคมเปญเหล่านี้ การกระทำที่ถือเป็น Conversion

• 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 ไม่ได้ การกระทำที่ถือเป็น Conversion โดยใช้ Google Ads API, API จะรองรับการอัปโหลด Store ธุรกรรมการขาย

• STORE_SALES
• STORE_SALES_DIRECT_UPLOAD

เบ็ดเตล็ด

ประเภทการกระทำที่ถือเป็น Conversion ต่อไปนี้เป็นแบบอ่านอย่างเดียวใน 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 มีการกระทําที่ถือเป็น Conversion ประเภทอื่นๆ คุณอาจเห็น คำค้นหาและรายงานส่งคืนการกระทำที่ถือเป็น Conversion โดยที่ ConversionAction.type คือ UNKNOWN API ไม่สนับสนุนการจัดการการกระทำที่ถือเป็น Conversion เหล่านี้ แต่แสดงผลใน รายงาน เพื่อมอบผลลัพธ์ที่สมบูรณ์สำหรับเมตริก Conversion ที่สำคัญ เช่น metrics.conversions และ metrics.conversions_value

ตัวอย่างโค้ด

ตัวอย่างโค้ดต่อไปนี้จะแนะนำคุณตลอดขั้นตอนการสร้าง การกระทำที่ถือเป็น Conversion โดยเฉพาะอย่างยิ่ง เป็นการสร้างการกระทำที่ถือเป็น Conversion ที่มี ตั้งค่า type เป็น UPLOAD_CLICKS นี่คือขั้นตอน UI ของ Google Ads เดียวกันกับการสร้างการกระทำที่ถือเป็น Conversion ใหม่โดยใช้ นำเข้า > นําเข้าด้วยตนเองโดยใช้ API หรือการอัปโหลด > ติดตาม Conversion จาก คลิก และยังตั้งค่า category ด้วย เป็น DEFAULT

ระบบจะใช้การตั้งค่าเริ่มต้นต่อไปนี้

• Google Ads API จะกำหนด ช่อง primary_for_goal โดยอัตโนมัติ แต่คุณสามารถตั้งค่าฟิลด์นี้อย่างชัดแจ้งเพื่อควบคุมวิธี การกระทำที่ถือเป็น Conversion ส่งผลต่อการรายงานและการเสนอราคาในบัญชีของคุณเมื่อ รวม กับเป้าหมาย Conversion

• Google Ads API จะกำหนด counting_type โดยอัตโนมัติ เป็น MANY_PER_CLICK ดูเกี่ยวกับตัวเลือกการนับ Conversion สำหรับรายละเอียดเพิ่มเติม

• Google Ads API ตั้งค่ารูปแบบการระบุแหล่งที่มาเป็น ข้อมูล ขับเคลื่อนด้วยการตั้งค่า attribution_model_settings ลงใน GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN ค่าของ AttributionModel

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
      

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
      

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
      

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}."
end
add_conversion_action.rb
      

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 ตัวอย่าง

การตรวจสอบความถูกต้อง

Google Ads และ Google Ads API รองรับการกระทำที่ถือเป็น Conversion ได้อย่างหลากหลาย ดังนั้นบางรายการ กฎการตรวจสอบความถูกต้องจะแตกต่างกันไปตามtype ของการดำเนินการ

ข้อผิดพลาดที่พบบ่อยที่สุดเมื่อสร้างการกระทําที่ถือเป็น Conversion คือ DUPLICATE_NAME ตรวจสอบว่าคุณใช้ชื่อที่ไม่ซ้ำกันสําหรับการกระทําที่ถือเป็น Conversion แต่ละรายการ

เคล็ดลับในการตั้งค่าช่อง ConversionAction มีดังนี้

ช่อง enum ทั้งหมด

การพยายามตั้งค่าช่อง enum เป็น UNKNOWN จะส่งผลให้ ข้อผิดพลาด RequestError.INVALID_ENUM_VALUE รายการ

app_id

แอตทริบิวต์ app_id จะเปลี่ยนแปลงไม่ได้และตั้งค่าได้เมื่อสร้างแอตทริบิวต์ใหม่เท่านั้น Conversion ของแอป

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 หรือ การกระทำที่ถือเป็น Conversion WEBSITE_CALL รายการ สำหรับการกระทำที่ถือเป็น Conversion อื่นๆ ส่วนใหญ่ ช่วงที่อนุญาตคือ [1,30]

include_in_conversions_metric

การตั้งค่านี้ในการดำเนินการ create หรือ update ล้มเหลวโดยมี ข้อผิดพลาด FieldError.IMMUTABLE_FIELD รายการ ให้ตั้งค่า primary_for_goal เป็น ตามที่อธิบายไว้ในคู่มือเป้าหมาย Conversion

phone_call_duration_seconds

พยายามตั้งค่าแอตทริบิวต์นี้ในการกระทำที่ถือเป็น Conversion ที่ไม่ใช่การโทร ทำให้เกิดข้อผิดพลาด FieldError.VALUE_MUST_BE_UNSET

type

แอตทริบิวต์ type จะเปลี่ยนแปลงไม่ได้และตั้งค่าได้เมื่อสร้างแอตทริบิวต์ใหม่เท่านั้น Conversion

กำลังอัปเดตการกระทำที่ถือเป็น Conversion ที่มี type เท่ากับ UNKNOWN ผลลัพธ์ใน ข้อผิดพลาด MutateError.MUTATE_NOT_ALLOWED รายการ

value_settings

value_settingsสำหรับการกระทำที่ถือเป็น Conversion WEBSITE_CALL หรือ AD_CALL ต้อง ตั้งค่า always_use_default_value เป็น true ระบุค่า false เมื่อสร้างหรืออัปเดตค่านี้จะทำให้เกิดข้อผิดพลาด INVALID_VALUE

view_through_lookback_window_days

การตั้งค่าแอตทริบิวต์นี้เป็นค่านอกช่วงที่อนุญาตจะส่งผลให้เกิด ข้อผิดพลาด RangeError.TOO_LOW หรือ RangeError.TOO_HIGH สำหรับ Conversion ส่วนใหญ่ การดำเนินการ ช่วงที่อนุญาตคือ [1,30]

ตั้งค่าแอตทริบิวต์นี้ใน Conversion AD_CALL หรือ WEBSITE_CALL ไม่ได้ การดำเนินการ การระบุค่าจะทำให้เกิดข้อผิดพลาด VALUE_MUST_BE_UNSET