CustomConversions

Query information about custom conversions defined for your ad accounts.

テーブル固有の情報

Facebook のCustomConversions は、広告配信を最適化するためのコンバージョンイベントを表します。

Insert

CustomConversions を挿入する際は、少なくともName を指定する必要があります。

INSERT INTO CustomConversions (Name) VALUES ('TestConversion')

Rule カラムまたはAdvancedRule カラムに挿入する場合は、ルールの設定をJSON 集約として指定してください。

INSERT INTO CustomConversions (Name, EventSourceId, Rule, CustomEventType) 
VALUES 
 ('test',
 '871481174114636',
 '{"and":[{"event":{"eq": "Purchase"}},{"value":{"gt":100}}]}',
 'PURCHASE')

利用可能なRule の設定については、Facebook マーケティングAPI のCustomConversions に関するドキュメントを参照してください。

Update

CustomConversions を更新する際は、WHERE 句にオブジェクトのID を指定する必要があります。

UPDATE CustomConversions SET Name='test1' WHERE ID='123abc'

Note：Facebook マーケティングAPI で更新がサポートされているカラムは、DefaultConversionValue、Name、およびDescription のみです。

Delete

CustomConversions を削除する際は、オブジェクトのId を指定してください。

DELETE FROM CustomConversions WHERE ID='123abc'

Columns


Name	Type	ReadOnly	Description
Target	String	False	The Id of the Account, Campaign, Ad Group, or Ad to get insights for.
ID [KEY]	String	True	The ID of the custom conversion
Account_ID	String	True	The ID of the custom conversion's ad account
BusinessID	String	True	ID of business that owns the custom conversion
BusinessName	String	True	Name of business that owns the custom conversion
CreationTime	Datetime	True	Time at which the conversion was created
CustomEventType	String	False	The type of the conversion event 使用できる値は次のとおりです。ADD_PAYMENT_INFO, ADD_TO_CART, ADD_TO_WISHLIST, COMPLETE_REGISTRATION, CONTENT_VIEW, INITIATED_CHECKOUT, LEAD, PURCHASE, SEARCH, CONTACT, CUSTOMIZE_PRODUCT, DONATE, FIND_LOCATION, SCHEDULE, START_TRIAL, SUBMIT_APPLICATION, SUBSCRIBE, LISTING_INTERACTION, FACEBOOK_SELECTED, OTHER
DataSourcesId	String	True	ID for event sources of the custom conversion
DataSourcesName	String	True	Name for event sources of the custom conversion
DataSourcesSourceType	String	True	Source type for event sources of the custom conversion
DefaultConversionValue	Decimal	False	When conversion is URL based, the default conversion value associated to each conversion
Description	String	False	Description of the custom conversion
EventSourceType	String	True	Event source type of the custom conversion, e.g. pixel, app, etc.
FirstFiredTime	Datetime	True	Time at which the pixel was first fired
IsArchived	Boolean	True	Whether this conversion is archived. Archived conversions are no longer tracked in the system.
IsUnavailable	Boolean	True	Whether this conversion is unavailable
LastFiredTime	Datetime	True	Time at which the pixel was last fired
Name	String	False	Name of the custom conversion
OfflineConversionDataSet	String	True	The offline event set that contains events
PixelID	String	True	ID of the pixel that will send events
RetentionDays	Integer	True	Retention period for advanced rule
Rule	String	False	Rule of the custom conversion

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるデータを詳細に制御することができます。


Name	Type	Description
EventSourceId	String	Event source Id.
AdvancedRule	String	Advanced ruleset for the custom conversion being created allowing multiple sources.
ActionSourceType	String	Action source type the custom conversion is created from. 使用できる値は次のとおりです。app, chat, email, other, phone_call, physical_store, system_generated, website, business_messaging