acf_add_url_utm_tags()

関数acf_add_url_utm_tags()は、URLにUTMパラメータを追加するための関数です。この関数は、Advanced Custom Fields (ACF) プラグインを使用している場合に特に役立ちます。

構文

acf_add_url_utm_tags( string $url, array $utm_params );

引数の説明:

• $url(string) — UTMパラメータを追加する対象のURL。
• $utm_params(array) — 追加するUTMパラメータの配列。キーはUTMパラメータ名（例: utm_source, utm_medium）、値はパラメータの値。

例 1: 基本的なUTMパラメータの追加

この例では、URLに基本的なUTMパラメータを追加します。

<?php echo acf_add_url_utm_tags( 'https://example.com', array( 'utm_source' => 'newsletter', 'utm_medium' => 'email' ) ); ?>

例 2: 複数のUTMパラメータを追加

複数のUTMパラメータを一度に追加する例です。

<?php echo acf_add_url_utm_tags( 'https://example.com', array( 'utm_source' => 'social', 'utm_medium' => 'facebook', 'utm_campaign' => 'summer_sale' ) ); ?>

例 3: 動的なURLにUTMパラメータを追加

動的に生成されたURLにUTMパラメータを追加する例です。

<?php echo acf_add_url_utm_tags( get_permalink(), array( 'utm_source' => 'blog', 'utm_medium' => 'post', 'utm_campaign' => 'new_post' ) ); ?>

例 4: カスタムフィールドのURLにUTMパラメータを追加

ACFのカスタムフィールドから取得したURLにUTMパラメータを追加する例です。

<?php echo acf_add_url_utm_tags( get_field('external_link'), array( 'utm_source' => 'website', 'utm_medium' => 'banner' ) ); ?>

例 5: 条件付きでUTMパラメータを追加

特定の条件に基づいてUTMパラメータを追加する例です。

<?php
$url = 'https://example.com';
if ( is_page( 'special-offer' ) ) {
    echo acf_add_url_utm_tags( $url, array( 'utm_source' => 'special', 'utm_medium' => 'landing_page' ) );
} else {
    echo $url;
}
?>

注意点

• UTMパラメータは、マーケティングキャンペーンの追跡に使用されます。適切なパラメータを設定することが重要です。
• URLが既にUTMパラメータを含んでいる場合、この関数は既存のパラメータを上書きする可能性があります。