หน้านี้ได้รับการแปลโดย Cloud Translation API

สร้างการกระทําที่ถือเป็น 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`	การคลิกหมายเลขโทรศัพท์

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

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

`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 แบบไดนามิกสําหรับเครื่องมือวัดการโทรในหมายเลขที่แสดงในเว็บไซต์ นอกจากนี้ คุณต้องตั้งค่าชิ้นงานการโทรและลิงก์ชิ้นงานดังกล่าวที่ระดับลูกค้า แคมเปญ หรือกลุ่มโฆษณา

`CLICK_TO_CALL`

การกระทําที่ถือเป็น Conversion CLICK_TO_CALL จะปรากฏเป็น Conversion การคลิกหมายเลขในเว็บไซต์บนอุปกรณ์เคลื่อนที่ในเว็บอินเตอร์เฟซของ Google Ads

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

ตารางต่อไปนี้แสดงพารามิเตอร์ API ที่เทียบเท่าซึ่งจะใช้กับประเภท Conversion ที่ปรับปรุงแล้วแต่ละประเภท

ประเภทการกระทําที่ถือเป็น Conversion	ประเภท Conversion ที่ปรับปรุงแล้ว	คู่มือการตั้งค่า API
`UPLOAD_CLICKS`	Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขาย ปรับปรุงการวัดธุรกรรมออฟไลน์ที่มาจากโอกาสในการขายบนเว็บไซต์หรือผู้เข้าชมเว็บไซต์	คู่มือการตั้งค่า API
`WEBPAGE`	Conversion ที่ปรับปรุงแล้วสําหรับเว็บ ปรับปรุงการวัด Conversion ออนไลน์	คู่มือการตั้งค่า API

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

หากต้องการนําเข้าการวิเคราะห์แอปของบุคคลที่สามหรือ Conversion ของ Firebase ให้เปลี่ยน status ของ ConversionAction จาก HIDDEN เป็น ENABLED โดยใช้วิธีการ mutate ของ ConversionActionService การกระทําที่ถือเป็น Conversion เหล่านี้ไม่รองรับการอัปเดต 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

ยอดขายในร้าน: อัปโหลดไปยังการกระทําที่ถือเป็น 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 ด้วย

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

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 ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบการระบุแหล่งที่มาได้จากบทความในศูนย์ช่วยเหลือนี้

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

เริ่มต้นใช้งาน

อัปโหลด Conversion การคลิก