نگاشت‌های فیلد

از نگاشت‌های موجود در جدول‌ها برای نگاشت کردن UploadClickConversionRequest در Google Ads API به معادل IngestEventsRequest آن در Data Manager API استفاده کنید.

اصالت‌سنجی

Data Manager API به اعتبارنامه‌هایی با دامنه متفاوت از Google Ads API نیاز دارد. مراحل موجود در راه‌اندازی دسترسی به API را دنبال کنید تا اعتبارنامه جدیدی تولید کنید که شامل دامنه Data Manager API باشد.

فیلدهای درخواست

UploadClickConversionRequest (Google Ads API)	IngestEventsRequest (Data Manager API)	یادداشت‌ها
customer_id سرایند درخواست developer-token سرایند درخواست login-customer_id سرایند درخواست linked-customer-id conversion_action	destinations	فیلدهای کنش تبدیل و مشتری را ببینید.
بدون معادل	consent	تنظیمات رضایت پیش‌فرض اختیاری برای رویدادهای موجود در درخواست. می‌توانید این مقدار را برای رویدادی تکی با تنظیم فیلد consent از Event لغو کنید.
بدون معادل	encoding	الزامی: روی Encoding استفاده‌شده برای مقادیر UserIdentifier تنظیم شود.
بدون معادل	encryption_info	اگر درخواست حاوی مقادیر رمزگذاری‌شده باشد، تنظیم می‌شود. برای جزئیات، رمزگذاری را ببینید.
job_id	بدون معادل	از request_id برگردانده‌شده در پاسخ برای بازیابی عیب‌یابی استفاده کنید.
partial_failure	بدون معادل	‫Data Manager API از مدل خطای سریع-ناموفق استفاده می‌کند. اگر هریک از فیلدهای IngestEventsRequest در اعتبارسنجی ناموفق باشد، Data Manager API کل درخواست را رد می‌کند.
validate_only	validate_only
conversions	events	فهرست تبدیل‌ها یا رویدادها. برای جزئیات، بخش فیلدهای تبدیل را ببینید.

فیلدهای مشتری و کنش تبدیل

‫Google Ads API به سرایند درخواست developer-token نیاز دارد و شما سرایندهای درخواست login-customer-id و linked-customer-id را برای سناریوهای اصالت‌سنجی مختلف تنظیم می‌کنید.

Data Manager API به یک کد توسعه‌دهنده نیاز ندارد و شما اطلاعات ورود به سیستم و مشتری پیوندشده را بااستفاده از فیلدهای یک Destination به‌جای سرایندهای درخواست مشخص می‌کنید. برای اطلاعات بیشتر درباره مقصدها، پیکربندی مقصدها را بررسی کنید.

در اینجا نحوه نگاشت فیلدهای Google Ads API برای یک conversion_action به فیلدهای معادل در Destination آورده شده است:

Google Ads API	Destination (Data Manager API)	یادداشت‌ها
customer_id درخواست	operating_account	account_id را روی شناسه مشتری حساب تبدیل Google Ads تنظیم کنید. این ممکن است با customer_id در درخواست Google Ads API شما متفاوت باشد. account_type operating_account را روی GOOGLE_ADS تنظیم کنید.
سرایند درخواست developer-token	بدون معادل	برای Data Manager API به کد توسعه‌دهنده نیازی نیست.
سرایند درخواست login-customer-id	login_account	account_id را روی شناسه مشتری حساب ورود به سیستم تنظیم کنید. اگر حساب ورود به سیستم حساب Google Ads است، account_type را روی GOOGLE_ADS تنظیم کنید، یا اگر حساب ورود به سیستم حساب شریک داده است، آن را روی DATA_PARTNER تنظیم کنید.
سرایند درخواست linked-customer-id	linked_account	اگر بااستفاده از پیوند شریک به operating_account دسترسی پیدا می‌کنید، account_id را روی شناسه مشتری حساب پیوندشده تنظیم کنید و account_type را روی DATA_PARTNER تنظیم کنید. درغیراین‌صورت، فیلد linked_account را تنظیم نکنید.
conversion_action از ClickConversion	product_destination_id	روی شناسه عددی کنش تبدیل تنظیم شده است. از نام منبع ConversionAction استفاده نکنید.
بدون معادل	reference	شناسه تعریف‌شده توسط کاربر برای Destination. اگر تبدیل‌ها را برای چندین کنش تبدیل در یک درخواست ارسال می‌کنید، این فیلد را تنظیم کنید.

فیلدهای تبدیل

