สร้างการกระทําที่ถือเป็น 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 ซึ่งต้องติดตั้งในทุกหน้าของเว็บไซต์ คุณสามารถเรียกข้อมูลแอตทริบิวต์ทั้ง 2 รายการนี้ได้ด้วย ConversionActionService ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีติดแท็กหน้าเว็บได้ในศูนย์ช่วยเหลือ

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

ประเภทโค้ดติดตาม แหล่งที่มาของ Google Ads
WEBPAGE เว็บไซต์, เว็บไซต์ (Google Analytics (GA4))
WEBPAGE_ONCLICK เว็บไซต์, เว็บไซต์ (Google Analytics (GA4))
CLICK_TO_CALL การคลิกหมายเลขโทรศัพท์
--- เว็บไซต์ (Google Analytics (UA))

Conversion ในแอป

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

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

ประเภทการกระทําที่ถือเป็น Conversion แหล่งที่มาของ Google Ads
GOOGLE_PLAY_DOWNLOAD Google Play > การติดตั้ง
GOOGLE_PLAY_IN_APP_PURCHASE Google Play > การซื้อในแอป

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

Conversion การโทร

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

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

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

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

AD_CALL

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

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

WEBSITE_CALL

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

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

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

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

ประเภทการกระทําที่ถือเป็น Conversion แหล่งที่มาของ Google Ads คู่มือการตั้งค่า API
UPLOAD_CLICKS ติดตาม Conversion จากการคลิกและ Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขาย คู่มือการอัปโหลดการคลิก
คู่มือ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย
UPLOAD_CALLS ติดตาม Conversion จากการโทร คู่มือการตั้งค่า API
STORE_SALES ติดตาม Conversion ยอดขายในร้าน คำแนะนำในการตั้งค่า API

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

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

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

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

Conversion ของ SKAdNetwork

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

ฟิลด์รายงาน คำอธิบาย
metrics.sk_ad_network_installs จำนวนการติดตั้งที่ Apple รายงาน เมตริกนี้แบ่งกลุ่มได้โดยใช้segments.sk_ad_network_conversion_valueร่วมกับกลุ่มที่เกี่ยวข้องกับวันที่เท่านั้น
metrics.sk_ad_network_total_conversions จํานวน Conversion ทั้งหมด ซึ่งรวมถึงการติดตั้งและ Conversion ประเภทอื่นๆ ที่ Apple รายงาน เมตริกนี้แบ่งกลุ่มได้เฉพาะตามกลุ่มที่เกี่ยวข้องกับ SKAdNetwork และกลุ่มที่เกี่ยวข้องกับวันที่เท่านั้น
segments.sk_ad_network_ad_event_type ประเภทเหตุการณ์ที่เกิดขึ้นสําหรับ Conversion หนึ่งๆ
segments.sk_ad_network_attribution_credit วิธีให้เครดิตการระบุแหล่งที่มาสําหรับ Conversion หนึ่งๆ
segments.sk_ad_network_fine_conversion_value

มูลค่าของ Conversion ที่ Apple รายงาน กลุ่มนี้ใช้กับเมตริกอื่นนอกเหนือจาก metrics.sk_ad_network_installs, metrics.sk_ad_network_total_conversions ไม่ได้ และรวมกับกลุ่มที่เกี่ยวข้องกับวันที่ได้เท่านั้น

ระบบจะแสดงผลค่า 0 หาก Apple รายงานค่าเป็น 0 และจะไม่แสดงค่าใดๆ ในกรณีอื่นๆ ตรวจสอบ การปรากฏในช่องเพื่อแยกความแตกต่างระหว่าง 2 กรณี

segments.sk_ad_network_coarse_conversion_value ค่าคร่าวๆ สําหรับ Conversion แต่ละรายการ
segments.sk_ad_network_postback_sequence_index ตำแหน่งของพ็อพแบ็กตามลําดับสําหรับ Conversion หนึ่งๆ
segments.sk_ad_network_source_app.sk_ad_network_source_app_id รหัสแอปที่แสดงโฆษณาซึ่งทําให้เกิดการติดตั้งเครือข่ายโฆษณาใน iOS Store Kit
segments.sk_ad_network_source_domain เว็บไซต์ที่แสดงโฆษณาซึ่งทําให้เกิดการติดตั้งเครือข่ายโฆษณาใน iOS Store Kit ค่า Null หมายความว่ากลุ่มนี้ใช้ไม่ได้ เช่น แคมเปญที่ไม่ใช่ iOS หรือไม่มีอยู่ในระบบรายงานผล Conversion ที่ Apple ส่ง
segments.sk_ad_network_source_type ประเภทแหล่งที่มาที่แสดงโฆษณาซึ่งทําให้เกิดการติดตั้งเครือข่ายโฆษณาใน iOS Store Kit ค่า Null หมายความว่ากลุ่มนี้ใช้ไม่ได้ เช่น แคมเปญที่ไม่ใช่ iOS หรือไม่มีโดเมนแหล่งที่มาหรือแอปแหล่งที่มาในระบบรายงานผล Conversion ที่ Apple ส่ง
segments.sk_ad_network_user_type ประเภทผู้ใช้ที่สร้าง Conversion หนึ่งๆ
segments.sk_ad_network_redistributed_fine_conversion_value มูลค่า Conversion ในส่วนนี้ประกอบด้วยค่าว่างที่ได้รับการแจกแจงใหม่เป็นมูลค่า Conversion กลุ่มนี้แสดงผลรวมของมูลค่า Conversion ที่ละเอียดที่สังเกตได้ซึ่ง Apple แสดงผล และค่า Null โดยประมาณจาก Google
segments.sk_ad_network_version เวอร์ชัน iOS Store Kit Ad Network API ที่ใช้

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

โค้ด 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="v18"
    )

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

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

หากต้องการนําเข้าการวิเคราะห์แอปของบุคคลที่สามหรือ Conversion ของ 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

ยอดขายในร้าน: อัปโหลดไปยังการกระทําที่ถือเป็น Conversion ที่มีการรายงาน

แม้ว่าคุณจะสร้างการกระทําที่ถือเป็น Conversion STORE_SALES หรือ STORE_SALES_DIRECT_UPLOAD โดยใช้ Google Ads API ไม่ได้ แต่ API รองรับการอัปโหลดธุรกรรมยอดขายในร้าน

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

ประเภทการกระทําที่ถือเป็น Conversion แบบอ่านอย่างเดียว

การกระทําที่ถือเป็น 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 ขั้นตอนนี้เหมือนกับการสร้างการกระทําที่ถือเป็น Conversion ใหม่โดยใช้นําเข้า > นําเข้าด้วยตนเองโดยใช้ API หรือการอัปโหลด > ติดตาม Conversion จากคลิกใน UI ของ Google Ads รวมถึงตั้งค่า category เป็น DEFAULT ด้วย

การตั้งค่าเริ่มต้นต่อไปนี้จะมีผล

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.V18.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::V18::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V18::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V18::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

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

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] สําหรับการกระทําที่ถือเป็น Conversion AD_CALL หรือ 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