ClickConversion (Google Ads API)	Event (Data Manager API)	یادداشت‌ها
cart_data	cart_data	برای جزئیات، فیلدهای داده سبد خرید را ببینید.
consent	consent	هر دو میانای برنامه‌سازی کاربردی از شیء Consent مشابهی (ad_user_data، ad_personalization) استفاده می‌کنند. برای Data Manager API، می‌توانید با تنظیم فیلد consent در سطح درخواست، برای همه رویدادها در یک درخواست رضایت تنظیم کنید.
conversion_action	destination_references	اگر تبدیل‌ها را برای چندین کنش تبدیل در یک درخواست ارسال می‌کنید، این فیلد را روی reference مربوط به مقصد تنظیم کنید.
conversion_date_time	event_timestamp	اگر از قالب JSON استفاده می‌کنید، مقدار را در قالب RFC 3339 تنظیم کنید که کمی با قالب تاریخ و زمان Google Ads API تفاوت دارد. اگر از میان‌گیرهای پروتکل استفاده می‌کنید، از Timestamp استفاده کنید و فیلدهای seconds و (اختیاری) nanoseconds را تنظیم کنید. برای جزئیات، قالب مُهر زمان را ببینید.
conversion_environment	بدون معادل
conversion_value	conversion_value	روی مقدار واحد پولی تنظیم شود، نه مقدار به میکرو. برای مثال، برای مقدار تبدیل ۵٫۲۳ دلار، از مقدار 5.23 استفاده کنید.
currency_code	currency
custom_variables	custom_variables	برای جزئیات، فیلدهای متغیر سفارشی را ببینید.
customer_type	user_properties.customer_type	روی مقداری در شمارش CustomerType تنظیم شده است.
بدون معادل	event_source
بدون معادل	event_device_info
external_attribution_data	بدون معادل
gbraid	ad_identifiers.gbraid
gclid	ad_identifiers.gclid
بدون معادل	last_updated_timestamp
order_id	transaction_id
session_attributes_encoded	ad_identifiers.session_attributes	برای جزئیات، به افزودن مشخصه‌های جلسه مراجعه کنید.
session_attributes_key_value_pairs	experimental_fields	برای جزئیات، به افزودن مشخصه‌های جلسه مراجعه کنید.
user_identifiers	user_data.user_identifiers	برای جزئیات، فیلدهای شناسه کاربر را ببینید.
user_ip_address	landing_page_device_info.ip_address
wbraid	ad_identifiers.wbraid

فیلدهای داده‌های سبد خرید

CartData (Google Ads API)	CartData (Data Manager API)	یادداشت‌ها
feed_country_code	merchant_feed_label	روی برچسب فید تنظیم کنید.
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

فیلدهای مورد برای داده‌های سبد خرید

Item (Google Ads API)	Item (Data Manager API)	یادداشت‌ها
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
بدون معادل	item_id
بدون معادل	additional_item_parameters

فیلدهای متغیر سفارشی

CustomVariable (Google Ads API)	CustomVariable (Data Manager API)	یادداشت‌ها
بدون معادل	destination_references	Google Ads API برای هر کنش تبدیل به درخواست‌های جداگانه نیاز دارد. Data Manager API از ارسال تبدیل‌ها برای چندین کنش تبدیل در یک درخواست و همچنین از استفاده از این فیلد destination_references برای نشان دادن اینکه کدام مقصدها باید متغیر سفارشی خاصی را دریافت کنند پشتیبانی می‌کند.
conversion_custom_variable	variable	به‌جای نام منبع، روی نام متغیر تنظیم شده است.
value	value

فیلدهای شناسه کاربر

نکته: در Data Manager API، شناسه‌های کاربر را به شیء UserData اضافه کنید، سپس فیلد user_data مربوط به Event را تنظیم کنید. در Google Ads API، شناسه‌های کاربر مستقیماً به ClickConversion در فیلد user_identifiers اضافه می‌شوند.

UserIdentifier (Google Ads API)	UserIdentifier (Data Manager API)
address_info	address	دستورالعمل‌های قالب‌بندی و درهم‌سازی را دنبال کنید. همچنین می‌توانید مشخصه‌های درهم‌سازی‌شده نشانی را رمزگذاری کنید.
hashed_email	email_address	روی نشانی ایمیل قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم شود. همچنین می‌توانید نشانی ایمیل درهم‌سازی‌شده را رمزگذاری کنید.
hashed_phone_number	phone_number	روی شماره تلفن قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم شده است. همچنین می‌توانید شماره تلفن درهم‌سازی‌شده را رمزگذاری کنید.
فیلدهای دیگر: mobile_id third_party_user_id user_identifier_source	نامربوط	هیچ‌کدام از میاناهای برنامه‌سازی کاربردی از این شناسه‌ها برای تبدیل‌های آفلاین یا تبدیل‌های به‌سازی‌شده برای مشتریان بالقوه پشتیبانی نمی‌کنند، و Data Manager API از این شناسه‌ها هنگام ارسال رویدادهای تبدیل به‌عنوان منبع داده اضافی پشتیبانی نمی‌کند.

فیلدهای پاسخ

UploadClickConversionResponse (Google Ads API)	IngestEventsResponse (Data Manager API)	یادداشت‌ها
job_id	بدون معادل	از request_id برگردانده‌شده در پاسخ برای بازیابی عیب‌یابی استفاده کنید.
partial_failure_error	بدون معادل	‫Data Manager API از مدل خطای سریع-ناموفق استفاده می‌کند. اگر هریک از فیلدهای IngestEventsRequest در اعتبارسنجی ناموفق باشد، Data Manager API کل درخواست را رد می‌کند.
request-id سرایند پاسخ	request_id	شناسه درخواست به‌جای سرایند پاسخ، به‌عنوان فیلد پاسخ در Data Manager API برگردانده می‌شود.
results	بدون معادل	Data Manager API رویدادها را به‌صورت ناهمگام پردازش می‌کند. نتایج پردازش را بااستفاده از عیب‌یابی بررسی کنید.